adyen

Adyen necesita realizar un trabajo en el panel del proveedor: la mayor parte de lo que Athia consume llega como archivos de informe programados, por lo que esos informes deben existir primero. Hazlo y Adyen se convertirá en la mejor fuente de información para la liquidación y los costes.

Lo que obtienes#

Detalle de la liquidación y liquidación agregada, contabilidad de pagos, detalles de pagos recibidos, detalles de tarifas de intercambio y de esquema, detalles de transacción de disputa y resultados de autenticación 3D Secure.

Lo más potente para la liquidación y los detalles de las tarifas. Adyen separa lo que se ha liquidado de lo que ha costado a un nivel que la mayoría de los proveedores no exponen, lo que lo convierte en la fuente de referencia para el coste por pedido aprobado.

Lo menos potente para el contexto de suscripción, que es escaso aquí: esa información proviene de otra parte.

Antes de empezar#

1. Habilita y programa los informes. Selecciona la cuenta de comerciante del menú desplegable de la parte superior izquierda → Informes en la barra de navegación izquierda → busca y configura cada informe → haz clic Generar → selecciona Automático (generar según programación) → elige .CSV como Tipo de archivo→ Configura todo esto:

• Autenticación 3D Secure
• Autenticación 3DS
• Detalles de liquidación agregados
• Detalles de transacción de disputa
• Tarifas de intercambio y de esquema
• Contabilidad de pagos
• Detalles de pagos recibidos
• Detalles de liquidación

Automatiza estos informes en la cuenta de empresa y también a nivel de cuenta de comerciante — la programación solo de la cuenta de comerciante no produce los informes a nivel de empresa.

Después de la primera cuenta de comerciante, marca (resalta) los informes para que el resto se programe más rápido.

2. Crea el usuario de servicio de informes. Ve a la vista a nivel de empresa, crea el credencial y selecciona Usuario de servicio de informes como Tipo de credencial→ Copia el Nombre de usuario de Configuración general, luego genera la Contraseña bajo Configuración del servidor → Autenticación básica→ Asocia el credencial con la cuenta de empresa y todas las cuentas de comerciante que desees en Athia: un credencial con ámbito a una sola cuenta, silenciosamente excluye a las demás.

3. Crea el credencial de la API Web. En el Área de Cliente de Adyen a nivel de empresa, ve a Desarrolladores → Credenciales de API y crea un credencial de API, luego genera y copia su Clave de API.

4. Asigna los roles al credencial de la API Web. Crearlo no es suficiente. Bajo Permisos → Roles, otorga Management API - Accounts read y Management API - Webhooks read and write→ Bajo Cuentas, asócialo con la cuenta de empresa y todas las cuentas de comerciante.

Credenciales que Athia solicita#

Configuración de la conexión#

1. En Configuración → Conexiones, seleccione + Agregar Conexión y seleccione adyen.
2. En Configurar Conector, introduzca Nombre y elija Programación.
3. En Ingrese Credenciales, pegue Clave de API del Servicio Web y Clave de API del Servicio de Informes.
4. Seleccione Verifique la Conexión.

La conexión ahora muestra como ACTIVE y comienza la primera sincronización.

Para MIDs adicionales, reutilice las mismas credenciales: no se necesitan cambios adicionales en Adyen si los informes ya están configurados para esas MIDs.

Registre el webhook de Athia en Adyen#

Copie la URL de destino del Webhook de Athia del asistente de conexión, luego en Adyen:

1. Vaya a Desarrolladores → Webhooks → Crear nuevo webhook → Notificación estándar → Agregar.
2. Abra Editar la configuración del servidor y pegue URL de destino del Webhook de Athia.
3. Bajo Cuentas de comerciantes, seleccione las MIDs: deben coincidir con las MIDs para las que ha configurado informes.
4. Bajo Configuración Adicional, habilite 3D seguro (incluya el resultado y la versión de 3D Secure), Adquirente (añada el resultado y la referencia del adquirente) y Tarjeta (incluya el BIN de la tarjeta y la información detallada del BIN de la tarjeta).
5. Pruebe el webhook, guárdelo, luego actívelo.

Los eventos de informes a nivel de empresa aún requieren la solicitud de soporte de Adyen en la parte superior de esta página.

Cadencia de sincronización#

Su Programación determina con qué frecuencia Athia busca nuevos archivos de informe, no con qué rapidez los produce Adyen. Los datos de liquidación solo avanzan cuando Adyen cierra un lote.

Límites y cosas que saber#

• Depende del informe. Si un informe no está habilitado en Adyen, o está configurado como manual, esos datos nunca llegan a Athia, y la verificación puede tener éxito mientras un dominio permanece vacío.
• Los montos son decimales — nunca divida por 100, a diferencia de Stripe.
• Los datos de la tarjeta están minimizados. Para lo que cada campo ingestado contiene, consulte Diccionario de datos de Athia.
• El alcance histórico está limitado por el número de informes que devuelve Adyen, por lo que los períodos muy antiguos pueden no ser accesibles y deben regenerarse en Adyen primero: en el área del cliente, vaya a Informes → seleccione informe → rango de fechas personalizado. Confirme el alcance anterior antes de comprometerse con una ventana de retroceso.

Resolución de problemas#

Relacionado#

• Conectores de Athia — el catálogo completo de conectores.
• Integración con Athia — rutas de integración, incluyendo la transferencia de archivos y entre almacenes.
• Diccionario de datos de Athia — definiciones a nivel de campo.