alt

Important information

Please be advised that there will be a scheduled downtime across our API network on November 05 and November 07, 2024. For more information, visit our platform status portal.:
- Scheduled maintenance on November 5, 2024
- Scheduled maintenance on November 7, 2024

Unzer

Install the plugin

Learn how to install and configure the JTL Shop 5 plugin.

Before you begin

  • JTL system requirements
  • Basic integration requirements from Unzer
  • Minimum PHP version: 7.4
  • PHP extensions:
    • ext-json
    • ext-curl
  • Minimum JTL Shop version: JTL Shop 5.0.0
  • To avoid rounding errors when submitting floating point numbers to the API, we recommend that you set the following value in your php.ini, which selects an improved algorithm for rounding such numbers.
```php
// php.ini
  ; When floats & doubles are serialized store serialize_precision significant
  ; digits after the floating point. The default value ensures that when floats
  ; are decoded with unserialize, the data will remain the same.
  serialize_precision = -1
```

Step 1: Get the plugin from the JTL Extension store

  1. Go to the JTL Extension store and download the latest release.
  2. Install the plugin when the online store is running.
    1. Upload the plugin from the shop, version 5.x into the \plugins directory.
      icon
      The upload is only available in the unpacked form. (File archives, such as *.zip or *.tgz, are not supported)
    2. Start the installation: In the shop in the back end, go to Pluginverwaltung > Vorhanden.
      The installation runs automatically.

Step 2: Configure your plugin environment

  1. To configure the payment methods, go to Administration > Zahlungsarten > Übersicht.
  2. Set up your payment methods.
  3. To change or review the general plugin configuration, go to Plugins > Solution 360, and then Einstellungen.

For a detailed list of all the plugin requirements and installation steps, go to Unzer Zahlungsarten (JTL-shop 5) Plugin configuration JTL 5 .

FieldDescription
Privater Schlüssel (Private Key)Enter your private key that you received from Unzer Insights
Öffentlicher Schlüssel (Public Key)Enter your public key that you received from Unzer Insights
Händler ID für das Insight PortalEnter your Merchant ID to access your Unzer Insights account directly.

You can find your Merchant ID in Unzer Insights:

https://insights.unzer.com/merchant/_{Merchant-ID}_/dashboard
SchriftgrößeSelect the font size for the credit-card form
SchriftfarbeSelect the font color for credit-card form
SchriftartSelect the font type for the credit-card form
Selektor für den Submit-Button im ZahlungszwischenschrittSelect the type of the submit button in the payment step
PQ-Selector für “Zahlungsart ändern” Button im ZwischenschrittSelect the the PHP-query-selector to hook into Zahlungsart ändern button for the payment steps
PQ-Einfügemethode für “Zahlungsart ändern” Button im ZwischenschrittSelect the PHP-query-add-method to hook into Zahlungsart ändern -button for the payment steps
PQ-Selector für FehlermeldungenSelect the PHP-query-selector to hook into plugin failure messages for the Versandart/Zahlungsart Auswahl
PQ-Einfügemethode für FehlermeldungenSelect the PHP-query-add-method to hook into plugin failure messages for the Versandart/Zahlungsart Auswahl
PQ-Selector für Zahlungsart-Extras auf der “Bestellung überprüfen”-SeiteSelect the PHP-query-selector to hook into payment method extras for the Bestellung überprüfen webpage
PQ-Einfügemethode für “Bestellung überprüfen”-SeiteSelect the PHP-query-add-method to hook into payment method extras for the Bestellung überprüfen webpage
Webhooks neu registrierenSelect this option of you want to register the webhooks URL again. This is necessary, for example, if your store URL has

Next steps