Checkout.com
Conecte Checkout.com a Athia, configure el acceso del proveedor necesario y verifique la primera sincronización de datos exitosa.
En esta página
Checkout.com Lo que obtiene
Lo que obtienes#
Pagos y sus acciones con resultados, disputas, pagos y detalles de conciliación que cubren las tarifas y el tipo de cambio. Las definiciones a nivel de campo se encuentran en Diccionario de datos de Athia.
Es la más completa para la descomposición de tarifas. De todos los proveedores de tarjetas, Checkout.com desglosa los costos de la manera más completa: tarifas de intercambio, tarifas de la red, tarifas del gateway, tarifas de token de red, tarifas de chargeback y el tipo de cambio, todo llega por separado, lo que permite obtener el costo real por cada pedido aprobado, en lugar de una estimación.
Es la menos consistente en unidades. Antes de comenzar
Antes de empezar#
1. Habilite los informes de conciliación en el Checkout.com lado. Hasta que estén habilitados, los datos de costos no aparecerán, independientemente de cómo se configure la credencial.
2. Cree la pareja de claves de acceso. En el Hub, vaya a Desarrolladores → Claves → Crear una nueva clave. La credencial es un Access key ID más una secreto de clave de acceso; Athia necesita ambas.
3. Seleccione los ámbitos personalizados y el conjunto completo de ámbitos. Habilite, como mínimo, las gateway, vault y reports familias de ámbitos. gateway:payment-details (detalles de pago y acción) y reports:read (informes de conciliación) deben incluirse, pero no es una lista completa: esta combinación no cubre los datos de saldo, pago y acción financiera que ingiere Athia, y un conjunto de ámbitos limitado produce errores HTTP 401 en lugar de datos incompletos.
4. Seleccione la entidad que cubre la clave. El ID de entidad es lo que diferencia la conexión de una entidad de otra.
5. Elija el entorno explícitamente. un Cuenta de prueba se corresponde con Caja de arena; un En vivo se corresponde con Producción. Una clave del entorno incorrecto verifica y luego no proporciona ninguna información reconocible.
Credenciales que Athia solicita#
| campo | Requerido | Qué es / dónde encontrarlo |
|---|---|---|
| Nombre | Sí | Programa |
| Programación | No | Con qué frecuencia Athia realiza consultas Checkout.com |
| ID de clave de acceso | La | El Access key ID del par creado en Desarrolladores → Claves |
| Secreta clave de acceso | Sí | La entidad secreto de clave de acceso |
| ID de entidad | La | El Checkout.com Configurar la conexión |
Configuración de la conexión#
- Habilitar informes de conciliación, configurar Permite que cualquier canal de procesamiento funcione ONy crear el par de claves de acceso con Alcances personalizados y el conjunto de alcance completo, para la entidad y el entorno correctos.
- En Configuración → Conexiones+ Agregar conexión + Agregar Conexión y seleccione ON.
- Configurar conector , introduzca un, introduzca y seleccione Programa ON.
- Introducir credenciales , introduzca, introducir ID de clave de acceso, Secreta clave de acceso y Seleccionar.
- Verificar conexión La conexión muestra entonces.
La conexión ahora muestra como ACTIVE y comienza la primera sincronización. Si opera con varias entidades, cree una conexión por entidad: ID de entidad es lo que las diferencia.
Registrar el webhook de Athia#
Los eventos de pago y de disputa llegan a Athia en tiempo real a través de un Checkout.com workflow.
- URL de destino del webhook de Athia URL de destino del Webhook de Athia.
- En el Hub, vaya a Configuración → Flujos de trabajo → Crear flujo de trabajo.
- Seleccione los eventos
payment_captured,payment_approvedydispute_created. - Añadir gancho web URL de destino del webhook de Athia URL de destino del Webhook de Athia.
- Configure el encabezado de firma, luego pruebe, guarde y habilite el flujo de trabajo.
Cadencia de sincronización#
Esta conexión tiene dos relojes: los detalles de pago se actualizan a medida que se realizan las transacciones, mientras que los informes de conciliación siguen Checkout.comun ciclo de informes más lento. Los datos de costos no serán más recientes que ese ciclo, independientemente del horario que elija.
Límites y cosas que saber#
- Unidades de importe mixto. Los montos de la API de pagos son unidades menores (divididos entre 100); los montos del informe de conciliación son decimales. Athia normaliza al recibir, pero verifique de dónde proviene un dato antes de concluir que es incorrecto.
- Los informes deben estar habilitados primero, de lo contrario, no se puede descomponer la tarifa que es lo que este conector hace mejor.
- Se necesita el conjunto completo. Cree la clave con Alcances personalizados que cubra al menos las
gateway,vaultyreportsfamilies.gateway:payment-detailsyreports:readSolo no cubren los datos de saldo, pago y acción financiera, y un conjunto de alcance limitado devuelve HTTP401en lugar de datos parciales. - Los datos de la tarjeta están minimizados.
Resolución de problemas#
| Lo que ve | Causa probable | Qué hacer |
|---|---|---|
| Los pagos llegan, pero no hay detalles de tarifa ni de intercambio | Los informes no están habilitados, o reports:read faltan | Habilite los informes, confirme el conjunto de alcance, vuelva a conectar |
HTTP 401 durante la verificación o la sincronización | Clave creada con un conjunto de alcance limitado | Cree la clave de nuevo con Alcances personalizados y el conjunto completo gateway, vault y reports familias |
| Algunos pagos nunca llegan, no hay errores reportados | Permite que cualquier canal de procesamiento dejar | Esté configurado en ON en la sección de la Canal de procesamiento clave, luego vuelva a conectar |
| La conexión verifica, pero transmite datos no reconocidos | Clave del entorno incorrecto | Utilice una clave de cuenta de prueba para Sandbox y una clave de cuenta de producción para Production |
| No hay eventos de pago o disputa en tiempo real | Flujo de trabajo faltante, deshabilitado o encabezado de firma no configurado | Cree el flujo de trabajo bajo Configuración → Flujos de trabajoURL de destino del webhook de Athia URL de destino del Webhook de Athiay verifique el encabezado de firma |
Relacionado#
Otros proveedores y rutas de ingestión se enumeran en . Para las caídas de archivos y alternativas de almacén a almacén a un conector directo, consulteIntegrando Athia Integración de Athia.