Dokumentation

1Shopify Integration

Shopify is a Canadian e-commerce company headquartered in Ottawa, Ontario, that develops computer software for online stores and retail point-of-sale systems. We built an integration into Shopify’s Offsite Payment gateway that lets you process transactions in your Store. The following documentation will describe you step-by-step how you can integrate the payment gateway into your store.

2Use the Setup Assistant

The easiest way to connect your Shopify store is to use our Setup Assistant that you can access directly from your space. Alternatively you can launch the Boarding Assistant also here.

Create Integration
Figure 1. The easiest way to connect your Shopify Store is to use the Setup Assistant which will install the app and connect the platform to your store.

The Setup Assistant will then connect your Shopify Store to the platform. All you need to do now is to install the desired payment gateways as described further below in the section Adding the Payment Gateway.

3Connect Your Shopify Store Manually

If you do not want to use the Setup Assistant please follow the next steps described below.

3.1Activate the Shopify Feature

It is possible that the Shopify menu is not available in your space inside the application. In this case you have to first navigate to the feature list and activate the Shopify Feature Space > Features. Here you find the Shopify Icon. Click on the "Activate" button.

Note
In case you do not see any Shopify Logo there it can be that the feature is not activated in your subscription and you need to change the product. In this case you navigate to Account > (Select your Account) > Billing. Here you can select to change your subscription.

3.2Create a Shopify Integration

As next step you have to create your Shopify Integration. For this navigate to Space > Shopify and create your integration. Make sure you set a name and you type name used in the Shopify admin URL: [shopName].myshopify.com.

3.3Shopify Shop Identifer and Securiy Token

After you stored your Integration you are presented with the Shopify credentials that you put into the configuration field of the gateway that you just added.

Create Integration
Figure 2. You will be presented with the Shopify gateway credentials for your integration.

Write this credentials down or open a new window tab. You will need them later when the payment methods inside Shopify have to be configured. The credentials will only be shown once.

3.4Generate New Shopify Shop Identifier or Token

In case you have to create new credentials for your already existing integration you have to go to Space > Shopify and click to the lock symbol. This will take you to the overview of active Shopify Integration Security Tokens. Click on Generate New Security Token to create new credentials.

Note
You can only have two active tokens. Otherwise you have to disable not used tokens here.
Add Gateway
Figure 3. Add the gateway to your Shopify Store

3.5Install the Shopify App

You can now close the window with the Shopify credentials and click on Install Shopify App by opening your Shopify Integration we just created. This will forward you to your Shopify store. Once you granted the permission you are now able to use the integration.

The Shopify App makes sure that the transaction state in your store and in the platform are in sync and that the line items are transmitted.

4Adding the Payment Gateway

In order to add the payment method to Shopify you will now have to install the different payment methods in your store. This needs to be done independently on how you connected your store (using the setup assistant or manually).

Payment Pre-selection in your Shopify Checkout
Figure 4. This screenshot shows the payment pre-selection where the payment methods are shown individually in your checkout.

Shopify only accepts a few pre-installed gateways for each country. In order to allow you to process all you desired brands you will have to install the different payment methods individually by clicking on the links below. The link takes you to the login page of Shopify to install the payment gateway in your admin panel.

Once you clicked on the link you will be prompted to login to your store and asked if you want to add activate the payment method in your store. Click to add in order to proceed.

Once the Gateway has been confirmed it is visible in your Shopify Store Settings > Payment providers in the section Alternative Payments or Credit Cards.

Add Gateway
Figure 5. Add the gateway to your Shopify Store

Adding the payment method individually to your Shopify store will result in the pre-selection of the payment method on the your payment page.

4.1Add Identifier and Security Token

Copy now the credentials from your Shopify integration into the corresponding configuration field for the Shop Identifier and the Security Token for every payment method.

Add Gateway
Figure 6. Select the gateway and copy the credentials for your Shopify integration into the fields.

5Payment Processing

We provide two different ways how the payment processing is done:

  • With the default Integrated Payment Form the entry of payment details happens in your checkout after the order is confirmed by your customer. There is not redirection to the payment page.

  • With the Payment Page Integration the customer is redirected after the order is confirmed to the payment page to finalize the payment.

Find out more how those two modes can be enabled.

5.1Integrated Payment Form

The default integration is the integrated payment form where the customer will enter the credit card details in a form that is located in your Shopify Checkout after he has confirmed the order. This allows best in class user experience.

Note
For this to work you have to make sure that the app proxy path /apps/checkout/ is not taken by another app. Otherwise get in touch with us or disable the other plugin.

[[Integrated Payment Form]] .The integrated payment form will display the payment form directly in your Shopify Checkout. image::/assets/images/integrated_payment_form.png[Integrated Payment Form]

In order to activate this feature, make sure that in your Shopify Installtion you have set the Integrated Payment Form Option to on.

[[Integrated Payment Form]] .Make sure the integrated payment form is set to on. image::/assets/images/setting_integrated_payment_form.png[Integrated Payment Form]

5.2Payment Page (redirection)

In this scenario your client will be redirected to the payment page to process the payments. This is the backup integration if you set the Integrated Payment Form to off.

6Configure Your Processor

In order to accept payments over the configured gateway you have to make sure that you configured your processor, payment method and connector correctly. Manuals on how the payment processor needs to be configured can be found on the Processor List.

7Refunds with Shopify

It is possible to refund transactions directly out of Shopify. In order to do that Open the order and click on cancel order. This will open a dialog where you are able to select which products should be cancelled and if they should be restocked.

Cancel Shopify
Figure 7. Cancel an order inside Shopify.
Note
You have to make sure that the connector you processed this payment with supports the refund feature. In order to check that have a look at the processor list and check the connector of a processor.
feature-refund
Figure 8. See the example of an AMEX connector that supports Refunds.

8Matching Shopify Transactions in your Processor

If you want to match your Shopify Order with the payments in your processors this is not so straight forward. The main problem is that by the time we have to create the transaction at the processor we do not have the Shopify Transaction and Order Name. This is why we have to transmit the Checkout ID.

Nonetheless, you are able to match the transactions via the Shopify Transaction List in your space. The list provides you with the mapping of Checkout ID which equals the merchantReference in your processor and the OrderName which is visible in your Shopify Store.

shopify-transaction-list
Figure 9. The Shopify Transaction Table provides you the mapping for the orderName and checkoutId.
Note
It is necessary that you install the wallee app in order to have this details. You can also export this list by clicking on the export icon in the table.

9One Click Payments with Shopify

The application supports the option to securely store the payment information of your customer. This will increase your conversion for merchants that re-visit your store as they do not have to enter payment information again.

9.1Activate the One-Click Mode

In order to create token you will have to configure your payment method as described in the Tokenization Documentation.

shopify-transaction-list
Figure 10. Let your merchants choose from a previously stored token.

9.2Configure Shopify Account Creation

As the token is tied to a customerId the stored token will only be visible for the merchant that creates an account in your Shopify store. This is why you will have to make sure that the creation of accounts is enabled. If you want to make sure that the merchant token will be displayed we even suggest to force the account creation in Shopify.

Navigate in your Shopfiy backend to Settings > Checkout and set the account selection to Accounts are required or Accounts are optional.