Shopify

Follow our installation and testing guide to start accepting payments with the Adyen Payments - Credit Cards , and Adyen - Alternative Payments apps on your Shopify store.

Requirements

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: Set up payment methods

Check our list of supported payment methods, and choose the payment methods that you want to offer to your shoppers.

Add the payment methods that you want to enable in your Adyen Customer Area:

1. 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.

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.

Step 2: Install the Adyen credit cards app

Refer to Shopify documentation on Configuring third-party payment providers, and activate Adyen as your credit card payment provider with the Adyen Payments - Credit Cards 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.
2. 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.
   • 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.

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, 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.

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

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 displayed.
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 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.

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. Set up the app for your live Adyen account.
3. 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. 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.
2. Activate the app in your Shopify store.

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.