{"section":"tutorials","requestedLocale":"en","requestedSlug":"configuring-payment-with-adyenv3-in-vtex-sales-app","locale":"en","slug":"configuring-payment-with-adyenv3-in-vtex-sales-app","path":"docs/en/tutorials/payments/payment-settings/configuring-payment-with-adyenv3-in-vtex-sales-app.md","branch":"main","content":"At VTEX, it is possible to integrate with the payment provider Adyen. Through this connector, your store can offer payment transactions in physical stores via **VTEX Sales App**, using points of sale (POS). For more information access [What is VTEX Sales App?](https://help.vtex.com/docs/tracks/vtex-sales-app-getting-started-and-setting-up).\n\n> ℹ️ To use the AdyenV3 affiliation in your store through other online sales channels (except **VTEX Sales App**), visit [Configuring payment with AdyenV3](https://developers.vtex.com/docs/apps/adyen.payment-provider-v3).\n\nTo use the AdyenV3 affiliation in the **VTEX Sales App**, you need to:\n\n- [Configure point of sale (POS)](#configuring-point-of-sale-pos)\n- [Configure your Adyen environment](#configuring-your-adyen-environment)\n- [Configure AdyenV3 Connector (VTEX Sales App) on VTEX](#configuring-adyenv3-connector-vtex-sales-app-on-vtex)\n- [Configure payment condition](#configuring-payment-condition)\n\n> ⚠️ 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.\n\n## Configuring point of sale (POS)\n\nThe 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:\n\n- [Adyen - Terminal API go-live checklist](https://docs.adyen.com/point-of-sale/get-started/go-live-tapi)\n- [VTEX - VTEX Sales App Basic settings](https://help.vtex.com/docs/tracks/vtex-sales-app-basic-settings)\n\n## Configuring your Adyen environment\n\nThe 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](https://docs.adyen.com/) documentation.\n\nTo enable VTEX access to the Adyen environment, follow the instructions below:\n\n### Getting the Company and Merchant account credentials\n\n1. Log in to your [Customer Area](https://ca-test.adyen.com/) on Adyen.\n2. In the left sidebar, copy and save the information shown above **Company**. This is your Company account.\n3. In the list below Company, search for the Merchant Account that will be used (highlighted in white). Copy and save this information.\n\n    ![Adyenv3_1](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/payments/payment-settings/configuring-payment-with-adyenv3-in-vtex-sales-app_1.PNG)\n\n### Getting the POS Live URL\n\nThis information is related to the endpoints used by Adyen's endpoint APIs in a production environment. For more information, visit the [Adyen docs](https://docs.adyen.com/point-of-sale/design-your-integration/terminal-api#cloud).\n\n### Getting the Live URL prefix\n\n1. In the sidebar, go to **Developers > API URLs**.\n2. Click `Copy` in the **Prefix** field, and store the information in a safe place. This prefix controls your endpoint on the Adyen platform.\n\n### Getting the API Key\n\nThe steps below assume that the API Key has been previously generated in the Adyen environment. If you need to create them, see the [Adyen](https://docs.adyen.com/) documentation.\n\n1. In the sidebar, click **Developers** and, then, click **API credentials**.\n2. Select your API credential.\n3. In **Server Settings > Authentication**, select **API key**.\n\n    ![Adyenv3_2](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/payments/payment-settings/configuring-payment-with-adyenv3-in-vtex-sales-app_2.PNG)\n\n4. Click **Generate key** and store the generated key in a safe location.\n\n### Configuring a webhook\n\nYou need to configure a webhook to allow Adyen to send payment status updates to your VTEX account. For more information, see the Adyen [Webhooks](https://docs.adyen.com/development-resources/webhooks) documentation.\n\nFollow the steps below to configure a webhook:\n\n1. In your [Customer Area](https://ca-test.adyen.com/) on Adyen, go to  **Developers > Webhooks**.\n2. Click the blue `+ Webhook` button.\n3. In the **Standard Webhook** option, click **Add**.\n4. In **General > Description**, add a description for the new webhook. Example: \"Webhook Adyen Connector Provider v3\".\n5. In **General > Server configuration > URL**, enter the URL of your VTEX account. Example: https://\\{\\{account\\}\\}.myvtex.com/_v3/api/webhook/notification.\n\n    ![Adyenv3_4](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/payments/payment-settings/configuring-payment-with-adyenv3-in-vtex-sales-app_3.PNG)\n\n6. Click **Apply**.\n7. In **Additional settings**, select all the available options, and click **Apply** in each tab.\n8. Click **Save changes**.\n\n![Adyenv3_5](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/payments/payment-settings/configuring-payment-with-adyenv3-in-vtex-sales-app_4.PNG)\n\n![Adyenv3_6](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/payments/payment-settings/configuring-payment-with-adyenv3-in-vtex-sales-app_5.PNG)\n\n![Adyenv3_7](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/payments/payment-settings/configuring-payment-with-adyenv3-in-vtex-sales-app_6.PNG)\n\n> ℹ️ If you have several stores, you need to configure a webhook for each of them.\n\n## Configuring AdyenV3 Connector (VTEX Sales App) on VTEX\n\n1. In the VTEX Admin, go to **Store Settings > Payments > Providers**, or type **Providers** in the search bar at the top of the page.\n2. On the providers screen, click the `New Provider` button.\n3. Type the name **AdyenV3** in the search bar and click on the name of the provider.\n4. In **Application Key**, fill in the name of your Merchant account (step 3 in the [Getting the Company and Merchant account credentials](#getting-the-company-and-merchant-account-credentials) section).\n5. In **Application Token**, fill in the API Key (step 4 in the [Getting the API Key](#getting-the-api-key) section).\n6. 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**.\n7. In **Payment Control**, select whether you want to activate the provider in a test environment by clicking **Enable test mode**.\n8. In **Live URL prefix**, fill in the prefix available in Adyen customer area (step 2 in the [Getting the Live URL prefix](#getting-the-live-url-prefix) section).\n9. In **Company account**, enter the name of your Company account (step 2 in the [Getting the Company and Merchant account credentials](#getting-the-company-and-merchant-account-credentials) section).\n10. In **Live POS URL**, fill in endpoints used to access Adyen terminal APIs. Learn more at [Adyen documentation](https://docs.adyen.com/point-of-sale/design-your-integration/terminal-api#cloud).\n11. The **Client Key** field is not necessary to fill in, as it is only applicable to other types of online sales channels.\n12. In **Auto Capture Settings**, select when you want to capture the payment.\n13. Click `Save`.\n\n## Configuring payment condition\n\n1. In the VTEX Admin, go to **Store Settings > Payments > Settings**, or type **Settings** in the search bar at the top of the page.\n2. In the **Payment Conditions** tab, click on the `+` button.\n3. Click on **Venda Direta Debito** or **Venda Direta Credito**.\n4. Under **Process with affiliation**, select the previously configured connector.\n5. Activate the condition in the **Status** field.\n6. If you want to use an anti-fraud system, select the option **Use anti-fraud solution**.\n7. If you want, you can also [configure special payment conditions](/en/docs/tutorials/special-conditions).\n8. Click on `Save`.\n\nAfter 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**."}