# JTL Shop 5

{% hint style="info" %}
Available for versions 5.2.3 – 5.5.x
{% endhint %}

## General Information

### Links

* [JTL Shop](https://www.jtl-software.de/online-shopsystem)
* [Plugin](https://github.com/payrexx/jtl-payrexx-gateway) Download

### Features

* ✅ Multi-currency capability
* ❌ Payment method logos in checkout
* ✅ Cart transfer
* ✅ Webhook capability
* ✅ Look & Feel settings
* ✅ Custom payment method configuration
* ❌ Subscription support
* ❌ Execute refunds

{% hint style="info" %}
Please note that integration with JTL Shop 5 is only available in the Standard and Premium plans. [For more information](https://payrexx.com/en/prices)
{% endhint %}

### Payment methods

The following payment methods are supported by the JTL Shop 5 plugin:

<table><thead><tr><th width="206.74072265625">Payrexx Pay</th><th width="244.1112060546875">Payrexx Pay Plus</th><th width="197.5555419921875">External Payment Providers</th><th data-hidden></th></tr></thead><tbody><tr><td><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FU23TjmbpT2uSiA98Urvr%2Fimage.png?alt=media&#x26;token=698cb2dc-2958-4bae-ac0d-8f14fd23f25a" alt="" data-size="line"> <a href="../../payment-provider/payrexx-pay/payment-methods/mastercard">Mastercard</a></td><td><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FU23TjmbpT2uSiA98Urvr%2Fimage.png?alt=media&#x26;token=698cb2dc-2958-4bae-ac0d-8f14fd23f25a" alt="" data-size="line"> <a href="../../payment-provider/payrexx-pay/payment-methods/mastercard">Mastercard</a></td><td><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2F17PQY0D9XBWslkOAePIi%2Fimage.png?alt=media&#x26;token=f15fecf0-8c7a-4133-bbd1-c4f8b9f326e3" alt="" data-size="line"> Masterpass</td><td></td></tr><tr><td><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FTExzR53XajpaGXyBwloF%2Fimage.png?alt=media&#x26;token=910ca6c0-3c57-4a66-aa82-aecca278a33c" alt="" data-size="line"> <a href="../../payment-provider/payrexx-pay/payment-methods/visa">Visa</a></td><td><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FTExzR53XajpaGXyBwloF%2Fimage.png?alt=media&#x26;token=910ca6c0-3c57-4a66-aa82-aecca278a33c" alt="" data-size="line"> <a href="../../payment-provider/payrexx-pay/payment-methods/visa">Visa</a></td><td><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FEbCDmeC8V30Jp7cfDMmL%2Fimage.png?alt=media&#x26;token=356dfeca-69b7-485b-ba90-40dfa368c642" alt="" data-size="line"> <a href="../../payment-provider/external-payment-provider/wallets-and-more/paypal">PayPal</a></td><td></td></tr><tr><td><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FkoBQe0VPM9dFWRiqiZVs%2Fcard_postfinance-pay%402x.png?alt=media&#x26;token=94fcb934-b618-4e76-8881-7fdc961b03b9" alt="" data-size="line"> <a href="../../payment-provider/payrexx-pay/payment-methods/postfinance-pay">PostFinance Pay</a></td><td><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FgvjappUZx21s50KJp4jJ%2Fimage.png?alt=media&#x26;token=15aa7958-2b06-4387-8e36-18f55879ef35" alt="" data-size="line"> <a href="../../payment-provider/payrexx-pay/payment-methods/american-express">American Express</a></td><td><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FiXS2EAWFgZUKDMoPfTxC%2Fimage.png?alt=media&#x26;token=e61fd9d7-3579-4d54-b4a5-b53b3ce2ae09" alt="" data-size="line"> Maestro</td><td></td></tr><tr><td><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FuQnNZ6B30ek4HB4NiAO6%2Fimage.png?alt=media&#x26;token=8d50396a-d987-4392-8c55-0ecff02976bf" alt="" data-size="line"> <a href="../../payment-provider/payrexx-pay/payment-methods/twint">TWINT</a></td><td><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FBZc94MTsGISKMNY1yKQe%2Fimage.png?alt=media&#x26;token=3784cbc5-9f73-4480-9e0c-438247cc53b0" alt="" data-size="line"> <a href="../../payment-provider/payrexx-pay/payment-methods/diners-club-international">Diners Club International</a></td><td><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FvP1GRJlnETPS7p5KFRAO%2FHeyLight_Payment_Badge_White.png?alt=media&#x26;token=81cac928-18b6-492b-a3d3-e881781f33f5" alt="" data-size="line"> <a href="../../payment-provider/external-payment-provider/creditcards/heylight">HeyLight</a></td><td></td></tr><tr><td><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FZFPTOYZVup7Oo3gENFZL%2Fimage.png?alt=media&#x26;token=5b58d13b-8d68-44f7-b0c8-ef5267c756c5" alt="" data-size="line"> <a href="../../payment-provider/payrexx-pay/payment-methods/google-pay">Google Pay</a></td><td><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2Fh8W88W7CrPvrzaQywetK%2Fimage.png?alt=media&#x26;token=43218142-4c7e-4688-876c-07093b12b52c" alt="" data-size="line"> <a href="../../payment-provider/payrexx-pay/payment-methods/discover-card">Discover Card</a></td><td><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FWQHRVQgGmdw802wCvl9D%2Fimage.png?alt=media&#x26;token=f93e95fc-9fc5-4639-8c18-4577268ea402" alt="" data-size="line"> Swissbilling</td><td></td></tr><tr><td><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FCBvKMtT8cWZ6ELKtZpPK%2Fimage.png?alt=media&#x26;token=af82e2b5-d9d7-43d9-894a-5fa17209bb4d" alt="" data-size="line"> <a href="../../payment-provider/payrexx-pay/payment-methods/samsung-pay">Samsung Pay</a></td><td><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FeTjTdwz1ZCe78u1m8jHm%2Fimage.png?alt=media&#x26;token=3c8e0178-417a-48b8-9e32-9a55c5405e81" alt="" data-size="line"> <a href="../../payment-provider/payrexx-pay/payment-methods/apple-pay">Apple Pay</a></td><td><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FZSohpmUv7PTvADtybLAw%2Fimage.png?alt=media&#x26;token=8d98e944-cde2-420d-a402-ffbc8dab69d9" alt="" data-size="line"> <a href="../../payment-provider/external-payment-provider/wallets-and-more/wirpay">WIRpay</a></td><td></td></tr><tr><td><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2F3JUbAMvaOppm7c9gGfgd%2Fimage.png?alt=media&#x26;token=646e064b-c936-4555-9730-e8c1324bdb63" alt="" data-size="line"> <a href="../../payment-provider/payrexx-pay/payment-methods/pay-by-bank">Pay by Bank</a></td><td><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FZFPTOYZVup7Oo3gENFZL%2Fimage.png?alt=media&#x26;token=5b58d13b-8d68-44f7-b0c8-ef5267c756c5" alt="" data-size="line"> <a href="../../payment-provider/payrexx-pay/payment-methods/google-pay">Google Pay</a></td><td> <img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2F4r1rVeDUGhdZKpopdDH2%2Fimage.png?alt=media&#x26;token=75bfaa13-17c8-4739-8212-7ea46aa2544b" alt="" data-size="line"> <a href="../../payment-provider/external-payment-provider/wallets-and-more/ideal-payment">Ideal Payment</a></td><td></td></tr><tr><td><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FbwkGZ28bKoihwWZJ0rKW%2Fimage.png?alt=media&#x26;token=eb4af57b-6ad7-4428-a9d2-1dc72b9b87ca" alt="" data-size="line"> <a href="../../payment-provider/payrexx-pay/payment-methods/purchase-on-invoice">Purchase on Invoice</a></td><td><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2F7ecpO7opevIFqeQ5E7d4%2Fimage.png?alt=media&#x26;token=8dfa9e55-d11f-41c9-9b65-03c052f5eabf" alt="" data-size="line"> <a href="../../payment-provider/payrexx-pay/payment-methods/klarna">Klarna</a></td><td><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FClUQAAPtfZYZug15wjeX%2Finvoice.png?alt=media&#x26;token=508a9e23-afc2-4c08-8b2f-61aa3f547d92" alt="" data-size="line"> <a href="../../payment-provider/external-payment-provider/manual-payment-methods/bill">Bill</a></td><td></td></tr><tr><td><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FtjBXFizRK5CT7olS1dvH%2Fimage.png?alt=media&#x26;token=1e5ec27a-b851-4afe-8557-eae902ce1021" alt="" data-size="line"> <a href="../../payment-provider/payrexx-pay/payment-methods/reka">Reka</a></td><td></td><td><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FbL6kUpIXTk8sTR4Ruoau%2Fimage.png?alt=media&#x26;token=8a90d4ef-8206-41c1-aa27-fa5fa303f165" alt="" data-size="line"> <a href="../../payment-provider/external-payment-provider/wallets-and-more/powerpay">POWERPAY</a></td><td></td></tr><tr><td><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FtG7oej4GlXAVj5MRaDQA%2Fcard_centi.svg?alt=media&#x26;token=25ba20bd-f570-42b2-aca3-87c16c1df6a0" alt="" data-size="line"> <a href="../../payment-provider/payrexx-pay/payment-methods/centi">Centi</a></td><td></td><td> <img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FfrGPp9ikEtnbgH0WQWnV%2Fcembrapay.png?alt=media&#x26;token=4d4c9b24-ec21-4152-aff6-4b519b466099" alt="" data-size="line"> <a href="../../payment-provider/external-payment-provider/wallets-and-more/cembrapay">CembraPay</a></td><td></td></tr><tr><td><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2F3LT9LH8V4NSBBmWfgooX%2Fimage.png?alt=media&#x26;token=40d38d30-ad42-4266-8284-a2d6a25bb56c" alt="" data-size="line"> <a href="../../payment-provider/payrexx-pay/payment-methods/crypto">Crypto</a></td><td></td><td> <img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2F4D7UFV9iKD1d35YFeIM8%2Fimage.png?alt=media&#x26;token=299bb3fc-55d2-470e-8a1a-d5009a14f906" alt="" data-size="line"> <a href="../../payment-provider/external-payment-provider/wallets-and-more/verd.cash">VERD</a></td><td></td></tr></tbody></table>

#### Shop credit as a payment method

In addition to the listed payment methods, your customers can also use their shop credit as a means of payment, allowing them to pay for their purchases in full or in part with their available balance.

## Integration

### Installation of JTL Shop

Download the [plugin](https://github.com/payrexx/jtl-payrexx-gateway) and upload it to the backend of your JTL Shop following the instructions below:

<figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FIAuZgcFDC6zYrSYc9SjQ%2Fimage.png?alt=media&#x26;token=74d08d3d-433f-4e71-b0af-3eb001c624c3" alt=""><figcaption><p>Installation of the JTL plugin</p></figcaption></figure>

1. Navigate to **Plugins > Plugin Manager**.
2. Klick on **Upload**.
3. Browse your computer to find the plugin file and upload it.
4. Click on Available, mark the plugin and select "Install".

### Configuration of Payrexx

{% hint style="info" %}
Make sure you're [logged in](https://login.payrexx.com/) to your Payrexx account before you begin. If you don’t have a Payrexx account yet, you can [register](https://signup.payrexx.com/) now.
{% endhint %}

* In the merchant administration of your Payrexx account, navigate to **API & Plugins**.
* Under "Add E-Commerce Integration", click "Show All".
* Next to JTL Shop, click "Add".

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2Fibic3CyDRXveqcwc0KZE%2Fimage.png?alt=media&#x26;token=7a524c84-e204-4bf4-90b3-0503b019b3d2" alt=""><figcaption><p>Adding the JTL Shop integration</p></figcaption></figure></div>

* Configure the following settings:

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FOgSQqs9vVNl5FWf693wV%2Fimage.png?alt=media&#x26;token=27e9eda0-064b-4ec9-b587-925a58670aaa" alt=""><figcaption><p>Settings for the integration in JTL Shop 5</p></figcaption></figure></div>

1. **Enter Shop Address**: Enter the URL of your webshop. Please note that the URL must be entered without "www".
2. **Webhooks:** Enable the checkbox to ensure the webhook is resent in case of an error.

{% hint style="info" %}
You will need the API key and the instance name displayed on the left-hand side in the next step.
{% endhint %}

### Configuration of JTL Shop

Configure the plugin under **Plugins > Installed Plugins > JTL Payrexx Payment** by clicking on **Payrexx Configuration**. You have the following configuration options:

#### Required Information

* Platform, default is Payrexx
* Instance name
* API key
* ID of the desired Look & Feel profile (optional)

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FU7zfVIXecpkJCcNNHwgB%2Fimage.png?alt=media&#x26;token=e001f7fd-f5eb-4162-a66f-ed8277fe4125" alt=""><figcaption><p>Configuration of the plugin in JTL Shop</p></figcaption></figure></div>

{% hint style="info" %}
The platform (e.g. Payrexx) refers to the provider where your account is hosted.

You can find your instance name in the URL of your account: <https://INSTANCE\\_NAME.platform.xy>

The API key is located in your account under **API & Plugins**.
{% endhint %}

## Order and Payment Process

The order confirmation is only sent to the customer once the payment has been successfully completed.
