Skip to content

Shopify payments app

Last updated: 3rd August 2022

From downloading the payments app to requesting your first test payment, learn how to get started with the Checkout.com Payments App for Shopify.


Supported features

  • Automatic and manual capture, void, and refund from the Shopify Admin Portal
  • Partial capture and partial refunds
  • Cards and alternative payment methods
  • Webhook notifications for up-to-date payment statuses
  • Hosted Payments Page
  • 3D Secure 2.0
  • Dynamic descriptors

Before you start

To connect the Checkout.com Payments App to your Shopify store, you will need your API keys:

  1. Sign in to your Dashboard account.
  2. Create a secret API key. Keep this key somewhere safe, because you will not be able to view the full key after it's been generated.

Install the payments app

  1. Go to the Checkout.com Payments App listing on the Shopify app store and select Add app.
  2. You'll be redirected to your Shopify store, where you'll be prompted to install the Checkout.com Payments App. Select Install app.

Configure the payments app

After installing the app, you will need to configure it before it can be activated. Select Manage to enter the app configuration and settings.

  1. Under Account Type, select NAS Account.
  2. Enter your API credentials. If you do not have a Production secret API key, you can reuse your Sandbox secret API key and remove the _test prefix.
  3. Select the payment methods you want to support.
  4. Select whether you want to enable 3DS authentication.
  5. Enter the billing descriptor details.
  6. Select Save.
  7. After configuring the Account Settings section, navigate to Apps > Webhooks in the left-hand menu.
  8. Select Register Webhook for the environments you’ll be using.
  9. In the Account Settings section, ensure that the Account Not Ready tag has changed to Account Ready.

Activate the payments app

When the application has been configured and the tag has changed to Account Ready, you can activate the payments app:

  1. Go to Settings > Payments.
  2. In the Supported payment methods section, select Add payment methods.
  3. Select Search by provider and search for Checkout.com.
  4. Select Checkout.com – Offsite Payments, and activate it.
  5. You'll be redirected to the Account Settings page. Select Activate Checkout.com - Offsite Payments at the bottom – this will enable the Checkout.com Payments App on your store.

Migrate from the legacy off-site integration to the Checkout.com Payments App

If you currently have the legacy off-site integration activated, follow these steps to migrate to the Checkout.com Payments App:

  1. From the Shopify Admin Portal, go to Settings > Payments.
  2. In the Supported payment methods section, select Add payment methods.
  3. Select Search by provider, choose Checkout.com - Offsite Payments, and select either Activate or Activate the test mode to simulate transactions before going live.
  4. When you're ready to go live, deactivate the legacy Checkout.com off-site integration:
    1. From the Shopify Admin Portal, go to Settings > Payments.
    2. In the Supported payment methods section, find the legacy Checkout.com off-site integration and select Manage.
    3. Select Deactivate to disable the integration.

When you deactivate the legacy off-site integration, its payment methods are no longer displayed on the checkout page. However, you can still manage refunds and captures for orders created with the deactivated integration, via Shopify Admin Portal or the Dashboard.

If you uninstall the legacy off-site integration, it will not be available for use with any outstanding order returns.


Test your integration

  1. From the Shopify Admin Portal, go to Settings > Payments.
  2. In the Supported payment methods section, find Checkout.com - Offsite Payments and select Manage.
  3. In the Test mode section, select Enable test mode.
  4. Go to your storefront and add a product to your cart.
  5. Go to your cart and proceed to checkout.
  6. Enter the required billing details. We recommend using a real email address so you can receive the order confirmation.
  7. Select Continue to shipping, then Continue to payment.
  8. After clicking Complete order, you will be redirected to our Hosted Payments Page to complete the test payment.
  9. Enter the following card details:
    • Number: 4242 4242 4242 4242
    • Expiry date: any future date
    • CVV: 100
  10. Select Pay. After completing the 3DS authentication simulator, you'll be redirected to the order confirmation page. If you entered a real email address in the billing details, you'll also receive an order confirmation email.
  11. In the Shopify store admin, go to Orders to confirm that the order has gone through.
  12. Sign in to your Checkout.com Dashboard account.
  13. Go to Payments. The order payment will be displayed there with a status indication, such as AUTH.

Go live

If you're happy with the outcome of your testing and want to start taking payments right away, find Checkout.com - Offsite Payments in the Supported payment methods section, select Manage and deselect Enable Test Mode.

You are now live with the Checkout.com Payments App.