Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel7

...

  • Cancelling from the WAWI

  • Automatic full charge for partial or complete shipment

Explanation of terms


A reserved amount is reserved/authorized for payment collection, but no payment has been collected on it yet.

A charge can be understood as a payment collection of a previously reserved amount. Accordingly, full charge means that the entire order amount is collected.

A refund is a refund of a previously collected payment.

A cancel is the cancellation of a reserved payment before the payment is collected.

Installation / Update

System requirements

  • JTL-Shop 5.00+ 5.0.0 and its requirements

Other requirements

...

Option

Description

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".

Live Checkout Key

The checkout key for Live Mode. You can also find this key in your Nets Easy account.

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".

Test Checkout Key

The checkout key for Test Mode. You can also find this key in your Nets Easy account.

Plugin mode

Select the operating mode here

Test - the plugin is in test mode and communicates with the sandbox. No real payments are made in this mode.

Live - the plugin is in live mode and accepts real payments.

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 overviewoverview on the order summary page. 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.

Note: Some payment methods (like SOFORT) are always immediately charged, independend of this setting.

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. This adds additional debug messages to the debug log.

Debug Backend

Activate extended logs in the shop log for the backend. This adds additional debug messages to the debug log.

Tab. 1

Option

Description

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 when using embedded checkout. By default, the element "#complete-order-button" (the “Complete order” button in JTL defaults) is always hidden. If your button ID is labeled differently, you can enter your own selector here.

...

Open the payment method management in the JTL-WAWI via Payments → Payment methods.

Create Nets Easy Online checkout as the payment method. Please note that the payment types must correspond to the "Displayed name" in the JTL shopShop in each language.

By default, the payment collection is set to immediate. However, if you decide on payment collection for the first partial shipment or only for complete shipment, then further settings are required. “Auslieferung vor Zahlungseingang möglich“ must be activated. The full charge will then be executed depending on the plug-in settings with the next Wawi synchronisation.

...

Your shop must support the currencies Danish Krone, Euro, British Pound, Norwegian Krone, Swedish Krona, US Dollar, Polish Zloty or Swiss Franc.

Info

If the currently active currency is not supported, Nets Easy will not be offered as a payment method.

...

If the charge could not be performed, an info mail is sent to the shop administrator by the plug-in.

Cancel

  1. Go to the JTL-WAWI → F6 → Select order → right mouse button → Storno → Stornieren

  2. Synchronize with JTL-Shop

The full charge is performed against Nets-Easy after the WAWI syncronization.

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!

...

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?

...

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.

...