DocumentationAPI Reference
Documentation

Shopify Checkout.com Embedded Gateway Guide

This guide will walk you through setting up an extension store on Shopify using the Reach Embedded solution.

Steps to Install

This document covers all the steps required to Install, and links to detailed instructions are included throughout.
Here is a link to the complete steps on Checkout.com

🚧

Shopify Extensibility

As per Shopify’s requirements, the new Shopify onsite payments app is not compatible with any checkout.liquid customizations you may have. If you’ve customized your checkout.liquid template, you’ll need to upgrade to checkout extensibility.

👍

The Checkout.com Client ID and Client Secret you received in your email will be required for Step 2.1


Step One

Install the Payments App

Browse to the Checkout.com Onsite Payments App listing on the Shopify app store then select Install.

You'll be redirected to your Shopify store where you'll be prompted to install the Checkout.com Onsite Payments App. Select Install app.


Step Two

Configure the Payments App

After installing the app you will need to configure it before it can be activated. You should be automatically redirected to the configuration page.

  1. Enter your API credentials - these were emailed to you.
  2. Enter your 3DS settings preferences.
    (disable for US stores)
  3. Enter the billing descriptor details RCH-[Store Name]
  4. Select Save.


  1. After configuring the Account Settings section, navigate to Webhooks.
  2. Select Register Webhook and ensure the webhook is created successfully.


  1. In the Account Settings _section, validate that the Account Not Ready tag has changed to Account Ready._
  2. Select the Back to Payments Settings button.
  3. You will be redirected to the alternative providers page in your Shopify store. Select the Activate Checkout.com Onsite Payments button.


Step Three

Terms & conditions

Merchant of Record requirements

By deploying this solution, Reach will be acting as your Merchant of Record. There are legal requirements from our processing partners that we strictly adhere to, such as the Terms & Conditions laid out by our partnership with the merchant.

Please visit this link to read our Terms & Conditions and follow the steps outlined to easily place them on your website - these must be accessible from a link in the footer of your website.