# 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="/files/WJVwKt7DxusvjH585W5R" alt="" data-size="line"> <a href="/pages/8yNTcYg81Qwv7VREKUIF">Mastercard</a></td><td><img src="/files/WJVwKt7DxusvjH585W5R" alt="" data-size="line"> <a href="/pages/8yNTcYg81Qwv7VREKUIF">Mastercard</a></td><td><img src="/files/78nPVauXSM5j8W1hf2DW" alt="" data-size="line"> Masterpass</td><td></td></tr><tr><td><img src="/files/8rrzZlphAr7Za4U5vnxE" alt="" data-size="line"> <a href="/pages/LdCqbL0vrX4CRIRpSXYN">Visa</a></td><td><img src="/files/8rrzZlphAr7Za4U5vnxE" alt="" data-size="line"> <a href="/pages/LdCqbL0vrX4CRIRpSXYN">Visa</a></td><td><img src="/files/Px5ih1Yy9TMEgVNjJr6C" alt="" data-size="line"> <a href="/pages/-M_fCRvhjSe_xp0bVopO">PayPal</a></td><td></td></tr><tr><td><img src="/files/O1IcwrLg6vHPIFMW71OG" alt="" data-size="line"> <a href="/pages/tn2AEjEp1riYNXRufL3w">PostFinance Pay</a></td><td><img src="/files/x9QwkL0vhKacPC1FbAdX" alt="" data-size="line"> <a href="/pages/CULvEQ5MyGPCgQil0NFP">American Express</a></td><td><img src="/files/qZPAwCRYFyVy7PuTqLyb" alt="" data-size="line"> Maestro</td><td></td></tr><tr><td><img src="/files/F5MKlDmJfiQrjosXATyg" alt="" data-size="line"> <a href="/pages/48Bh9N8bXYOSanBPFV7F">TWINT</a></td><td><img src="/files/KyMObC4NB9XLN5w6nG3b" alt="" data-size="line"> <a href="/pages/0j82hYUlcHfgEoAzqYtM">Diners Club International</a></td><td><img src="/files/187zwnGlPInPLD7hT3fM" alt="" data-size="line"> <a href="/pages/m766v217I1MxAXZ4F0va">HeyLight</a></td><td></td></tr><tr><td><img src="/files/WcofyqHDmeQujJfoxWJ6" alt="" data-size="line"> <a href="/pages/RippLLnzVKQ18a5NnxTV">Google Pay</a></td><td><img src="/files/hWsNhEecDhAgfFSuqIwO" alt="" data-size="line"> <a href="/pages/9ED8SqGhxqa26m8fKTxC">Discover Card</a></td><td><img src="/files/2ZameCpQlezKSA4Qsd5a" alt="" data-size="line"> Swissbilling</td><td></td></tr><tr><td><img src="/files/wPYyJDLY9oVbPd1HUC5J" alt="" data-size="line"> <a href="/pages/-Ma2NHayOlG90QqRE5aF">Samsung Pay</a></td><td><img src="/files/xiIwxUS6e4SqlFUgWwj4" alt="" data-size="line"> <a href="/pages/qCkdWJg4Wrb6mGvgzgYL">Apple Pay</a></td><td><img src="/files/5akObsEJqWhUzdE9kuI8" alt="" data-size="line"> <a href="/pages/-M_uAXq3bMxkY9FacLyn">WIRpay</a></td><td></td></tr><tr><td><img src="/files/9nOxIIDiwvvsQ0Eo5PoP" alt="" data-size="line"> <a href="/pages/yv61YCASPtUr49LnyrdP">Pay by Bank</a></td><td><img src="/files/WcofyqHDmeQujJfoxWJ6" alt="" data-size="line"> <a href="/pages/RippLLnzVKQ18a5NnxTV">Google Pay</a></td><td> <img src="/files/3yNSYr362Q16DHWGtGRB" alt="" data-size="line"> <a href="/pages/-Ma2ITDJQ8dRKt4K9ABj">Ideal Payment</a></td><td></td></tr><tr><td><img src="/files/ZwwNMSVMl4Jh1fzAbmdA" alt="" data-size="line"> <a href="/pages/wwepYXQqxU940JaurJxX">Purchase on Invoice</a></td><td><img src="/files/5tUKnraMZivl4tDWvGfp" alt="" data-size="line"> <a href="/pages/93LqVe7o6JNKTfcqNvgm">Klarna</a></td><td><img src="/files/Pig2UVYlu4mXoY4uxebW" alt="" data-size="line"> <a href="/pages/Qs5X0wxESiTK2FORZnb5">Bill</a></td><td></td></tr><tr><td><img src="/files/6lp9YDEoeRS5tcEtB92a" alt="" data-size="line"> <a href="/pages/oCLfTsm5Vb5GEOla7OiQ">Reka</a></td><td></td><td><img src="/files/ur1Ki5bMiba6JtwhhPzx" alt="" data-size="line"> <a href="/pages/a9v9YNRbLeYm4y3XNpY9">POWERPAY</a></td><td></td></tr><tr><td><img src="/files/wGozkDtDq52GpO78HKq1" alt="" data-size="line"> <a href="/pages/tXnCsIfUNpmTnnmpAmH0">Centi</a></td><td></td><td> <img src="/files/5HxCEkCzSYKmAjuumh81" alt="" data-size="line"> <a href="/pages/cmtHpDGTSBHLtCHkdhHa">CembraPay</a></td><td></td></tr><tr><td><img src="/files/0qXmTTtejLWoCYW0xLH7" alt="" data-size="line"> <a href="/pages/RjyJlgsomeU324sQATMF">Crypto</a></td><td></td><td> <img src="/files/ti7V8srnwwwBhZKsS1qp" alt="" data-size="line"> <a href="/pages/wVvqPzh7NBzisgACLNBf">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="/files/kswF0KM65jnF9iaiDBTx" 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="/files/z1JUqwyKCvPSwOs4Ala9" alt=""><figcaption><p>Adding the JTL Shop integration</p></figcaption></figure></div>

* Configure the following settings:

<div align="left"><figure><img src="/files/0Yi1lrkQSZROBMalPRHg" 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="/files/i5nGt8Lqw7CMRz0DkdXV" 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.payrexx.com/merchant/english/integration/e-commerce/jtl-shop.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
