Checkout.com

Checkout.com est un connecteur libre-service et la source de coûts la plus importante du catalogue. Il s'appuie sur deux éléments à la fois : les détails de paiement de la passerelle et les rapports de rapprochement qui décomposent le coût réel de chaque transaction. Activez d'abord les rapports, sinon vous obtenez la moitié des paiements et aucun des coûts.

Ce que vous obtenez#

Paiements et leurs actions avec résultats, litiges, paiements et détails de rapprochement couvrant les frais et les devises. Les définitions au niveau du champ résident dans Dictionnaire de données Athia.

Le plus fort pour la décomposition des frais. De tous les fournisseurs de cartes, Checkout.com décompose le coût le plus loin : les frais d'interchange, les frais de système, les frais de passerelle, les frais de jeton de réseau, les frais de rétrofacturation et les devises arrivent tous séparément, ce qui rend le coût réel par commande approuvée possible plutôt qu'estimé.

Le plus faible pour la cohérence des unités. Les paiements sont présentés en unités mineures, les rapports de rapprochement en décimales.

Avant de commencer#

1. Activer les rapports de rapprochement sur le Checkout.com côté. Jusqu'à leur activation, les données de coût n'apparaîtront pas, quelle que soit la portée des informations d'identification.

2. Créez la paire de clés Access. Dans le Hub, accédez à Développeurs → Clés → Créer une nouvelle clé. Le titre est un Access key ID plus un Clé d'accès secrète; Athia a besoin des deux.

3. Sélectionnez Étendues personnalisées et l'ensemble complet d'étendues. Activer au minimum le gateway, vault et reports familles de portées. gateway:payment-details (détail du paiement et de l'action) et reports:read (rapports de rapprochement) doivent être inclus, mais ils ne constituent pas la liste complète - cette paire ne couvre pas les données de solde, de paiement et de rapport d'action financière qu'Athia ingère, et un ensemble de portée restreint produit HTTP 401 des erreurs plutôt que des données partielles.

4. Sélectionnez l'entité les couvre-clés. Le ID d'entité est ce qui sépare la connexion d’une entité de celle d’une autre.

5. Choisissez explicitement l'environnement. Un Tester le compte est mappé à Environnement de test; un En direct le compte est mappé à Production. Une clé provenant du mauvais environnement vérifie et ne contient rien de ce que vous reconnaissez.

Informations d'identification demandées par Athia#

Configuration de la connexion#

1. Activer les rapports de rapprochement, définir Autoriser n’importe quel canal de traitement à ON, et créez la paire de clés Access avec Portées personnalisées et l'ensemble complet de la portée, pour la bonne entité et le bon environnement.
2. Dans Paramètres → Connexions, choisissez + Ajouter une connexion et sélectionnez Checkout.com.
3. Sur Configurer le connecteur, entrez un Nom et choisis un Calendrier.
4. Sur Entrez les informations d'identification, entrez le ID de clé d'accès, Clé d'accès secrète et ID d'entité.
5. Choisissez Vérifier la connexion.

La connexion s'affiche alors comme ACTIVE et la première synchronisation démarre. Si vous exploitez plusieurs entités, créez une connexion par entité — ID d'entité c'est ce qui les sépare.

Enregistrez le webhook Athia#

Les événements de paiement et de litige parviennent à Athia en temps réel via un Checkout.com workflow.

1. Dans l'assistant de connexion, copiez le URL de destination du webhook Athia.
2. Dans le Hub, accédez à Paramètres → Workflows → Créer un workflow.
3. Sélectionnez les événements payment_captured, payment_approved et dispute_created.
4. Ajouter un webhook action et collez le URL de destination du webhook Athia.
5. Configurez l'en-tête de signature, puis testez, enregistrez et activez le workflow.

Cadence de synchronisation#

Cette connexion dispose de deux horloges : les détails du paiement sont mis à jour au fur et à mesure des transactions, tandis que les rapports de rapprochement suivent Checkout.comLe cycle de reporting est plus lent. Les données de coûts ne seront pas plus récentes que ce cycle, quel que soit le calendrier que vous choisissez.

Limites et choses à savoir#

• Unités de montant mixte. Les montants de l'API de paiement sont unités mineures (diviser par 100) ; les montants du rapport de rapprochement sont décimal. Athia se normalise lors de l'ingestion, mais vérifiez de quelle source provient un chiffre avant de conclure qu'il est faux.
• Les rapports doivent d'abord être activés, ou la décomposition des frais pour laquelle ce connecteur est le meilleur n'est pas là.
• L’ensemble complet de la portée est nécessaire. Créez la clé avec Portées personnalisées couvrant au moins la gateway, vault et reports families. gateway:payment-details et reports:read à eux seuls, ne couvrent pas les données des rapports sur les soldes, les paiements et les actions financières, et un ensemble de portée restreint renvoie HTTP 401 plutôt que des données partielles.
• Les données de la carte sont minimisées.

Dépannage#

Connexes#

D'autres fournisseurs et chemins d'ingestion sont répertoriés dans Connecteurs Athia. Pour les dépôts de fichiers et les alternatives d'entrepôt à entrepôt à un connecteur direct, voir Intégrer Athia.