{"title":"Shopify","category":"default","creationDate":1674038040,"content":"<div class=\"additional-info-block output-inline\">\n<div class=\"additional-info-block__body\"><p><img style=\"width: 38px;\" alt=\"\" src=\"\/user\/pages\/docs\/05.plugins\/27.shopify\/shopify.svg?decoding=auto&amp;fetchpriority=auto\" \/>&nbsp; <strong>Read more<\/strong><\/p><p>Learn more about the <a href=\"https:\/\/www.adyen.com\/partners\/shopify\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Adyen Payments App for Shopify<\/a>.<\/p><\/div><\/div>\n\n<p>Follow our installation and testing guide to start accepting payments with the <a href=\"https:\/\/apps.shopify.com\/adyen-credit-card\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">\n  <span translate=\"no\">\n    <strong>Adyen Payments - Credit Cards<\/strong>\n  <\/span>\n<\/a>, and <a href=\"https:\/\/apps.shopify.com\/adyen-lpm\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">\n  <span translate=\"no\">\n    <strong>Adyen - Alternative Payments<\/strong>\n  <\/span>\n<\/a> apps on your Shopify store.<\/p>\n<h2>Requirements<\/h2>\n<p>To use the app, you must have set up <a href=\"https:\/\/www.shopify.com\/nl\/checkout#advanced-customizations\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Checkout Extensibility<\/a> for Shopify.<\/p>\n<p>Before you begin to integrate, make sure you have followed the <a href=\"\/get-started-with-adyen\">Get started with Adyen guide<\/a> to:<\/p>\n<ul>\n<li>Get an overview of the steps needed to accept live payments.<\/li>\n<li>Create your test account.<\/li>\n<\/ul>\n<h2 id=\"set-up-payment-methods\">Step 1: Set up payment methods<\/h2>\n<p>Check our list of <a href=\"\/plugins\/shopify\/supported-payment-methods\">supported payment methods<\/a>, and choose the payment methods that you want to offer to your shoppers.<\/p>\n<p>You can request payment methods to be added to your merchant account in your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">test Customer Area<\/a> or <a href=\"https:\/\/ca-live.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">live Customer Area<\/a>.<\/p>\n<ol>\n<li>In your Customer Area, switch to your merchant account.<\/li>\n<li>Go to <strong>Payments<\/strong> &gt; <strong>Payment methods<\/strong>.<\/li>\n<li>Select <strong>Request payment methods<\/strong> to view all available payment methods.<\/li>\n<li>Use the dropdown lists to filter payment methods by location and type.<\/li>\n<li>Select the payment method(s) you want to request for your merchant account.<\/li>\n<li>Select <strong>Add<\/strong>.\n<\/li>\n<li>Apply the payment method(s) to <strong>This merchant account<\/strong>.\n<\/li>\n<li>If prompted, fill in the required information.<\/li>\n<li>Review your requests.<\/li>\n<li>Select <strong>Submit request<\/strong>.<\/li>\n<\/ol>\n<h2>Step 2: Install the Adyen credit cards app<\/h2>\n<p>Refer to <span translate=\"no\">Shopify<\/span> documentation on <a href=\"https:\/\/help.shopify.com\/en\/manual\/payments\/third-party-providers\/configuring-providers\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Configuring third-party payment providers<\/a>, and activate Adyen as your credit card payment provider with the <a href=\"https:\/\/apps.shopify.com\/adyen-credit-card\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">\n  <span translate=\"no\">\n    <strong>Adyen Payments - Credit Cards<\/strong>\n  <\/span>\n<\/a> app.<\/p>\n<h2 id=\"set-up-the-credit-cards-app\">Step 3: Set up the credit cards app<\/h2>\n<p>To start using the Adyen payments app:<\/p>\n<ol>\n<li><a href=\"#connect-your-test-adyen-account-to-your-shopify-store\">Connect your test Adyen account to your Shopify store<\/a>.<\/li>\n<li><a href=\"#activate-the-app-in-your-shopify-store\">Activate the app in your Shopify store<\/a>.<\/li>\n<\/ol>\n<h3 id=\"connect-your-test-adyen-account-to-your-shopify-store\">Connect your test Adyen account to your Shopify store<\/h3>\n<ol>\n<li>After installing the app, you are redirected to the <span translate=\"no\"><strong>Adyen Payment Configuration<\/strong><\/span> page. To navigate to this page manually, go to <span translate=\"no\"><strong>More actions<\/strong><\/span> &gt; <span translate=\"no\"><strong>Manage<\/strong><\/span>.<\/li>\n<li>\n<p>On the <span translate=\"no\"><strong>Adyen Payment Configuration<\/strong><\/span> page, select the Adyen account you want to connect to your <span translate=\"no\">Shopify<\/span> store:<\/p>\n<ul>\n<li>To connect your test account, in the <span translate=\"no\"><strong>Test Account<\/strong><\/span> section, select <span translate=\"no\"><strong>Authorize with Adyen<\/strong><\/span>. We recommend to set up the plugin and test with your test account first, and switch to your live account when <a href=\"#go-live\">going live<\/a>.<\/li>\n<li>To connect your live account, in the <span translate=\"no\"><strong>Live Account<\/strong><\/span> section, select <span translate=\"no\"><strong>Authorize with Adyen<\/strong><\/span>.<\/li>\n<\/ul>\n<p>You will be redirected to the Adyen Customer Area.<\/p>\n<\/li>\n<li>In the Customer Area, a <strong>Payment Service (Live Testing)<\/strong> window will appear, select the merchant account you want to connect to your <span translate=\"no\">Shopify<\/span> store.\n<div class=\"notices yellow\">\n<p>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.<\/p>\n<\/div><\/li>\n<li>Select <strong>Grant access<\/strong>.<br \/>\nYou will be redirected to the Shopify admin interface.<\/li>\n<\/ol>\n<h3 id=\"activate-the-app-in-your-shopify-store\">Activate the app in your Shopify store<\/h3>\n<ol>\n<li>On the <span translate=\"no\"><strong>Adyen Payment Configuration<\/strong><\/span> page, select <span translate=\"no\"><strong>Activate<\/strong><\/span> at the top of the page.<br \/>\nYou will be redirected to the <span translate=\"no\"><strong>Adyen Payments - Credit Cards<\/strong><\/span> page.<\/li>\n<li>\n<p>On the payment methods list, select the payment methods that you want to display to your shoppers at checkout.<\/p>\n<ul>\n<li>If you experience issues enabling <span translate=\"no\">Apple Pay<\/span> and <span translate=\"no\">Google Pay<\/span>, first complete the steps to activate the app, then enable these payment methods.<\/li>\n<\/ul>\n<div class=\"notices yellow\">\n<p>You do not have to enable <span translate=\"no\">Apple Pay<\/span> and <span translate=\"no\">Google Pay<\/span> in your Adyen Customer Area. For all other payment methods, you must <a href=\"#set-up-payment-methods\">set them up in your Customer Area<\/a>.<\/p>\n<\/div>\n<\/li>\n<li>Under <span translate=\"no\"><strong>Test mode<\/strong><\/span>, select <span translate=\"no\"><strong>Enable test mode<\/strong><\/span>.<br \/>\nThis setting ensures that test transactions do not attempt to charge the payment method you are use for testing. When <a href=\"#go-live\">going live<\/a>, disable test mode by deselecting the checkbox.<\/li>\n<li>At the bottom of the page, select <span translate=\"no\"><strong>Activate<\/strong><\/span>.<\/li>\n<\/ol>\n<h2>Step 4: Install and set up the alternative payments app<\/h2>\n<p>Before you begin to set up the <span translate=\"no\"><strong>Adyen - Alternative Payments<\/strong><\/span> app, make sure that you completed the <a href=\"#set-up-the-credit-cards-app\">setup for the credit cards app<\/a>.<\/p>\n<p>Install the app with either of the options:<\/p>\n<ul>\n<li>From your <span translate=\"no\">Shopify<\/span> admin interface:\n<ol>\n<li>Go to <span translate=\"no\"><strong>Settings<\/strong><\/span> &gt; <span translate=\"no\"><strong>Payments<\/strong><\/span> &gt; <span translate=\"no\"><strong>Additional payment methods<\/strong><\/span> &gt; <span translate=\"no\"><strong>Add payment method<\/strong><\/span>.<\/li>\n<li>Search for the <span translate=\"no\"><strong>Adyen - Alternative Payments<\/strong><\/span> app.<\/li>\n<li>Select <span translate=\"no\"><strong>Install<\/strong><\/span>.<\/li>\n<\/ol><\/li>\n<li>From the Shopify App Store:  <a href=\"https:\/\/apps.shopify.com\/adyen-lpm\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">\n  <span translate=\"no\">\n    <strong>Adyen - Alternative Payments<\/strong>\n  <\/span>\n<\/a><\/li>\n<\/ul>\n<p>After you have installed the <span translate=\"no\"><strong>Adyen Payments - Credit Cards<\/strong><\/span> app, you are directed to the <span translate=\"no\"><strong>Adyen Payment Configuration<\/strong><\/span> page. To set up the app:<\/p>\n<ol>\n<li>On the <span translate=\"no\"><strong>Adyen Payment Configuration<\/strong><\/span> page, under <span translate=\"no\"><strong>Payment methods<\/strong><\/span>, select <span translate=\"no\"><strong>Sync payment methods<\/strong><\/span> to sync the payment methods you enabled in your Adyen Customer Area to your <span translate=\"no\">Shopify<\/span> store.<\/li>\n<li>When the sync is completed, select <span translate=\"no\"><strong>View payment methods<\/strong><\/span> to verify that all your payment methods are shown.<\/li>\n<li>Go back to the <span translate=\"no\"><strong>Adyen Payment Configuration<\/strong><\/span> page, and select <span translate=\"no\"><strong>Activate<\/strong><\/span> at the top of the page.<br \/>\nYou will be redirected to the <span translate=\"no\"><strong>Adyen Payments - Credit Cards<\/strong><\/span> page.<\/li>\n<li>At the bottom of the page, select <span translate=\"no\"><strong>Activate<\/strong><\/span>.<\/li>\n<\/ol>\n<h2 id=\"test-your-integration\">Test your integration<\/h2>\n<p>Use our <a href=\"#test-cards\">test cards<\/a> 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.<\/p>\n<p>We recommend testing in both test and live environments. After you are done testing in test mode, <a href=\"#go-live\">switch to the live environment<\/a> and test live payments.<\/p>\n<h3>Happy flows<\/h3>\n<p>Test the following flows to ensure your integration can handle successful payment flows.<\/p>\n<ul>\n<li>3D Secure 2 authentication flows\n<ul>\n<li>Successful payment with 3D Secure 2 authentication. Use our <a href=\"#3d-secure\">cards enrolled in 3D Secure 2<\/a>.<\/li>\n<li>Successful payment without 3D Secure 2 authentication.<\/li>\n<\/ul><\/li>\n<li>Order without a shipping address\n<ul>\n<li>If you sell <a href=\"https:\/\/help.shopify.com\/en\/manual\/products\/digital-service-product\/selling-services-or-digital-products\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">digital products<\/a>, your integration should be able to process orders when a shopper does not provide a shipping address.<\/li>\n<\/ul><\/li>\n<\/ul>\n<h3>Non-happy flows<\/h3>\n<p>We recommend to test non-happy flows to make sure that your integration can handle different scenarios.<\/p>\n<p>To trigger non-happy flows, you need to use specific <span translate=\"no\"><strong>Name on card<\/strong><\/span> values at checkout. For <span translate=\"no\"><strong>Card number<\/strong><\/span>, <span translate=\"no\"><strong>Expiration date<\/strong><\/span>, and <span translate=\"no\"><strong>Security code<\/strong><\/span> fields, use the card details of our <a href=\"#test-cards\">test cards<\/a> with a valid billing address.<\/p>\n<p>Test the following scenarios with the cardholder name provided to ensure your integration can handle unsuccessful payment flows.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Test scenario<\/th>\n<th style=\"text-align: left;\"><span translate=\"no\"><strong>Name on card<\/strong><\/span><\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">Failed authentication<\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>NOT_3D_AUTHENTICATED<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Declined card<\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>DECLINED<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Expired card<\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>CARD_EXPIRED<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Invalid address<\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>AVS_DECLINED<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Incorrect CVC<\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>INVALID_CARD_NUMBER<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Incorrect Pin<\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>INVALID_PIN<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Suspected fraud<\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>FRAUD<\/strong><\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div class=\"accordion-shortcode adl-accordion adl-accordion--max-height-transition\" data-expand=\"true\" data-ignore=\"anchorjs-link\">\n    \n    <div class=\"adl-accordion__item\" style=\"\">\n        <div tabindex=\"0\" role=\"item\" aria-expanded=\"false\" class=\"adl-accordion__header\">\n            <i class=\"adl-accordion__toggle adl-icon-chevron-down\"><\/i>\n            <div class=\"adl-accordion__title-wrapper\" data-accordion=\"#test-cards\">\n                                    <h3 class=\"adl-accordion__title\">Test cards<\/h3>\n                            <\/div>\n        <\/div>\n        <div role=\"region\" class=\"adl-accordion__content\">\n            \n<table>\n<thead>\n<tr>\n<th>Card Number<\/th>\n<th>Card Type<\/th>\n<th>Issuing Country\/region<\/th>\n<th>Expiry Date<\/th>\n<th>CVC<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>3700 0000 0000 002<\/td>\n<td>American Express<\/td>\n<td>NL<\/td>\n<td>03\/2030<\/td>\n<td>7373<\/td>\n<\/tr>\n<tr>\n<td>3600 6666 3333 44<\/td>\n<td>Diners<\/td>\n<td>US<\/td>\n<td>03\/2030<\/td>\n<td>737<\/td>\n<\/tr>\n<tr>\n<td>6011 6011 6011 6611<\/td>\n<td>Discover<\/td>\n<td>US<\/td>\n<td>03\/2030<\/td>\n<td>737<\/td>\n<\/tr>\n<tr>\n<td>6445 6445 6445 6445<\/td>\n<td>Discover<\/td>\n<td>GB<\/td>\n<td>03\/2030<\/td>\n<td>737<\/td>\n<\/tr>\n<tr>\n<td>3569 9900 1009 5841<\/td>\n<td>JCB<\/td>\n<td>US<\/td>\n<td>03\/2030<\/td>\n<td>737<\/td>\n<\/tr>\n<tr>\n<td>2223 0000 4841 0010<\/td>\n<td>Mastercard<\/td>\n<td>NL<\/td>\n<td>03\/2030<\/td>\n<td>737<\/td>\n<\/tr>\n<tr>\n<td>4000 0200 0000 0000<\/td>\n<td>Visa<\/td>\n<td>US<\/td>\n<td>03\/2030<\/td>\n<td>737<\/td>\n<\/tr>\n<tr>\n<td>4166 6766 6766 6746<\/td>\n<td>Visa<\/td>\n<td>NL<\/td>\n<td>03\/2030<\/td>\n<td>737<\/td>\n<\/tr>\n<tr>\n<td>4001 0200 0000 0009<\/td>\n<td>Visa Electron<\/td>\n<td>BR<\/td>\n<td>03\/2030<\/td>\n<td>737<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>The following test cards do not require the CVC when entering the card details.<\/p>\n<table>\n<thead>\n<tr>\n<th>Card Number<\/th>\n<th>Card Type<\/th>\n<th>Issuing Country\/region<\/th>\n<th>Expiry Date<\/th>\n<th>CVC<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>3700 0000 0100 018<\/td>\n<td>American Express<\/td>\n<td>NL<\/td>\n<td>03\/2030<\/td>\n<td>7373<\/td>\n<\/tr>\n<tr>\n<td>3607 0500 0010 20<\/td>\n<td>Diners<\/td>\n<td>NL<\/td>\n<td>03\/2030<\/td>\n<td>737<\/td>\n<\/tr>\n<tr>\n<td>4111 1111 4555 1142<\/td>\n<td>Visa<\/td>\n<td>NL<\/td>\n<td>03\/2030<\/td>\n<td>737<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>The following details are to test China UnionPay payments.<\/p>\n<table>\n<thead>\n<tr>\n<th>Card Number<\/th>\n<th>Card Type<\/th>\n<th>Issuing Country\/region<\/th>\n<th>Expiry Date<\/th>\n<th>CVC<\/th>\n<th>SMS verification code<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>8171 9999 2766 0000<\/td>\n<td>China UnionPay<\/td>\n<td>CN<\/td>\n<td>10\/2030<\/td>\n<td>737<\/td>\n<td>Mobile: 123456 <br> Desktop: 111111<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"3d-secure\">3D Secure 2<\/h3>\n<p>The following test cards are enrolled in 3D Secure 2.<\/p>\n<table>\n<thead>\n<tr>\n<th>Card Number<\/th>\n<th>Card Type<\/th>\n<th>Issuing Country\/region<\/th>\n<th>Expiry Date<\/th>\n<th>CVC<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>3714 4963 5398 431<\/td>\n<td>American Express<\/td>\n<td>US<\/td>\n<td>03\/2030<\/td>\n<td>7373<\/td>\n<\/tr>\n<tr>\n<td>4360 0000 0100 0005<\/td>\n<td>Cartes Bancaires<\/td>\n<td>FR<\/td>\n<td>03\/2030<\/td>\n<td>737<\/td>\n<\/tr>\n<tr>\n<td>6011 1111 1111 1117<\/td>\n<td>Discover<\/td>\n<td>US<\/td>\n<td>03\/2030<\/td>\n<td>737<\/td>\n<\/tr>\n<tr>\n<td>2222 4000 1000 0008<\/td>\n<td>Mastercard<\/td>\n<td>CA<\/td>\n<td>03\/2030<\/td>\n<td>737<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n        <\/div>\n    <\/div>\n<\/div>\n\n<h2 id=\"go-live\">Go live<\/h2>\n<p>When you are ready to go live, <a href=\"\/get-started-with-adyen#apply-for-your-live-account\">apply for a live account<\/a>. If your application for a live account is approved, you <a href=\"\/get-started-with-adyen#step-4-sign-the-contract-and-get-your-live-account\">get access to the live Customer Area<\/a>.<\/p>\n<p>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 <a href=\"#set-up-payment-methods\">add payment methods to your account<\/a> in the live Customer Area.<\/p>\n<p>To take your Shopify integration live after you have configured your live Adyen account:<\/p>\n<ol>\n<li><a href=\"#disconnect-from-test-account\">Disconnect the app from your test Adyen account<\/a>.<\/li>\n<li><a href=\"#connect-to-live-account\">Set up the app for your live Adyen account<\/a>.<\/li>\n<li>Repeat the steps to <a href=\"#test-your-integration\">test your integration<\/a> for end-to-end testing.<\/li>\n<\/ol>\n<h3 id=\"disconnect-from-test-account\">Disconnect the app from your test Adyen account<\/h3>\n<ol>\n<li>In your <span translate=\"no\">Shopify<\/span> admin interface, go to <span translate=\"no\"><strong>Settings<\/strong><\/span> &gt; <span translate=\"no\"><strong>Payments<\/strong><\/span>.<\/li>\n<li>In the <span translate=\"no\"><strong>Adyen Payments - Credit Cards<\/strong><\/span> page, under <span translate=\"no\"><strong>Account status<\/strong><\/span>, select <span translate=\"no\"><strong>Manage<\/strong><\/span>.<\/li>\n<li>On the <span translate=\"no\"><strong>Adyen Payment Configuration<\/strong><\/span> page, next to <span translate=\"no\"><strong>Test Account<\/strong><\/span>, select <span translate=\"no\"><strong>Disconnect Account<\/strong><\/span>.<\/li>\n<li>Select <span translate=\"no\"><strong>Disconnect Account<\/strong><\/span> to confirm.<\/li>\n<\/ol>\n<h3 id=\"connect-to-live-account\">Set up the app for your live Adyen account<\/h3>\n<p>Repeat the following steps for live Adyen account:<\/p>\n<ol>\n<li><a href=\"#connect-your-test-adyen-account-to-your-shopify-store\">Connect the app to your Adyen account<\/a>.<\/li>\n<li><a href=\"#activate-the-app-in-your-shopify-store\">Activate the app in your Shopify store<\/a>.<\/li>\n<\/ol>\n<h2>Troubleshooting<\/h2>\n<p>If you face any issues with your integration, contact our <a href=\"https:\/\/ca-test.adyen.com\/ca\/ca\/contactUs\/support.shtml?form=other\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Support Team<\/a>, and provide the following information:<\/p>\n<ul>\n<li>Whether the issue was identified by your personnel while integrating or shoppers.<\/li>\n<li>The environment in which the issue occurs (TEST, LIVE, or both)<\/li>\n<li>Date on which the issue occurred.<\/li>\n<li>Description of the issue and its impact. For example, how often does it occur and the consequences.<\/li>\n<li>Steps to reproduce the issue.<\/li>\n<\/ul>","url":"https:\/\/docs.adyen.com\/plugins\/shopify","articleFields":{"description":"Install the Adyen payments app for Shopify and test your integration.","feedback_component":true,"last_edit_on":"24-04-2025 12:42","filters_component":false,"page_id":"66542c07-a6f3-447c-bee5-e161b3ef57f6","decision_tree":"[]","parameters":{"integrationType":"plugin","model":"direct"}},"algolia":{"url":"https:\/\/docs.adyen.com\/plugins\/shopify","title":"Shopify","content":"\n&nbsp; Read moreLearn more about the Adyen Payments App for Shopify.\n\nFollow our installation and testing guide to start accepting payments with the \n  \n    Adyen Payments - Credit Cards\n  \n, and \n  \n    Adyen - Alternative Payments\n  \n apps on your Shopify store.\nRequirements\nTo use the app, you must have set up Checkout Extensibility for Shopify.\nBefore you begin to integrate, make sure you have followed the Get started with Adyen guide to:\n\nGet an overview of the steps needed to accept live payments.\nCreate your test account.\n\nStep 1: Set up payment methods\nCheck our list of supported payment methods, and choose the payment methods that you want to offer to your shoppers.\nYou can request payment methods to be added to your merchant account in your test Customer Area or live Customer Area.\n\nIn your Customer Area, switch to your merchant account.\nGo to Payments &gt; Payment methods.\nSelect Request payment methods to view all available payment methods.\nUse the dropdown lists to filter payment methods by location and type.\nSelect the payment method(s) you want to request for your merchant account.\nSelect Add.\n\nApply the payment method(s) to This merchant account.\n\nIf prompted, fill in the required information.\nReview your requests.\nSelect Submit request.\n\nStep 2: Install the Adyen credit cards app\nRefer to Shopify documentation on Configuring third-party payment providers, and activate Adyen as your credit card payment provider with the \n  \n    Adyen Payments - Credit Cards\n  \n app.\nStep 3: Set up the credit cards app\nTo start using the Adyen payments app:\n\nConnect your test Adyen account to your Shopify store.\nActivate the app in your Shopify store.\n\nConnect your test Adyen account to your Shopify store\n\nAfter installing the app, you are redirected to the Adyen Payment Configuration page. To navigate to this page manually, go to More actions &gt; Manage.\n\nOn the Adyen Payment Configuration page, select the Adyen account you want to connect to your Shopify store:\n\nTo 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.\nTo connect your live account, in the Live Account section, select Authorize with Adyen.\n\nYou will be redirected to the Adyen Customer Area.\n\nIn the Customer Area, a Payment Service (Live Testing) window will appear, select the merchant account you want to connect to your Shopify store.\n\nYou can only have one merchant account per region, if you select multiple merchant accounts, you will receive an error and have to re-authenticate.\n\nSelect Grant access.\nYou will be redirected to the Shopify admin interface.\n\nActivate the app in your Shopify store\n\nOn the Adyen Payment Configuration page, select Activate at the top of the page.\nYou will be redirected to the Adyen Payments - Credit Cards page.\n\nOn the payment methods list, select the payment methods that you want to display to your shoppers at checkout.\n\nIf you experience issues enabling Apple Pay and Google Pay, first complete the steps to activate the app, then enable these payment methods.\n\n\nYou 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.\n\n\nUnder Test mode, select Enable test mode.\nThis setting ensures that test transactions do not attempt to charge the payment method you are use for testing. When going live, disable test mode by deselecting the checkbox.\nAt the bottom of the page, select Activate.\n\nStep 4: Install and set up the alternative payments app\nBefore you begin to set up the Adyen - Alternative Payments app, make sure that you completed the setup for the credit cards app.\nInstall the app with either of the options:\n\nFrom your Shopify admin interface:\n\nGo to Settings &gt; Payments &gt; Additional payment methods &gt; Add payment method.\nSearch for the Adyen - Alternative Payments app.\nSelect Install.\n\nFrom the Shopify App Store:  \n  \n    Adyen - Alternative Payments\n  \n\n\nAfter you have installed the Adyen Payments - Credit Cards app, you are directed to the Adyen Payment Configuration page. To set up the app:\n\nOn 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.\nWhen the sync is completed, select View payment methods to verify that all your payment methods are shown.\nGo back to the Adyen Payment Configuration page, and select Activate at the top of the page.\nYou will be redirected to the Adyen Payments - Credit Cards page.\nAt the bottom of the page, select Activate.\n\nTest your integration\nUse 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.\nWe 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.\nHappy flows\nTest the following flows to ensure your integration can handle successful payment flows.\n\n3D Secure 2 authentication flows\n\nSuccessful payment with 3D Secure 2 authentication. Use our cards enrolled in 3D Secure 2.\nSuccessful payment without 3D Secure 2 authentication.\n\nOrder without a shipping address\n\nIf you sell digital products, your integration should be able to process orders when a shopper does not provide a shipping address.\n\n\nNon-happy flows\nWe recommend to test non-happy flows to make sure that your integration can handle different scenarios.\nTo 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.\nTest the following scenarios with the cardholder name provided to ensure your integration can handle unsuccessful payment flows.\n\n\n\nTest scenario\nName on card\n\n\n\n\nFailed authentication\nNOT_3D_AUTHENTICATED\n\n\nDeclined card\nDECLINED\n\n\nExpired card\nCARD_EXPIRED\n\n\nInvalid address\nAVS_DECLINED\n\n\nIncorrect CVC\nINVALID_CARD_NUMBER\n\n\nIncorrect Pin\nINVALID_PIN\n\n\nSuspected fraud\nFRAUD\n\n\n\n\n    \n    \n        \n            \n            \n                                    Test cards\n                            \n        \n        \n            \n\n\n\nCard Number\nCard Type\nIssuing Country\/region\nExpiry Date\nCVC\n\n\n\n\n3700 0000 0000 002\nAmerican Express\nNL\n03\/2030\n7373\n\n\n3600 6666 3333 44\nDiners\nUS\n03\/2030\n737\n\n\n6011 6011 6011 6611\nDiscover\nUS\n03\/2030\n737\n\n\n6445 6445 6445 6445\nDiscover\nGB\n03\/2030\n737\n\n\n3569 9900 1009 5841\nJCB\nUS\n03\/2030\n737\n\n\n2223 0000 4841 0010\nMastercard\nNL\n03\/2030\n737\n\n\n4000 0200 0000 0000\nVisa\nUS\n03\/2030\n737\n\n\n4166 6766 6766 6746\nVisa\nNL\n03\/2030\n737\n\n\n4001 0200 0000 0009\nVisa Electron\nBR\n03\/2030\n737\n\n\n\nThe following test cards do not require the CVC when entering the card details.\n\n\n\nCard Number\nCard Type\nIssuing Country\/region\nExpiry Date\nCVC\n\n\n\n\n3700 0000 0100 018\nAmerican Express\nNL\n03\/2030\n7373\n\n\n3607 0500 0010 20\nDiners\nNL\n03\/2030\n737\n\n\n4111 1111 4555 1142\nVisa\nNL\n03\/2030\n737\n\n\n\nThe following details are to test China UnionPay payments.\n\n\n\nCard Number\nCard Type\nIssuing Country\/region\nExpiry Date\nCVC\nSMS verification code\n\n\n\n\n8171 9999 2766 0000\nChina UnionPay\nCN\n10\/2030\n737\nMobile: 123456  Desktop: 111111\n\n\n\n3D Secure 2\nThe following test cards are enrolled in 3D Secure 2.\n\n\n\nCard Number\nCard Type\nIssuing Country\/region\nExpiry Date\nCVC\n\n\n\n\n3714 4963 5398 431\nAmerican Express\nUS\n03\/2030\n7373\n\n\n4360 0000 0100 0005\nCartes Bancaires\nFR\n03\/2030\n737\n\n\n6011 1111 1111 1117\nDiscover\nUS\n03\/2030\n737\n\n\n2222 4000 1000 0008\nMastercard\nCA\n03\/2030\n737\n\n\n\n\n        \n    \n\n\nGo live\nWhen 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.\nTo 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.\nTo take your Shopify integration live after you have configured your live Adyen account:\n\nDisconnect the app from your test Adyen account.\nSet up the app for your live Adyen account.\nRepeat the steps to test your integration for end-to-end testing.\n\nDisconnect the app from your test Adyen account\n\nIn your Shopify admin interface, go to Settings &gt; Payments.\nIn the Adyen Payments - Credit Cards page, under Account status, select Manage.\nOn the Adyen Payment Configuration page, next to Test Account, select Disconnect Account.\nSelect Disconnect Account to confirm.\n\nSet up the app for your live Adyen account\nRepeat the following steps for live Adyen account:\n\nConnect the app to your Adyen account.\nActivate the app in your Shopify store.\n\nTroubleshooting\nIf you face any issues with your integration, contact our Support Team, and provide the following information:\n\nWhether the issue was identified by your personnel while integrating or shoppers.\nThe environment in which the issue occurs (TEST, LIVE, or both)\nDate on which the issue occurred.\nDescription of the issue and its impact. For example, how often does it occur and the consequences.\nSteps to reproduce the issue.\n","type":"page","locale":"en","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Plugins","lvl2":"Shopify"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/plugins","lvl2":"\/plugins\/shopify"},"levels":3,"category":"Plugins","category_color":"green","tags":["Shopify"]},"articleFiles":{"shopify.svg":"<img style=\"width: 38px;\" alt=\"\" src=\"https:\/\/docs.adyen.com\/user\/pages\/docs\/05.plugins\/27.shopify\/shopify.svg?decoding=auto&amp;fetchpriority=auto\" \/>"}}