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:
Connect your test Adyen account to your Shopify store
- In your Shopify admin interface, search for and open the Adyen Payments - Credit Cards app.
- On the Adyen Payment Configuration page, next to Test Account, select Authorize with Adyen.
You will be redirected to the test Adyen Customer Area. - Log in to the test Adyen Customer Area with the account you want to connect to your Shopify store.
- In the Payment Service (Live Testing) window that appears, select the merchant account you want to use for transactions.
- Select Grant access.
You will be redirected to the Shopify admin interface.
Activate the app in your Shopify store
- Go to Settings > Payments.
- At the bottom of the page, select Activate Adyen Payments - Credit Cards.
- Select Manage next to Adyen Payments - Credit Cards.
- 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:
-
Log in to your Customer Area.
- For a test integration, log in to your test Customer Area.
-
For a live integration, log in to your live Customer Area.
-
Switch to your merchant account.
-
Go to Settings > Payment methods.
-
Select Request payment methods.
-
Start entering the name of the payment method, then select it from the drop-down list.
-
Select Submit.
After you have added the payment methods in your Adyen Customer Area, you can enable and disable payment methods in Shopify:
- In your Shopify admin interface, go to Settings > Payments.
- Select Manage next to Adyen Payments - Credit Cards.
- On the payment methods list, use the checkboxes next to the payment method items to enable and disable payment methods.
- 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 |
Test cards
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:
- Disconnect the app from your test Adyen account.
- Connect the app to your live Adyen account.
- Disable test mode.
- Repeat the steps to test your integration for end-to-end testing.
Disconnect the app from your test Adyen account
- In your Shopify admin interface, go to Settings > Payments.
- Select Manage next to Adyen Payments - Credit Cards.
- Under Account status, select Manage.
- On the Adyen Payment Configuration page, next to Test Account, select Disconnect Account.
- Select Disconnect Account to confirm.
Connect the app to your live Adyen account
- On the Adyen Payment Configuration page, next to Live Account, select Authorize with Adyen.
You will be redirected to the live Adyen Customer Area. - Log in to the live Adyen Customer Area with the account you want to connect to your Shopify store.
- In the Payment Service (Live Testing) window that appears, select the merchant account you want to use for transactions.
- Select Grant access.
You will be redirected to the Shopify admin interface.
Disable test mode
- In your Shopify admin interface, go to Settings > Payments.
- Under Test mode, deselect Enable test mode.
- 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:
- In your Shopify admin interface, go to Settings > Payments.
- Next to Adyen Payments - Credit Cards, select Manage.
- Under Account status, select Manage.
- Next to the environment you want to disconnect from, select Disconnect Account.
- 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.