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.
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.
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.
If you do not want to use the Setup Assistant please follow the next steps described below.
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.
|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.|
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.
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.
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.
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.
|You can only have two active tokens. Otherwise you have to disable not used tokens here.|
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.
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).
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.
Adding the payment method individually to your Shopify store will result in the pre-selection of the payment method on the your payment page.
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.
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.
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.
|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]
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.
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.
|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.|
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
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.
|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.|
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.
In order to create token you will have to configure your payment method as described in the Tokenization Documentation.
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.