Shopify extension setup
Prerequisites
Shopify store
In case you don't have a Shopify store yet please visit https://www.shopify.com/ to set up your own online store.
Worldline account
To use this extension, you need an Worldline account. Please visit https://www.ingenico.com/epayments for more information or contact the Worldline team.
Alternatively you can also test out the Shopify extension with a free Sandbox account.
Installation and configuration
Step 1: Installation
Go to https://ingenico.apps.esign.eu/install and enter the first part of your myshopify-URL. Confirm the ‘install’.
Step 2: Configuration
General Settings
Environment
Choose one of the different environments that you want to link your store with:
- Sandbox
Endpoint: https://eu.sandbox.api-ingenico.com - Pre-Production
Endpoint: https://world.preprod.api-ingenico.com - Production
Endpoint: https://word.api-ingenico.com
Authorization mode
Choose the authorization mode used for your transactions:
- Sale
The payment creation results in an authorization that is already captured at the moment of approval. - Final Authorization
The payment creation results in an authorization that is ready for capture. Final authorizations can't be reversed and need to be captured for the full amount within 7 days. - Pre-authorization
The payment creation results in a pre-authorization that is ready for capture. Pre-authortizations can be reversed and can be captured within 30 days. The capture amount can be lower than the authorized amount.
Credentials
Merchant ID
Enter the merchant ID. You can find it in the Worldline Configuration Center.
API keys
Enter the API key ID and API Secret Key.
You can also find these in the ePayments Configuration Center.
Webhooks keys
Enter the Webhook key ID and Webhook Secret Key.
You can also find these in the ePayments Configuration Center.
Webhook endpoint
Go to Webhooks in the Configuration Center and add an endpoint.
Copy the provided endpoint URL from the settings app:
Paste the URL in the field “Endpoint URL” in the configuration center. Select “Send all events”, enter your password and submit.
Install Payment Gateway
The next step of the installation guide will provide you a link to authorize the payment gateway. Click the link and confirm.
Next up you will be redirected to the Payment providers section in the setting of your Shopify store.
Under Alternative Payments select Worldline Gateway.
Enter your Merchant ID and the API Secret Key. If you go back to Apps > Worldline Settings you can copy these values.
Complete installation
Go back to the settings app (Apps > Worldline Settings) and click the button “Complete install”.
Settings
General
Under General settings you can change the environment, language and enter the email address of the fraud manager.
Set “Save logs” to Yes if you want all communication between Shopify and Worldlineto be logged.
An extra tab “Logs” will appear, where you can download the log files.
Technical
The connection settings provided during the installation process.
Custom messages
For each payment status you can set up a custom response message to the customer. When left blank the default response is used.
Workflow
Order placement
A new payment method will be available in the checkout:
After placing an order with the Worldline payment method, the customer is redirected to an external page to enter the payment information. The external page is hosted by Worldline.
Afterwards, the customer is redirected back to Shopify and will see the Thank you page.
The payment status will be AUTHORIZED in case of Final- or Pre-authorization on Authorization Settings. Otherwise the status PAID will indicate a successful transaction. The next section explains how to deal with those statuses.
Capture
If you are using Final- or Pre-authorization (see section Authorization Settings). Orders that are processed with Worldline have to be manually captured (approved) by the merchant.
For more information on how to capture an order in Shopify go to https://help.shopify.com/en/manual/orders/get-paid
Note that you can only capture once.
As soon as Worldline reports the capture or approval as complete, the payment status in Shopify is set to PAID.
Refund and cancellation
You can refund an entire order or part of an order. In some circumstances, you can cancel an order and issue a refund.
For more information on how to refund or cancel an order in Shopify go to https://help.shopify.com/en/manual/orders/refund-cancel-order
The refund or cancellation will be marked “pending”. As soon as Worldline reports the refund or cancellation as complete, the payment status in Shopify is set to REFUNDED or VOIDED.