Plugin icon

Adyen payments app installation guide

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

  Read more

Learn more about the Adyen Payments App for Shopify.

Follow this installation and testing guide to start accepting payments with the Adyen Payments - Credit Cards app on your Shopify store.

The app does not support capture requests that are sent directly to Adyen. This includes capture requests sent to the Adyen API and captures through the Adyen Customer Area. All payment modifications must be initiated from Shopify, using the Shopify API or Shopify back office.

Before you begin

To use the app, you must have set up Checkout Extensibility for Shopify.

Before you begin to integrate, make sure you have followed the Get started with Adyen guide to:

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

Step 1: Install the app

Refer to Shopify documentation on Configuring third-party payment providers, to learn how to activate a credit card payment provider for your Shopify store.

Step 2: Set up the app

To start using the Adyen payments app:

  1. Connect your test Adyen account to your Shopify store.
  2. Activate the app in your Shopify store.

Connect your test Adyen account to your Shopify store

  1. In your Shopify admin interface, search for and open the Adyen Payments - Credit Cards app.
  2. On the Adyen Payment Configuration page, next to Test Account, select Authorize with Adyen.
    You will be redirected to the test Adyen Customer Area.
  3. Log in to the test Adyen Customer Area with the account you want to connect to your Shopify store.
  4. In the Payment Service (Live Testing) window that appears, select the merchant account you want to use for transactions.
  5. Select Grant access.
    You will be redirected to the Shopify admin interface.

Activate the app in your Shopify store

  1. Go to Settings > Payments.
  2. At the bottom of the page, select Activate Adyen Payments - Credit Cards.
  3. Select Manage next to Adyen Payments - Credit Cards.
  4. Under Test mode, select Enable test mode.
    You must enable this setting to ensure that test transactions do not attempt to charge the payment method you are using for testing purposes.

Step 3: Set up payment methods

Before you can use new payment methods, you need to add them in your Adyen Customer Area:

  1. Log in to your Customer Area.

  2. Switch to your merchant account.

  3. Go to Settings > Payment methods.

  4. Select Request payment methods.

  5. Start entering the name of the payment method, then select it from the drop-down list.

  6. Select Submit.

After you have added the payment methods in your Adyen Customer Area, you can enable and disable payment methods in Shopify:

  1. In your Shopify admin interface, go to Settings > Payments.
  2. Select Manage next to Adyen Payments - Credit Cards.
  3. On the payment methods list, use the checkboxes next to the payment method items to enable and disable payment methods.
  4. Select Save.

Step 4: Test your integration

After you have set up your account, use our 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 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.
    • Successful payment without 3D Secure 2 authentication.
  • Order without a shipping address
    • If you sell 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 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
Card Number Card Type Issuing Country 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 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 Expiry Date CVC SMS verification code
8171 9999 2766 0000 China UnionPay CN 03/2030 7373 Mobile: 123456
Desktop: 111111

Test 3D Secure 2

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

Card Number Card Type Issuing Country 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

Step 5: Go live

When you are ready to go live, apply for a live account. If your application for a live account is approved, you get access to the live Customer Area.

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 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.
  2. Connect the app to your live Adyen account.
  3. Disable test mode.
  4. Repeat the steps to 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. Select Manage next to Adyen Payments - Credit Cards.
  3. Under Account status, select Manage.
  4. On the Adyen Payment Configuration page, next to Test Account, select Disconnect Account.
  5. Select Disconnect Account to confirm.

Connect the app to your live Adyen account

  1. On the Adyen Payment Configuration page, next to Live Account, select Authorize with Adyen.
    You will be redirected to the live Adyen Customer Area.
  2. Log in to the live Adyen Customer Area with the account you want to connect to your Shopify store.
  3. In the Payment Service (Live Testing) window that appears, select the merchant account you want to use for transactions.
  4. Select Grant access.
    You will be redirected to the Shopify admin interface.

Disable test mode

  1. In your Shopify admin interface, go to Settings > Payments.
  2. Under Test mode, deselect Enable test mode.
  3. Select Save.

Deactivating the app

When you deactivate the app, your Shopify store will be disconnected from Adyen. In a case where you want to go back to using the old plugin, for example if you are having issues with the new app, you must reinstall the old plugin.

To deactivate the app:

  1. In your Shopify admin interface, go to Settings > Payments.
  2. Next to Adyen Payments - Credit Cards, select Manage.
  3. Under Account status, select Manage.
  4. Next to the environment you want to disconnect from, select Disconnect Account.
  5. Select Disconnect Account.

Troubleshooting

If you face any issues with your integration, contact our Support Team, 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.