En VTEX, es posible integrarse con el proveedor de pago Adyen. A través de este conector, su tienda puede ofrecer transacciones de pago en tiendas físicas (VTEX Sales App), utilizando puntos de venta (POS). Para más información acceda ¿Qué es VTEX Sales App?.

Para utilizar la afiliación AdyenV3 en su tienda a través de otros canales de venta en línea (excepto VTEX Sales App), visite Configurar pagos con AdyenV3.

Para utilizar la afiliación AdyenV3 en la VTEX Sales App, es necesario:

• Configurar punto de venda (POS)
• Configurar el entorno Adyen
• Configurar el conector AdyenV3 (VTEX Sales App) en VTEX
• Configurar condición de pago

La configuración realizada en un entorno externo a VTEX puede interrumpirse o modificarse sin previo aviso. Consulta tu cuenta Adyen para obtener información actualizada.

El primer paso es configurar sus cuentas Adyen y VTEX para permitir transacciones de pago en el punto de venta (POS). Para realizar estos ajustes acceda a la siguiente documentación:

• Adyen - Terminal API go-live checklist
• VTEX - VTEX Sales App Configuración básica

Los pasos a continuación describen los ajustes mínimos que necesita el conector Adyen para configurarse correctamente. Otras configuraciones personalizadas aplicadas a los clientes, así como la habilitación de medios de pago específicos o funcionalidades específicas de la plataforma, deben realizarse según la documentación de Adyen.

Para habilitar el acceso de VTEX en el entorno Adyen, sigue los pasos a continuación:

1. Accede a tu Área de Cliente en Adyen.
2. En la barra lateral izquierda, copia y guarda la información descrita antes de Company. Esta es tu Company Account.
3. En la lista de abajo, busca el nombre de la Merchant Account a utilizar (resaltada en blanco). Copia y guarda esta información.

Esta información hace referencia a los endpoints utilizados por las API de terminales de Adyen en un entorno productivo. Para obtener más información, vaya a documentación Adyen.

1. En la barra lateral, accede a Developers > API URLs.
2. Haz clic en Copy en el campo Prefix y anota la información guardada en un lugar seguro. Este prefijo controla su terminal en la plataforma Adyen.

La información a continuación supone que la API Key se ha generado previamente en el entorno de Adyen. En caso de que necesites crearlas, consulta la documentación de Adyen.

1. Haz clic en Developers en la barra lateral y luego e API credentials.
2. Selecciona tu credencial API.
3. En Server Settings > Authentication, selecciona API key.

La configuración del webhook es necesaria para que Adyen envíe actualizaciones del status del pago a tu cuenta VTEX. Para más información, visita la documentación de Webhooks de Adyen.

Configura el webhook según los pasos a continuación:

1. En tu Área de Cliente en Adyen, accede a Developers > Webhooks.
2. Haz clic en el botón azul + Webhook.
3. Selecciona la opción Standard Webhook haciendo clic en el botón Add.
4. En General > Description, agrega una descripción para el nuevo webhook. Ejemplo: "Webhook Adyen Connector Provider v3".
5. En General > Server configuration > URL, introduce la URL de tu cuenta VTEX. Ejemplo https://{{account}}.myvtex.com/_v3/api/webhook/notification.

Si tienes varias tiendas, es necesario configurar el webhook para cada una de ellas.

1. En el Admin VTEX, accede a Configuración de la tienda > Pago > Proveedores, o escribe Proveedores en la barra de búsqueda en la parte superior de la página.
2. En la pantalla de proveedores, haga clic en el botón Nuevo proveedor.
3. Escriba el nombre AdyenV3 en la barra de búsqueda y haga clic en el nombre del proveedor.
4. En Clave de aplicación, el nombre de tu Adyen Merchant Account (paso 3 de la sección Obtener las credenciales Company y Merchant Account.
5. En Token de aplicación, ingrese la clave API (paso 4 de la sección Obtener la API Key).
6. Si desea modificar el nombre de identificación que se mostrará para el proveedor AdyenV3 en la pantalla VTEX Admin, ingrese la información en el campo Nombre en Información general.
7. En Control de pago, seleccione si desea activar el proveedor en un entorno de prueba haciendo clic en Activar modo de prueba.
8. En Live URL prefix, complete el prefijo disponible en el área de clientes de Adyen (paso 2 de la sección Obtener la Live URL prefix).
9. En Company account, ingrese el nombre de tu company account (paso 2 de la sección Obtener las credenciales Company y Merchant Account).
10. En Live POS URL, complete los endpoints utilizados para acceder a las API de terminales de Adyen. Obtenga más información en [documentación de Adyen] (https://docs.adyen.com/point-of-sale/design-your-integration/terminal-api#cloud).
11. No es necesario rellenar el campo Client key, ya que sólo es aplicable a otro tipo de canales de venta online.
12. En Auto Capture Settings, seleccione cuándo desea capturar el pago.
13. Haga clic en Guardar.

1. En el Admin VTEX, accede a Configuración de la tienda > Pago > Configuración, o escribe Configuración en la barra de búsqueda en la parte superior de la página.
2. En la pestana Condiciones de pago, haga clic en el botón +.
3. Haga clic en Venda Direta Debito o Venda Direta Credito.
4. En Procesar con proveedor, seleccione el conector previamente configurado.
5. Active la condición en el campo Status.
6. Si desea utilizar un sistema antifraude, seleccione la opción Utilizar antifraude.
7. Si desea, puede configurar condiciones especiales de pago.
8. Haga clic en Guardar.

Tras seguir los pasos indicados, el conector AdyenV3 puede tardar hasta 10 minutos para aparecer como opción de pago en la App Ventas VTEX de su tienda.