Adyen
Sur cette page
Adyen a besoin de vrais devoirs dans la console du fournisseur : la plupart de ce qu'Athia ingère arrive sous forme de fichiers de rapports planifiés, ces rapports doivent donc exister en premier. Faites cela et Adyen devient la meilleure source de règlement et de coûts que vous puissiez connecter.
Ce que vous obtenez#
Détails du règlement et règlement global, comptabilité des paiements, détails des paiements reçus, détails des frais d'interchange et du système, détails des transactions en litige et résultats de l'authentification 3D Secure.
Le plus puissant pour le règlement et le détail des frais. Adyen présente ce qui a été réglé et ce qu'il a coûté à un niveau que la plupart des fournisseurs n'exposent pas, ce qui en fait la source de référence pour le coût par commande approuvée.
Le plus faible pour le contexte d’abonnement, ce qui est mince ici — cette image vient d’ailleurs.
Avant de commencer#
1. Activez et planifiez les rapports. Sélectionnez le compte marchand dans la liste déroulante en haut à gauche → Rapports dans la navigation de gauche → recherchez et configurez chaque rapport → cliquez Générer → sélectionner Automatisé (généré dans les délais) → choisir .CSV comme le Type de fichier. Configurez tout cela :
- Authentification sécurisée 3D
- Authentification 3DS
- Détails du règlement global
- Détails des transactions contestées
- Commission d'interchange et de programme
- Comptabilité des paiements
- Détails du paiement reçu
- Détails du règlement
Automatisez ces rapports au compte d'entreprise ainsi que par compte marchand - la planification par compte marchand à elle seule ne produit pas les rapports au niveau de l'entreprise.
Après le premier compte marchand, ajoutez une étoile (ajoutez un signet) aux rapports pour que le reste aille plus vite.
2. Créez l'utilisateur du service de rapports. Passer à vue au niveau de l'entreprise, créez les informations d'identification et sélectionnez Signaler un utilisateur du service comme le Type d'identifiant. Copiez le Nom d'utilisateur de Paramètres généraux, puis générez le Mot de passe sous Paramètres du serveur → Authentification de base. Associer l'identifiant au compte d'entreprise et chaque compte marchand tu veux à Athia ; un identifiant limité à un compte laisse silencieusement de côté les autres.
3. Créez les informations d'identification de l'API du service Web. Dans l'espace client Adyen à l'adresse niveau de l'entreprise, allez à Développeurs → Identifiants API et créez un identifiant de service Web, puis générez et copiez son Clé API.
4. Attribuez ses rôles aux informations d'identification de l'API du service Web. Le créer ne suffit pas. Sous Autorisations → Rôles, accorder Management API - Accounts read et Management API - Webhooks read and write. Sous Comptes, associez-le au compte d'entreprise et tous les comptes marchands associés.
Informations d'identification demandées par Athia#
| Champ | Obligatoire | Qu'est-ce que c'est / où le trouver |
|---|---|---|
| Nom | Oui | Votre libellé pour cette connexion : identifiez le compte ou la région de l'entreprise |
| Calendrier | Non | À quelle fréquence Athia vérifie les nouvelles données et fichiers de rapport |
| Clé API du service Web | Oui | La clé API que vous avez créée pour Athia |
| Clé API du service de rapports | Oui | Les informations d'identification de l'utilisateur du service de rapports au niveau de l'entreprise |
Configuration de la connexion#
- Dans Paramètres → Connexions, choisissez + Ajouter une connexion et sélectionnez Adyen.
- Sur Configurer le connecteur, entrez un Nom et choisis un Calendrier.
- Sur Entrez les informations d'identification, collez le Clé API du service Web et le Clé API du service de rapports.
- Choisissez Vérifier la connexion.
La connexion s'affiche alors comme ACTIVE et la première synchronisation démarre.
Pour les MID supplémentaires, réutilisez les mêmes informations d’identification : aucune autre modification Adyen n’est nécessaire si les rapports sont déjà configurés pour ces MID.
Enregistrez le webhook Athia dans Adyen#
Copiez le URL de destination du webhook Athia depuis l'assistant de connexion, puis dans Adyen :
- Aller à Développeurs → Webhooks → Créer un nouveau webhook → Notification standard → Ajouter.
- Ouvrez Modifier la configuration du serveur et collez le URL de destination du webhook Athia.
- Sous Comptes marchands, sélectionnez les MID : ils doivent correspondre aux MID pour lesquels vous avez configuré les rapports.
- Sous Paramètres supplémentaires, activez 3D sécurisé (inclure le résultat et la version 3D Secure), Acquéreur (ajouter le résultat acquéreur et la référence) et Carte (inclure la carte BIN et les informations détaillées sur la carte BIN).
- Testez le webhook, enregistrez-le, puis activez-le.
Les événements de rapport au niveau de l'entreprise nécessitent toujours la demande d'assistance Adyen en haut de cette page.
Cadence de synchronisation#
Votre Calendrier contrôle la fréquence à laquelle Athia recherche de nouveaux fichiers de rapport, et non la vitesse à laquelle Adyen les produit. Les données de règlement avancent uniquement lorsque Adyen clôture un lot.
Limites et choses à savoir#
- Dépend du rapport. Si un rapport n'est pas activé dans Adyen – ou est défini sur manuel – ces données n'atteignent jamais Athia et la vérification peut réussir tant qu'un domaine reste vide.
- Les montants sont décimaux — ne divisez jamais par 100, contrairement à Stripe.
- Les données de la carte sont minimisées. Pour savoir ce que contient chaque champ ingéré, voir Dictionnaire de données Athia.
- La portée historique est limitée par combien de rapports Adyen renvoie, donc les périodes très anciennes peuvent être inaccessibles et doivent d'abord être régénérées dans Adyen — dans l'Espace Client, allez sur Rapports → sélectionner le rapport → plage de dates personnalisée. Confirmez l'analyse rétrospective réalisable avant de promettre une fenêtre de remplissage.
Dépannage#
| Ce que tu vois | Cause probable | Que faire |
|---|---|---|
| Il manque un compte marchand | Signaler un utilisateur du service qui n'y est pas associé | Associez les informations d'identification à chaque compte |
| Les données de règlement arrivent, mais pas les données sur les frais. | Le rapport sur les frais d'interchange et de système n'est pas activé | Activez-le et attendez la prochaine génération |
| La vérification réussit mais aucune nouvelle donnée n'arrive | Adyen n'envoie pas d'événements webhook pour les rapports au niveau de l'entreprise | Contactez l'assistance Adyen pour les activer, puis confirmez que le webhook est activé et que ses MID correspondent aux MID de votre rapport. |
Connexes#
- Connecteurs Athia — le catalogue complet des connecteurs.
- Intégrer Athia — les chemins d'intégration, y compris les dépôts de fichiers et l'entrepôt à l'entrepôt.
- Dictionnaire de données Athia — définitions au niveau du champ.