---
updatedAt: 2026-06-18T16:40:57.000Z
agentTools:
  projectIndex: https://docs.withreach.com/llms.txt
---

# Shopify Checkout.com guide

This guide will walk you through setting up an extension store on Shopify using the Checkout.com Onsite Payments App and Reach Embedded solution, and includes links to detailed instructions. For complete instructions, see the [Shopify onsite payments app guide](https://www.checkout.com/docs/payments/accept-payments/connect-to-an-ecommerce-platform/shopify-onsite-payments-app).

<CardCallout type="warning" title="Shopify extensibility">
  Per Shopify's requirements, the new Shopify onsite payments app is incompatible with checkout.liquid customizations you may have. If you've customized your checkout.liquid template, you must upgrade to checkout extensibility.
</CardCallout>

# Step 1. Install the Payments App

<CardCallout type="warning" title="Client ID and Client Secret">
  Your Reach representative will provide the Checkout.com Client ID and Client Secret. You will need these items in Step 2.
</CardCallout>

Go to the [Checkout.com Onsite Payments App](https://apps.shopify.com/checkout-com-onsite-payments) listing on the [Shopify app store](https://apps.shopify.com/), then click **Install**. Shopify will redirect you to the Install app page on your Shopify store. To install the Checkout.com Onsite Payments App, click **Install**.

<Image align="center" alt="click **Install**" border={true} caption="click **Install**" src="https://files.readme.io/e885dba0f85a684a0a4461789ee756a25c920476688ee7dd79cccc5fd50608ae-Checkout_com_Onsite_Payments_app.png" />

<br />

# Step 2. Configure the Payments App

After you install the app, you must configure it before activating it.

1. Enter the API credentials provided by your Reach representative.
2. Change Sandbox mode to Disabled.
3. Enter your 3DS settings preferences.

<CardCallout type="info" title="Note">
  You must disable 3DS for US stores.
</CardCallout>

4. Enter the **Billing Descriptor** details. In the **Billing Descriptor Name** field, provide the name you want to appear on your customer's credit card statements when they purchase a product from your store. This name will help customers identify the charge and reduce chargebacks due to unrecognized transactions. The format for the statement descriptor is RCH-\[your store descriptor], where your descriptor must be from 2 to 19 characters in length.
5. Click **Save**.

<Image align="center" alt="Checkout.com - Account Settings page" caption="Checkout.com - Account Settings page" src="https://files.readme.io/dceefaed1ba0e7f310d930fc847b9ff11480d079a039e0a1c29c26d42b548857-Reach_-_CheckoutAccountSettings.png" width="100% " />

6. Click **Webhooks**.
7. Click  **Register Webhook** and ensure the webhook was created successfully.

<Image align="center" alt="Checkout.com - Webhooks page" caption="Checkout.com - Webhooks page" src="https://files.readme.io/3133d66b9dae2c283f3c5dbd9107f9614b82c9da98737a2fc0bb19d99ab0416e-image.png" />

<br />

8. In the **Account Settings** section, validate that the **Account Not Ready** tag has changed to **Account Ready**.

<Image align="center" alt="Account Ready" caption="Account Ready" src="https://files.readme.io/b7c65d1fc246b87d9faf8ed193ce95c0fdd80a113324e722e6a5e84ab22ab117-Reach_-_ShopifyCheckoutAccountReadySave.png" width="90% " />

9. Click the **Back to Payments Settings** button.
10. You will be redirected to your Shopify store's alternative provider page. Click the **Activate Checkout.com—Onsite Payments** button.

<Image align="center" alt="Click the **Activate Checkout.com—Onsite Payments** button" caption="Click the **Activate Checkout.com—Onsite Payments** button" src="https://files.readme.io/5968214abec7470218470f513d2a3279ce07f45eeaa02e5525dff939e185ec36-Reach_-_ShopifyCheckoutPaymentMethods.png" width="80% " />

<br />

# Step 3. Terms and conditions

By deploying this solution, Reach will act as your Merchant of Record (MoR). 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 supplier.

To review our consumer terms of service, review the <Anchor label="Consumer Terms of Service" target="_blank" href="https://www.withreach.com/consumer-terms-of-service">Consumer Terms of Service</Anchor> page. For further details on displaying Reach Terms of Service, see the [Reach disclaimer and Terms of Service](https://docs.withreach.com/docs/reach-disclaimer-and-terms-of-service-requirements) page.

For information on adding the Reach footer and Terms of Service (ToS) to a Shopify store see [The Reach badge for Shopify stores](https://docs.withreach.com/docs/tos-for-shopify-stores) page for instructions on how to display them on your website—they must be accessible from a link on your website.