# Shopify

## General

Shopify is an e-commerce platform that enables businesses to create and manage online stores without the need for extensive technical knowledge.

### Links <a href="#links" id="links"></a>

* Shopify [website](https://www.shopify.com)
* [Shopify App Store with Showcase](https://apps.shopify.com/payrexx-payment-app)
* [Installation URL](https://accounts.shopify.com/store-login?redirect=%2Fadmin%2Fsettings%2Fpayments%2Falternative-providers%2F46497793)

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

## Features

* ✅ Payment method icons in checkout
* ✅ Webhook status synchronization
* ✅ Processing refunds within Shopify
* ✅ Look & Feel configuration
* ❌ Subscription support
* ❌ Multicurrency support
* ❌ Cart transmission
* ❌ Individual payment method configuration

### Payment methods

The following payment methods are supported by the Shopify 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%2FgpeniviV2kBoW6kv11l5%2Fimage.png?alt=media&#x26;token=039e1abb-7bf3-4e05-8b48-789c1bd0c422" alt="" data-size="line"> <a href="../../payment-provider/external-payment-provider/wallets-and-more/giropay">giropay</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%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%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%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%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%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></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%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></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><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></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><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FsmG5lAIhDARlcmu7K5gF%2Fimage.png?alt=media&#x26;token=dea80d89-a7f0-48d0-9861-ce933acbf7e1" alt="" data-size="line"> <a href="../../payment-provider/payrexx-pay/payment-methods/eps">eps</a></td><td></td><td></td></tr><tr><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%2Fm2Jk7BvB5hX5qbMumXez%2Fimage.png?alt=media&#x26;token=31e82f09-5137-4ab9-bf48-4703e9e1e8eb" alt="" data-size="line"> <a href="../../payment-provider/payrexx-pay/payment-methods/bancontact">Bancontact</a></td><td></td><td></td></tr><tr><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%2FMpXvMdQBVXY1H2PyNce6%2Fimage.png?alt=media&#x26;token=f6641d81-1360-4bd0-b33a-2b3e7de504bf" alt="" data-size="line"> <a href="../../payment-provider/payrexx-pay/payment-methods/ideal">iDEAL</a></td><td></td><td></td></tr><tr><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%2F0sGMheP9bDIywUh6CHyW%2Fimage.png?alt=media&#x26;token=1ac518ff-e097-4fc7-b940-bee7b5a13566" alt="" data-size="line"> <a href="../../payment-provider/payrexx-pay/payment-methods/sepa-debit-direct">SEPA Debit Direct</a></td><td></td><td></td></tr><tr><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%2FXIeua5IgI9WD00b0ORAu%2Fimage.png?alt=media&#x26;token=e67b34f2-b1cb-47d5-842f-37a6f598d54e" alt="" data-size="line"> <a href="../../payment-provider/payrexx-pay/payment-methods/przelewy24">Przelewy24</a></td><td></td><td></td></tr></tbody></table>

{% hint style="danger" %}
Please note that the payment methods Apple Pay, Google Pay, and Purchase on Invoice are not supported by the Shopify plugin.
{% endhint %}

{% hint style="info" %}
**Pricing information**

For payments processed through Shopify, a fee of 0.35 % per transaction applies, in addition to the Payrexx transaction fees. Additionally, Shopify charges transaction fees depending on the Shopify plan selected.
{% endhint %}

## Setup

In this section, you will learn how to install the plugin and configure it on both Payrexx and Shopify pages.

{% embed url="<https://youtu.be/8GM8CObq0xA>" %}
Video tutorial on plugin installation
{% endembed %}

### Installation

1. Open the plugin [installation link](https://accounts.shopify.com/store-login?redirect=%2Fadmin%2Fsettings%2Fpayments%2Falternative-providers%2F46497793) or click on the link on the [presentation page](https://apps.shopify.com/payrexx-payment-app) in the App Store.
2. Select the store you want to install the app to.
3. Click "Install" in the upper-right corner to initialize the installation process.

<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%2F5km6vHyeaACpgoGeYX1w%2FShopify%201.png?alt=media&#x26;token=00848576-b6a4-46c2-98fc-23bfd9c9b753" alt=""><figcaption><p>Installation initialization</p></figcaption></figure></div>

4. Next, you will see an overview of the Payrexx Payment App. The app requires certain access rights. Click on the "Install" button if you agree with the app accessing this data.

<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%2FxddJUS2tOJ9IHR4ejcf7%2FShopify%202.png?alt=media&#x26;token=39cea86c-79d5-436e-b45d-5e9f7ed554ed" alt=""><figcaption><p>Payrexx payment app overview</p></figcaption></figure></div>

5. Following the installation, you will be redirected to the configuration page (on the Payrexx side) of the plugin. For authentication, you will need to enter the following information from the Payrexx dashboard or your platform's dashboard:

   * URL of the platform (e.g. payrexx.com)
   * Instance name \*
   * API-Key (see section "[Configuration - Payrexx](#configuration-payrexx)")

   Save the values by clicking the "Save" button in the bottom right-hand corner.\
   \
   \&#xNAN;***\*** The instance name is the name of your Payrexx account. You will find it at the beginning of the URL when you are logged into your account. If it says **example**.payrexx.com, then your instance name is **example**.*

<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%2Fc7SACtGxsIPsWHQmW8OY%2FShopify%203.png?alt=media&#x26;token=2a0bac4d-a46a-4ab2-b5d8-8f5822a65b2b" alt=""><figcaption><p>Configuration of the Shopify plugin settings</p></figcaption></figure></div>

6. If the entered data is correct, you will be redirected to the next configuration page. Here, you can choose which payment methods you want to make available in your shop. These settings will only affect the display of payment methods at your shop's checkout. The display of payment methods in the payment gateway is configured in the Payrexx dashboard (see point 7).

<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%2FmFwruzujadRH1Xcmhy8l%2FShopify%208.png?alt=media&#x26;token=1faa5e1b-0b9f-4d96-a4e7-169361e80b16" alt=""><figcaption><p>Configuration of payment methods</p></figcaption></figure></div>

7. Open the payment provider and payment method settings of your Payrexx account. Only select the payment methods that have already been selected in Shopify (point 6). If this is not the case, you may see more payment methods in the payment gateway than at the checkout in the shop.
8. Click the "Activate" button to complete the integration.\
   \
   In [this article](https://docs.payrexx.com/merchant/v/english/payment-priovder/payrexx-direct/activation-and-configuration), you will find an example of how payment methods can be configured within the Payrexx account for Payrexx Pay and Payrexx Pay Plus.

### 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 %}

1. Navigate to **API & Plugins** and add a new Shopify integration from the e-commerce section.

<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%2FbnpSwCPL1Yp4xio35x8P%2FShopify%205.png?alt=media&#x26;token=bbf91b06-c722-405f-a43b-f72a85e74104" alt=""><figcaption><p>View of the Payrexx dashboard: e-commerce integrations</p></figcaption></figure></div>

3. Enter your Shopify store URL (ending with myshopify.com) and activate the new integration. You will need the Payrexx "API Key" and "Instance Name" during the [plugin configuration step](#installation).

<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%2FiMQWRLE2LPmmmOgWikwI%2FShopify%206.png?alt=media&#x26;token=bfd17d2b-6fdf-4211-9856-ae9532e9e00c" alt=""><figcaption><p>View of the Payrexx dashboard: Shopify configuration</p></figcaption></figure></div>

### Configuration of Shopify

During installation, you will be guided through all configuration steps. If you wish to update settings at a later time, you can do so at the following locations:

Payment Method Configuration: **Settings > Payments > Payrexx**

Plugin Configuration: **Settings > Payments > Payrexx > More Actions > Manage**

<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%2FXCxek0pXBHdDF4jIsov0%2FShopify%207.png?alt=media&#x26;token=04b9df83-0b6b-45d0-8bc1-232a211c1820" alt=""><figcaption><p>Open the Shopify plugin configuration</p></figcaption></figure></div>

## Refunds

Refunds should only be issued via the Shopify Admin Dashboard. This ensures that the information is synchronized between both platforms. If you issue a refund in the Payrexx merchant backend, it will be processed correctly but will not be transmitted to Shopify.

## Manual Order Creation

If you wish to manually create an order for a customer, the recommended method is [Purchase on Invoice](https://docs.payrexx.com/merchant/english/payment-provider/payrexx-pay/payment-methods/purchase-on-invoice). However, since this payment method is not supported by the Shopify plugin, you must create the respective order not in Shopify, but in the Payrexx merchant administration.

## Order Process from the Customer's Perspective

The following sequence outlines the ordering and payment of a product in a Shopify store with an integrated payment solution from Payrexx:

* The customer selects a product and adds it to the shopping cart:

<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%2FDgUYekZuONy5DVpUHR3I%2Fimage.png?alt=media&#x26;token=3fc9d236-cec7-4fe8-bdd9-66afc00cfe5d" alt=""><figcaption><p>Adding a product to the shopping cart in Shopify</p></figcaption></figure></div>

* After entering the address details and reviewing the shopping cart, the customer proceeds to checkout:

<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%2FyCYDvVi5G8epNFFRGrBo%2Fimage.png?alt=media&#x26;token=63ac26a1-7741-46e8-8fcf-872d1dd725f1" alt=""><figcaption><p>Entering customer data and initiating the payment process</p></figcaption></figure></div>

* The customer is redirected to Payrexx and selects the preferred payment method from the list; in this example, Visa:

<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%2FV6taVlRbk2fjuvJYY5fM%2Fimage.png?alt=media&#x26;token=982482bb-102f-4636-b692-be40816e7510" alt="" width="404"><figcaption><p>Selecting the desired payment method</p></figcaption></figure></div>

* The customer enters their email address and card details and completes the order:

<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%2FfD7fSbhSZxUpR6tYCyTc%2Fimage.png?alt=media&#x26;token=dbb2f471-c48f-479f-b5e4-751e02ff909f" alt="" width="399"><figcaption><p>Initiating the payment</p></figcaption></figure></div>

{% hint style="success" %}
The payment in the Shopify store is thereby successfully completed.
{% endhint %}
