---
title: "Shopify"
description: "Install the Adyen payments app for Shopify and test your integration."
url: "https://docs.adyen.com/plugins/shopify"
source_url: "https://docs.adyen.com/plugins/shopify.md"
canonical: "https://docs.adyen.com/plugins/shopify"
last_modified: "2025-04-24T12:42:00+02:00"
language: "en"
---

# Shopify

Install the Adyen payments app for Shopify and test your integration.

[View source](/plugins/shopify.md)

![](/user/pages/docs/05.plugins/27.shopify/shopify.svg?decoding=auto\&fetchpriority=auto)  **Read more**

Learn more about the [Adyen Payments App for Shopify](https://www.adyen.com/partners/shopify).

Follow our installation and testing guide to start accepting payments with the [**Adyen Payments - Credit Cards** ](https://apps.shopify.com/adyen-credit-card), and [**Adyen - Alternative Payments** ](https://apps.shopify.com/adyen-lpm)apps on your Shopify store.

## Requirements

To use the app, you must have set up [Checkout Extensibility](https://www.shopify.com/nl/checkout#advanced-customizations) for Shopify.

Before you begin to integrate, make sure you have followed the [Get started with Adyen guide](/get-started-with-adyen) to:

* Get an overview of the steps needed to accept live payments.
* Create your test account.

## Step 1: Set up payment methods

Check our list of [supported payment methods](/plugins/shopify/supported-payment-methods), and choose the payment methods that you want to offer to your shoppers.

You can request payment methods to be added to your merchant account in your [test Customer Area](https://ca-test.adyen.com/) or [live Customer Area](https://ca-live.adyen.com/).

1. In your Customer Area, switch to your merchant account.
2. Go to **Settings** > **Payment methods**.
3. Select **Request payment methods** to view all available payment methods.
4. Use the dropdown lists to filter payment methods by location and type.
5. Select the payment method(s) you want to request for your merchant account.
6. Select **Add**.
7. Apply the payment method(s) to **This merchant account**.
8. If prompted, fill in the required information.
9. Review your requests.
10. Select **Submit request**.

## Step 2: Install the Adyen credit cards app

Refer to Shopify documentation on [Configuring third-party payment providers](https://help.shopify.com/en/manual/payments/third-party-providers/configuring-providers), and activate Adyen as your credit card payment provider with the [**Adyen Payments - Credit Cards** ](https://apps.shopify.com/adyen-credit-card)app.

## Step 3: Set up the credit cards app

To start using the Adyen payments app:

1. [Connect your test Adyen account to your Shopify store](#connect-your-test-adyen-account-to-your-shopify-store).
2. [Activate the app in your Shopify store](#activate-the-app-in-your-shopify-store).

### Connect your test Adyen account to your Shopify store

1. After installing the app, you are redirected to the **Adyen Payment Configuration** page. To navigate to this page manually, go to **More actions** > **Manage**.

2. On the **Adyen Payment Configuration** page, select the Adyen account you want to connect to your Shopify store:

   * To connect your test account, in the **Test Account** section, select **Authorize with Adyen**. We recommend to set up the plugin and test with your test account first, and switch to your live account when [going live](#go-live).
   * To connect your live account, in the **Live Account** section, select **Authorize with Adyen**.

   You will be redirected to the Adyen Customer Area.

3. In the Customer Area, a **Payment Service (Live Testing)** window will appear, select the merchant account you want to connect to your Shopify store.

   You can only have one merchant account per region, if you select multiple merchant accounts, you will receive an error and have to re-authenticate.

4. Select **Grant access**.\
   You will be redirected to the Shopify admin interface.

### Activate the app in your Shopify store

1. On the **Adyen Payment Configuration** page, select **Activate** at the top of the page.\
   You will be redirected to the **Adyen Payments - Credit Cards** page.

2. On the payment methods list, select the payment methods that you want to display to your shoppers at checkout.

   * If you experience issues enabling Apple Pay and Google Pay, first complete the steps to activate the app, then enable these payment methods.

   You do not have to enable Apple Pay and Google Pay in your Adyen Customer Area. For all other payment methods, you must [set them up in your Customer Area](#set-up-payment-methods).

3. Under **Test mode**, select **Enable test mode**.\
   This setting ensures that test transactions do not attempt to charge the payment method you are use for testing. When [going live](#go-live), disable test mode by deselecting the checkbox.

4. At the bottom of the page, select **Activate**.

## Step 4: Install and set up the alternative payments app

Before you begin to set up the **Adyen - Alternative Payments** app, make sure that you completed the [setup for the credit cards app](#set-up-the-credit-cards-app).

Install the app with either of the options:

* From your Shopify admin interface:

  1. Go to **Settings** > **Payments** > **Additional payment methods** > **Add payment method**.
  2. Search for the **Adyen - Alternative Payments** app.
  3. Select **Install**.

* From the Shopify App Store: [**Adyen - Alternative Payments**](https://apps.shopify.com/adyen-lpm)

After you have installed the **Adyen Payments - Credit Cards** app, you are directed to the **Adyen Payment Configuration** page. To set up the app:

1. On the **Adyen Payment Configuration** page, under **Payment methods**, select **Sync payment methods** to sync the payment methods you enabled in your Adyen Customer Area to your Shopify store.
2. When the sync is completed, select **View payment methods** to verify that all your payment methods are shown.
3. Go back to the **Adyen Payment Configuration** page, and select **Activate** at the top of the page.\
   You will be redirected to the **Adyen Payments - Credit Cards** page.
4. At the bottom of the page, select **Activate**.

## Test your integration

Use our [test cards](#test-cards) to test your integration. We recommend to make a copy of your store in case you have to revert, for example if something goes wrong during testing. You can duplicate your store manually or use a duplication app from the Shopify App Store.

We recommend testing in both test and live environments. After you are done testing in test mode, [switch to the live environment](#go-live) and test live payments.

### Happy flows

Test the following flows to ensure your integration can handle successful payment flows.

* 3D Secure 2 authentication flows

  * Successful payment with 3D Secure 2 authentication. Use our [cards enrolled in 3D Secure 2](#3d-secure).
  * Successful payment without 3D Secure 2 authentication.

* Order without a shipping address
  * If you sell [digital products](https://help.shopify.com/en/manual/products/digital-service-product/selling-services-or-digital-products), your integration should be able to process orders when a shopper does not provide a shipping address.

### Non-happy flows

We recommend to test non-happy flows to make sure that your integration can handle different scenarios.

To trigger non-happy flows, you need to use specific **Name on card** values at checkout. For **Card number**, **Expiration date**, and **Security code** fields, use the card details of our [test cards](#test-cards) with a valid billing address.

Test the following scenarios with the cardholder name provided to ensure your integration can handle unsuccessful payment flows.

| Test scenario         | **Name on card**           |
| --------------------- | -------------------------- |
| Failed authentication | **NOT\_3D\_AUTHENTICATED** |
| Declined card         | **DECLINED**               |
| Expired card          | **CARD\_EXPIRED**          |
| Invalid address       | **AVS\_DECLINED**          |
| Incorrect CVC         | **INVALID\_CARD\_NUMBER**  |
| Incorrect Pin         | **INVALID\_PIN**           |
| Suspected fraud       | **FRAUD**                  |

**

### Test cards

| Card Number         | Card Type        | Issuing Country/region | Expiry Date | CVC  |
| ------------------- | ---------------- | ---------------------- | ----------- | ---- |
| 3700 0000 0000 002  | American Express | NL                     | 03/2030     | 7373 |
| 3600 6666 3333 44   | Diners           | US                     | 03/2030     | 737  |
| 6011 6011 6011 6611 | Discover         | US                     | 03/2030     | 737  |
| 6445 6445 6445 6445 | Discover         | GB                     | 03/2030     | 737  |
| 3569 9900 1009 5841 | JCB              | US                     | 03/2030     | 737  |
| 2223 0000 4841 0010 | Mastercard       | NL                     | 03/2030     | 737  |
| 4000 0200 0000 0000 | Visa             | US                     | 03/2030     | 737  |
| 4166 6766 6766 6746 | Visa             | NL                     | 03/2030     | 737  |
| 4001 0200 0000 0009 | Visa Electron    | BR                     | 03/2030     | 737  |

The following test cards do not require the CVC when entering the card details.

| Card Number         | Card Type        | Issuing Country/region | Expiry Date | CVC  |
| ------------------- | ---------------- | ---------------------- | ----------- | ---- |
| 3700 0000 0100 018  | American Express | NL                     | 03/2030     | 7373 |
| 3607 0500 0010 20   | Diners           | NL                     | 03/2030     | 737  |
| 4111 1111 4555 1142 | Visa             | NL                     | 03/2030     | 737  |

The following details are to test China UnionPay payments.

| Card Number         | Card Type      | Issuing Country/region | Expiry Date | CVC | SMS verification code          |
| ------------------- | -------------- | ---------------------- | ----------- | --- | ------------------------------ |
| 8171 9999 2766 0000 | China UnionPay | CN                     | 10/2030     | 737 | Mobile: 123456 Desktop: 111111 |

### 3D Secure 2

The following test cards are enrolled in 3D Secure 2.

| Card Number         | Card Type        | Issuing Country/region | Expiry Date | CVC  |
| ------------------- | ---------------- | ---------------------- | ----------- | ---- |
| 3714 4963 5398 431  | American Express | US                     | 03/2030     | 7373 |
| 4360 0000 0100 0005 | Cartes Bancaires | FR                     | 03/2030     | 737  |
| 6011 1111 1111 1117 | Discover         | US                     | 03/2030     | 737  |
| 2222 4000 1000 0008 | Mastercard       | CA                     | 03/2030     | 737  |

## Go live

When you are ready to go live, [apply for a live account](/get-started-with-adyen#apply-for-your-live-account). If your application for a live account is approved, you [get access to the live Customer Area](/get-started-with-adyen#step-4-sign-the-contract-and-get-your-live-account).

To start accepting live payments using your live account, you must first configure your account. The settings from your test account are not copied to your live account. You must also repeat the steps to [add payment methods to your account](#set-up-payment-methods) in the live Customer Area.

To take your Shopify integration live after you have configured your live Adyen account:

1. [Disconnect the app from your test Adyen account](#disconnect-from-test-account).
2. [Set up the app for your live Adyen account](#connect-to-live-account).
3. Repeat the steps to [test your integration](#test-your-integration) for end-to-end testing.

### Disconnect the app from your test Adyen account

1. In your Shopify admin interface, go to **Settings** > **Payments**.
2. In the **Adyen Payments - Credit Cards** page, under **Account status**, select **Manage**.
3. On the **Adyen Payment Configuration** page, next to **Test Account**, select **Disconnect Account**.
4. Select **Disconnect Account** to confirm.

### Set up the app for your live Adyen account

Repeat the following steps for live Adyen account:

1. [Connect the app to your Adyen account](#connect-your-test-adyen-account-to-your-shopify-store).
2. [Activate the app in your Shopify store](#activate-the-app-in-your-shopify-store).

## Troubleshooting

If you face any issues with your integration, contact our [Support Team](https://ca-test.adyen.com/ca/ca/contactUs/support.shtml?form=other), and provide the following information:

* Whether the issue was identified by your personnel while integrating or shoppers.
* The environment in which the issue occurs (TEST, LIVE, or both)
* Date on which the issue occurred.
* Description of the issue and its impact. For example, how often does it occur and the consequences.
* Steps to reproduce the issue.
