Shopify

This page explains how to to get up and running with TrueLayer's Shopify app, powered by our latest Payments API v3 to access all of TrueLayer's payment products in all supported geographies.

TrueLayer configuration

Before you can integrate TrueLayer into your Shopify store, you must set up a Console account. Console is our back-office dashboard that allows you configure your TrueLayer account.

Here's how to configure your Console account:

1. Sign up to Console and verify your account.
2. Create a new application and download your client_secret.

Install the TrueLayer Shopify Payments app

1. Go to the TrueLayer app listing on the Shopify Marketplace.
2. Install the app to your desired store.

Configure Sandbox and Live Credentials

1. Go to the Admin panel of your Shopify store and click on TrueLayer Payments under the Apps section.
2. Go to Sandbox settings and download your signing key.
3. Now go back to TrueLayer's Console and go to Payments > Settings. Ensure that Sandbox mode is toggled on in Console:

4. Upload the signing key from Step 2. When done, copy the KID and paste it back in the TrueLayer app settings in Shopify. Then, save and continue.
5. Copy the Webhook URI at the bottom of your Sandbox Settings in the App's settings in Shopify. Go back to TrueLayer's Console and go to Payments > Settings, then paste the URL into the Webhook URI section.
6. Go to Console's App Settings and the following URL in the Allowed redirect URIs section:
   https://shop-pay-app-api.truelayer.com/hpp-finish

7. Return to the TrueLayer Payments app settings in Shopify, and go to Live settings. Repeat steps 6-10 but for your live environment.
8. When you're ready to go-live, go to Settings > Payments. Then, click Manage next to TrueLayer Payments. Uncheck Test mode, then click Save. You can now process live payments!