At VTEX, it is possible to integrate with the payment provider Adyen. Through this connector, your store can offer payment transactions in physical stores (VTEX Sales App), using points of sale (POS). For more information access What is VTEX Sales App?.

To use the AdyenV3 affiliation in your store through other online sales channels (except VTEX Sales App), visit Configuring payment with AdyenV3.

To use the AdyenV3 affiliation in the VTEX Sales App, you need to:

• Configure point of sale (POS)
• Configure your Adyen environment
• Configure AdyenV3 Connector (VTEX Sales App) on VTEX
• Configure payment condition

Settings configured in an environment external to VTEX may be discontinued or modified without prior notice. Please check your Adyen account for the latest information.

The first step is to configure your Adyen and VTEX accounts to allow point-of-sale (POS) payment transactions. To perform these settings, access the following documentation:

• Adyen - Terminal API go-live checklist
• VTEX - VTEX Sales App Basic settings

The steps described below are the minimum required settings for configuring the Adyen connector correctly. Client customizations or enabling specific payment methods or platform features have to be done following the Adyen documentation.

To enable VTEX access to the Adyen environment, follow the instructions below:

1. Log in to your Customer Area on Adyen.
2. In the left sidebar, copy and save the information shown above Company. This is your Company account.
3. In the list below Company, search for the Merchant Account that will be used (highlighted in white). Copy and save this information.

This information is related to the endpoints used by Adyen's endpoint APIs in a production environment. For more information, visit the Adyen docs.

1. In the sidebar, go to Developers > API URLs.
2. Click Copy in the Prefix field, and store the information in a safe place. This prefix controls your endpoint on the Adyen platform.

The steps below assume that the API Key has been previously generated in the Adyen environment. If you need to create them, see the Adyen documentation.

1. In the sidebar, click Developers and, then, click API credentials.
2. Select your API credential.
3. In Server Settings > Authentication, select API key.

You need to configure a webhook to allow Adyen to send payment status updates to your VTEX account. For more information, see the Adyen Webhooks documentation.

Follow the steps below to configure a webhook:

1. In your Customer Area on Adyen, go to Developers > Webhooks.
2. Click the blue + Webhook button.
3. In the Standard Webhook option, click Add.
4. In General > Description, add a description for the new webhook. Example: "Webhook Adyen Connector Provider v3".
5. In General > Server configuration > URL, enter the URL of your VTEX account. Example: https://{{account}}.myvtex.com/_v3/api/webhook/notification.

If you have several stores, you need to configure a webhook for each of them.

1. In the VTEX Admin, go to Store Settings > Payments > Providers, or type Providers in the search bar at the top of the page.
2. On the providers screen, click the New Provider button.
3. Type the name AdyenV3 in the search bar and click on the name of the provider.
4. In Application Key, fill in the name of your Merchant account (step 3 in the Getting the Company and Merchant account credentials section).
5. In Application Token, fill in the API Key (step 4 in the Getting the API Key section).
6. If you wish to modify the identification name to be displayed for the AdyenV3 provider on the VTEX Admin screen, enter the information in the Name field in Basic Information.
7. In Payment Control, select whether you want to activate the provider in a test environment by clicking Enable test mode.
8. In Live URL prefix, fill in the prefix available in Adyen customer area (step 2 in the Getting the Live URL prefix section).
9. In Company account, enter the name of your Company account (step 2 in the Getting the Company and Merchant account credentials section).
10. In Live POS URL, fill in endpoints used to access Adyen terminal APIs. Learn more at Adyen documentation.
11. The Client Key field is not necessary to fill in, as it is only applicable to other types of online sales channels.
12. In Auto Capture Settings, select when you want to capture the payment.
13. Click Save.

1. In the VTEX Admin, go to Store Settings > Payments > Settings, or type Settings in the search bar at the top of the page.
2. In the Payment Conditions tab, click on the + button.
3. Click on Venda Direta Debito or Venda Direta Credito.
4. Under Process with affiliation, select the previously configured connector.
5. Activate the condition in the Status field.
6. If you want to use an anti-fraud system, select the option Use anti-fraud solution.
7. If you want, you can also configure special payment conditions.
8. Click on Save.

After completing these steps, the AdyenV3 Connector may take up to 10 minutes to appear as a payment option in your store's VTEX Sales App.