| Note |
|---|
This Plugin is not yet available in the JTL Extension Store |
...
Overview and search of payments
Manual payment processing (Full-/PratialPartial- Charge und Refund)
Configuration help for the plugin
...
JTL-Shop 5.00+ and its requirements
...
Other requirements
You need a trader account. Register at https://portal.dibspayment.eu/registration.
...
The installation of the plugin is carried out according to the JTL standard as described hier here or you can also provide your existing ZIP file of the plugin via the "Upload" tab in the plugin administration and then start the installation in the "Existing" tab.
...
The plugin supports you in setting up the payment method, select the "Help" tab in the plugin for this. There you will get an overview of the configuration. At this point, check the settings you have stored for the payment and shipping methods.
...
Payment methods
The configuration of the payment type is done via the standard administration in the JTL shop. You can find the payment types under Administration → Payment methods. You can also find a direct link to this on the help page of the plugin. Select Nets Easy via the pencil icon and configure the payment method if required.
In addition to the standard settings for payment methods, the settings for the payment method are located in the plug-in under Settings. Here you can store the data from your Nets Easy account that is necessary for operation in the plugin.
Option | BeschreibungDescription |
|---|---|
Plugin active | Here you can activate or deactivate the plugin outside the plugin administration. |
Live Secret Key | The API key for Live Mode. You can find this key in your Nets Easy account under "Company > Integration > Live Environment > Secret key". |
Test Secret Key | The API key for the test mode. You can find this key in your Nets Easy account under "Company > Integration > Test Environment > Secret key". |
Plugin mode | Select the operating mode here Test - the plugin is in test mode and communicates with the sandbox. Live - the plugin is in live mode and accepts real payments. |
Ckeckout Checkout mode | Select the checkout mode here Hosted - customers are redirected to an external Nets Easy site and complete the payment process there. Afterwards, they will be redirected back to the shop. Embedded - to complete the checkout process, an iframe is displayed below the product overview. After successful payment, the customer is redirected to the order confirmation page. Further settings may be necessary for this. (See Tab. 2) |
Optional GTC-URL | If an optional GTC URL is stored, it is transferred to Nets Easy and set in the checkbox text. If this is not specified, the shop's GTC URL is used. |
Optional Privacy-URL | If an optional data protection URL is stored, it is transferred to Nets Easy and set in the checkbox text. |
Charge | This option describes when a charge is performed: manual - no charges are performed, the merchant must trigger the charge via the plugin or the Nets Easy backend. Immediately - a Full-Charge will be executed immediately after the reservation in Nets Easy. First partial shipment - after the Wawi reconciliation, a full charge is carried out at Nets Easy for a partial shipment. Complete shipment - after the Wawi reconciliation, a full charge is carried out at Nets Easy for a full shipment. |
Payment error email | Alternative e-mail address of the shop administrator. If an e-mail address is stored, an automatic e-mail is sent in the event of errors in charge or refund. Otherwise, the Shop Master e-mail address is used. |
Mail template language | Select the language in which the notification e-mails are to be sent. If you select German, the e-mails will be sent in German. The same applies to English. |
Debug Frontend | Activate extended logs in the shop log for the frontend |
Debug Backend | Activate extended logs in the shop log for the backend |
Tab. 1
Option | BeschreibungDescription |
|---|---|
PHP Query Selector | Enter an alternative class or ID of the element in the DOM to which the embedded checkout is to be intergated. If the embedded checkout is selected, the "Complete order" button is always hidden. Make sure you always specify a valid element, otherwise the embedded checkout will not be displayed and the customer will not be able to complete an order with Nets Easy. |
PHP Query Method | Specify here the method in which the embedded checkout is to be integrated. after - the checkout is added after the specified element. before - the checkout is added before the specifying element. append - the checkout is appended to the specifying element. prepend - the checkout is prepended to the specifying element replaceWith - the specified element is replaced with the checkout |
PHP Query Hide elements | Specify here the elements in the DOM that are to be hidden. By default, the element "#complete-order-button" is always hidden. If your button ID is labeled differently, you can enter your own selector here. |
...
| Note |
|---|
Attention, incorrect settings may occur! If “Auslieferung vor Zahlungseingang möglich“ is activated and charge is set to "manual" in the plug-in settings, then no charge will be performedout performed out by the plug-in. In this case, you send the goods without an incoming payment! |
...
The subsequent order items are loaded from the jtl JTL shop cart and can be selected via the checkboxes for a partial charge or partial refund. The partial actions (partial charge / partial refund) are only available on the payment detail page.
...
If an error occurs during processing, you will be informed in the backend in the info area of the payment overview page with the corresponding error message. This message is also logged in the shop log.
| Info |
|---|
Achten Sie darauf nicht mehr als die maximal mögliche Artikelmenge zu chargen oder zu erstattenTake care not to charge or refund more than the maximum possible item quantity. |
...
If partial charging has been performed once, a full charge can no longer be executed. You must "charge" the remaining amount via one or more further partial charges.
...
Incoming orders and incoming payments made with Nets Easy are transferred to the JTL WAWI by synchronisation withd with the Shop. Only the actions Full-Charge (depending on the payment collection) and Cancel can be executed from the WAWI.
...
Depending on the plugin settings for payment collection (see Table 1), the orders are already charged. Only in the case of payment on first partial shipment or full shipment extended settings must be made (see Setting up the payment type). The full-charge is then performed at Nets-Easy after the WAWI synchronisationsynchronization.
If the charge could not be performed, an info mail is sent to the shop administrator by the plug-in.
...
Go to the JTL-WAWI → F6 → Select order → right mouse button → Storno → Stornieren
Syncronize Synchronize with JTL-Shop
The full charge is performed against Nets-Easy after the WAWI syncronisationsyncronization.
| Warning |
|---|
+++ ATTENTION, IMPORTANT +++Please make sure that you do not accidentally cancel a wrong order in the JTL-WAWI! The JTL-WAWI offers the possibility to reverse a cancellation, but the actions you have made in this regard are transferred 1:1 to the online shop! In this case, the order will be cancelled first and the payment will be cancelled against Nets Easy. Afterwards, the order would be reactivated but a payment will not be possible anymore! If you subsequently send the goods, this will be done without a payment! |
...
Customization
The payment method is displayed in the standard selection of payment methods in the JTL shop and has no customisable customizable elements.
FAQ
Why is there a status and a last status in the overview in the plug-in backend?
...
Amount/last state | State |
|---|---|
cancelled | cancelled |
Charge equals zero | reserved |
Reserved greather greater than charged amount | partial charge |
Reserved equals charged amount | charged |
Charged greather greater than refunded amount | parttial partial refund |
Charged equals refundes refund amount | refunded |
Why are the status and action buttons not displayed?
The status and action buttons are only displayed if the API keys are entered under Settings. Please make sure that you transfer the keys correctly, otherwise you will see this message:
| Warning |
|---|
Unauthorized |
Why are refunds offered for some payments and not for others?
...
The plugin calculates the totals for charges or refunds from the JTL shopping cart. In this way, we ensure that the calculation of the amounts is always based on JTL's own calculation procedure. This minimises minimizes rounding errors when you charge or refund partial quantities for an order item.
...
The more information you can give the support team about a problem, the sooner we will be able to help you. Non-reproducible problems, on the other hand, are also difficult to analyseanalyze.
Messages
| Note |
|---|
This currency is not supported |
...
This message is displayed if the customer has clicked on "< Go back" in the Nets Easy Checkout and cancels the payment without going through the checkout.
...
This message is displayed when the charge could not be made. The payment was cancelled aginst against Nets Easy. Check the shop log.
...
This message is displayed when the API client is initialised initialized with invalid configuration. Check the shop log.
...
You can find the shop log in the JTL admin area under Administartion Administration → Troubleshooting → Log.
The JTL log works with log levels in order not to fill the database with log data indefinitely. Conversely, this means that you will only see log messages if they have been generated after the log level has been changed. The plug-in logs almost exclusively in the debug log level, except for critical errors. So if something does not work, you should first activate the debug log level, then perform a test order, then deactivate the debug log level again and consult the messages logged in the meantime.
...
Changelog
v1.0.0 (Juni 2021)
Initiales Initial Release
Support und
...
Contact
siehe goto Support und KontaktContact