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
- Go to the JTL Extension store and download the latest release.
- Install the plugin when the online store is running.
- Upload the plugin from the shop, version 5.x into the \plugins directory.The upload is only available in the unpacked form. (File archives, such as *.zip or *.tgz, are not supported)
- Start the installation: In the shop in the back end, go to Pluginverwaltung > Vorhanden.
The installation runs automatically.
- Upload the plugin from the shop, version 5.x into the \plugins directory.
Step 2: Configure your plugin environment
- To configure the payment methods, go to Administration > Zahlungsarten > Übersicht.
- Set up your payment methods.
- 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) .
Field | Description |
---|---|
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 Portal | Enter 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öße | Select the font size for the credit-card form |
Schriftfarbe | Select the font color for credit-card form |
Schriftart | Select the font type for the credit-card form |
Selektor für den Submit-Button im Zahlungszwischenschritt | Select the type of the submit button in the payment step |
PQ-Selector für “Zahlungsart ändern” Button im Zwischenschritt | Select the the PHP-query-selector to hook into Zahlungsart ändern button for the payment steps |
PQ-Einfügemethode für “Zahlungsart ändern” Button im Zwischenschritt | Select the PHP-query-add-method to hook into Zahlungsart ändern -button for the payment steps |
PQ-Selector für Fehlermeldungen | Select the PHP-query-selector to hook into plugin failure messages for the Versandart/Zahlungsart Auswahl |
PQ-Einfügemethode für Fehlermeldungen | Select 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”-Seite | Select the PHP-query-selector to hook into payment method extras for the Bestellung überprüfen webpage |
PQ-Einfügemethode für “Bestellung überprüfen”-Seite | Select the PHP-query-add-method to hook into payment method extras for the Bestellung überprüfen webpage |
Webhooks neu registrieren | Select this option of you want to register the webhooks URL again. This is necessary, for example, if your store URL has |