Configurando el proveedor

Después de completar todos los pasos enumerados en la sección Configuración de Adyen, debe tener toda la información necesaria para activar Adyen V3 como proveedor de pago en VTEX.

El módulo Pagos VTEX permite que varios proveedores de pago (gateways, adquirentes, subadquirentes, orquestadores, PSPs, entre otros) sean configurados en su tienda. De esta manera, puede ofrecer diferentes métodos y condiciones de pago a sus clientes.

Cuando se realiza una compra en su tienda y el cliente efectúa el pago, la transmisión de datos entre VTEX y el proveedor elegido tiene lugar a través de protocolos de comunicación configurados en Admin VTEX.

El proveedor del pago es responsable de procesar el pago y devolver el resultado a VTEX. El proveedor de pagos también puede ser responsable del análisis antifraude de la transacción.

Asegúrese de tener los permisos y detalles necesarios de la pasarela de pago de Adyen. Para registrar la afiliación de la pasarela Adyen en VTEX, siga los siguientes pasos:

1. Ir a la página de administración de la tienda https://{{account}}.myvtex.com/admin/.

2. En VTEX Admin, ve a Configuración de la tienda > Pagos > Proveedores o escribe Proveedores en la barra de búsqueda en la parte superior de la página.

3. En la pantalla de proveedores, haga clic en el botón Nuevo proveedor.

4. Busca Adyen.

5. Seleccione AdyenV3 de la lista de proveedores de pago disponibles.

6. En el campo Clave de aplicación (nombre de su cuenta comercial), complete el nombre de su cuenta comercial que obtuvo en el paso Obtención de credenciales de la cuenta comercial y de la empresa.

7. En el campo Token de la Aplicación (clave de API), pegue la clave de API generada en el paso Clave de API.

8. Opcionalmente, defina un nombre de identificación rellenando el campo Nombre en Información básica.

9. En Payment Control, si su tienda aún no está en producción y está realizando pruebas, puede marcar Enable test mode.

10. También en Payment Control, marque Trust the provider's anti-fraud analysis. Esto evita un segundo análisis antifraude cuando Adyen ya aprobó el pago. Consulte Antifraude Nativo.

11. El Sandbox Mode permite alternar entre el entorno live (producción) y el entorno de prueba (sandbox) del conector Adyen. Está diseñado para validar integraciones, simular transacciones y asegurar que la configuración del flujo de pago sea correcta antes de salir a producción.

12. En el campo Live URL prefix, rellene el prefijo de la URL que obtuvo en la sección URL Live.

    Nota: Este campo debe rellenarse solo para entornos de producción. Para pruebas, debe dejarse en blanco.

13. En el campo Company account, ingrese el nombre de la cuenta de la empresa según lo definido en Adyen, el que guardó en el paso Obteniendo credenciales de la cuenta de la empresa y del comerciante.

14. El campo Live POS URL se usa solo para Sales APP.

15. En el campo Client key, rellene la clave del cliente que obtuvo en el paso 6 de la sección Clave de API.

16. En el campo HMAC Key, pega la clave HMAC generada en Adyen. Consulta Firma HMAC para los pasos completos de configuración.

17. En Auto Capture Settings y POS Auto Capture Settings, configure el momento de la captura (captura automática inmediatamente después de la autorización o liquidación automática con retraso). Para los métodos de pago que admiten capturas separadas, el conector siempre envía las transacciones a Adyen como captura manual (solo autorización), no según el Área de Cliente de Adyen. Para más detalles, ejemplos y métodos de pago que no se ven afectados, consulte Captura manual.

18. En Boleto Expiration Days, defina el número de días hasta que el boleto expire. Consulte Configurar los días de expiración del boleto.

19. En QR code expiration time to PIX (in minutes), defina cuánto tiempo permanece válido el código QR de Pix (mínimo 10, máximo 60; por defecto 10). Consulte las Reglas Específicas en Pix.

20. En 3DS Authentication Type, elija cómo se solicita la autenticación 3DS:

    • Adyen Dynamic 3DS rules (default): El conector no modifica nada; sus reglas de Dynamic 3D Secure en el Área de Cliente de Adyen deciden si cada pago se autentica. La autenticación exitosa transfiere la responsabilidad (liability shift) al emisor. Esta opción se llamaba anteriormente "Full 3DS Authentication". Las configuraciones ya guardadas siguen funcionando sin cambios.
    • Always request 3DS: Solicita la autenticación 3DS en todos los pagos con tarjeta, independientemente de sus reglas de Dynamic 3D Secure. Maximiza el liability shift, pero agrega fricción, lo que puede reducir la conversión.
    • Disabled (no 3DS): Nunca solicita autenticación 3DS, para ninguna tarjeta (crédito o débito). No hay liability shift: los contracargos por fraude quedan con el comerciante. Los emisores de mercados donde la autenticación es obligatoria (p. ej., PSD2/SCA en el EEE, tarjetas de débito en Brasil) pueden rechazar estos pagos.
    • Data Only (Currency BRL): Envía datos de riesgo al emisor sin requerir interacción del cliente. Permitido solo para transacciones con tarjeta de crédito en BRL (real brasileño); cualquier otro pago vuelve a seguir las Adyen Dynamic 3DS rules. Como no hay autenticación activa del comprador, la responsabilidad por transacciones fraudulentas puede permanecer con el comerciante.

21. En el campo Origin URL, introduzca la URL final de su tienda (p. ej., https://tienda.com.mx).

    • La URL debe ser el dominio final, sin subdirectorios y sin barra (/) al final.
    • Este campo es obligatorio para el procesamiento de transacciones 3DS en el canal Web.
    • No use el dominio .myvtex.com para producción.
    • Límite de caracteres: 80 caracteres.

    Importante: Para validar 3DS en un workspace de desarrollo (p. ej., https://homolog--tienda.myvtex.com), informe la URL del workspace en el campo Origin URL y también registre esta URL en el panel de Adyen, tal como se describe en el paso de Configuraciones Adicionales.

22. En Custom POS Terminal Selector App, puede habilitar el selector de terminal basado en código QR. Viene Disabled por defecto. Consulte Custom POS Terminal Selector App.

23. Payment Tokenization (BETA): La tokenización de pagos con Adyen está en desarrollo. Si le interesa participar en el programa de pruebas beta y tener acceso anticipado a esta funcionalidad, contáctenos por correo electrónico: suporte.adyen@wppcommerce.com.br.

24. Haga clic en Guardar.

Para más información sobre los datos a rellenar, consulte la documentación de Credenciales API de Adyen.

Si necesitas ayuda extra, revisa los pasos descritos en el tutorial de VTEX o en la Ruta de pagos de VTEX