Checkout.com

Checkout.com es una conexión de autoservicio y la fuente de costos más completa del catálogo. Obtiene información de pago del gateway y informes de conciliación que descomponen el costo real de cada transacción. Habilite primero los informes, de lo contrario, obtendrá solo la información de pago y no la información de costos.

Lo que obtiene#

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. Los pagos llegan en unidades menores, y los informes de conciliación en decimales.

Antes de comenzar#

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#

Configurar la conexión#

1. 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.
2. En Configuración → Conexiones, seleccione + Agregar conexión y seleccione Checkout.com.
3. ON Configurar conector, introduzca un Nombre y seleccione Programa.
4. ON Introducir credenciales, introduzca ID de clave de acceso, Secreta clave de acceso y ID de entidad.
5. Seleccionar Verificar conexión.

La conexión muestra entonces 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.

1. En el asistente de conexión, copie la URL de destino del webhook de Athia.
2. En el Hub, vaya a Configuración → Flujos de trabajo → Crear flujo de trabajo.
3. Seleccione los eventos payment_captured, payment_approved y dispute_created.
4. Añadir gancho web acción y pegue la URL de destino del webhook de Athia.
5. 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, vault y reports families. gateway:payment-details y reports:read Solo no cubren los datos de saldo, pago y acción financiera, y un conjunto de alcance limitado devuelve HTTP 401 en lugar de datos parciales.
• Los datos de la tarjeta están minimizados.

Resolución de problemas#

Relacionado#

Otros proveedores y rutas de ingestión se enumeran en Conectores de Athia. Para las caídas de archivos y alternativas de almacén a almacén a un conector directo, consulte Integrando Athia.