Arbre cérébral

Braintree est un connecteur libre-service construit sur trois valeurs : un identifiant marchand, une clé publique et une clé privée. Ce qui décide si la connexion est bonne, c'est le rôle d'accès limité que vous attachez à l'utilisateur de l'API : si vous vous trompez, des domaines entiers arrivent vides sans erreur.

Ce que vous obtenez#

Transactions avec données de paiement masquées, enregistrements de facturation récurrente et d'abonnement, litiges, enregistrements de clients et de modes de paiement, vérifications et données de relevés et de rapports. Les définitions au niveau du champ résident dans Dictionnaire de données Athia.

Le plus puissant pour les abonnements. Braintree fournit des détails de facturation récurrente que la plupart des connecteurs de cartes ne contiennent pas, ce qui en fait la source de référence pour le succès des renouvellements et pour le désabonnement involontaire dû aux refacturations échouées.

Le plus faible là où les autorisations sont étroites. La couverture est directement fonction du rôle que vous accordez ; les litiges et les clients sont les domaines qui manquent le plus souvent.

Avant de commencer#

Dans la console Braintree, créez un rôle à accès limité pour Athia et attribuez-le à l'utilisateur de l'API. Le rôle nécessite :

• Opérations : Télécharger des transactions avec des données de paiement masquées
• Rapports : Créer, exécuter et télécharger des rapports ; Afficher les graphiques du tableau de bord
• Facturation récurrente : Télécharger les enregistrements d'abonnement, afficher les modifications, afficher les plans d'abonnement, afficher les abonnements, rechercher des abonnements
• Gestion des litiges : Afficher, gérer et contester les litiges
• Webhooks : Gérer les Webhooks (Ajouter/Modifier/Supprimer)
• Déclarations : Afficher les relevés
• Accès en lecture seule : Afficher l'adresse, afficher les clients, afficher les comptes marchands, afficher les méthodes de paiement, afficher les transactions, afficher les vérifications, télécharger des fichiers
• Rechercher : Rechercher des transactions, rechercher des vérifications

Afficher l'adresse et Voir les clients sont les deux les plus souvent laissés de côté. Sans eux, les tables d'adresses et de clients se synchronisent vides et aucune erreur n'est générée.

Attribuez ensuite l'utilisateur de l'API à tout comptes marchands — Braintree étend l'accès à chaque compte marchand, de sorte qu'un compte laissé de côté n'apporte rien.

Créer l'utilisateur et les clés de l'API#

1. Connectez-vous au panneau de configuration Braintree en tant qu'administrateur et créez le rôle ci-dessus.
2. Créez un nouvel utilisateur et activez Accès API pour cet utilisateur.
3. Attribuez le rôle à accès limité que vous avez créé.
4. Sélectionnez tous les comptes marchands.
5. Déconnectez-vous et reconnectez-vous en tant que nouvel utilisateur, puis générez et copiez le Merchant ID, Clé publique et Clé privée.

Informations d'identification demandées par Athia#

Configuration de la connexion#

1. Créez le rôle, attribuez-le à l'utilisateur de l'API et attribuez cet utilisateur à chaque compte marchand.
2. Dans Paramètres → Connexions, choisissez + Ajouter une connexion et sélectionnez Arbre cérébral.
3. Sur Configurer le connecteur, entrez un Nom et choisis un Calendrier.
4. Sur Entrez les informations d'identification, entrez le Identifiant du marchand, Clé publique et Clé privée.
5. Choisissez Vérifier la connexion.

La connexion s'affiche alors comme ACTIVE et la première synchronisation démarre. Vérifiez que les litiges et les clients sont réellement renseignés : c'est la confirmation la plus rapide que le rôle est correct.

Enregistrez le webhook Athia dans Braintree#

Braintree transmet les mises à jour des transactions, des abonnements et des litiges à Athia en temps réel une fois la destination enregistrée.

1. Dans l'assistant de connexion, copiez le URL de destination du webhook Athia.
2. Connectez-vous au panneau de configuration Braintree en tant qu'utilisateur à accès limité et créez un webhook.
3. Collez l'URL d'Athia dans URL de destination.
4. Sous Notifications, activez tout options d'événement de notification.
5. Testez et enregistrez, puis activez le webhook.

Cadence de synchronisation#

Choisissez un Calendrier cela correspond à la mesure dans laquelle vous surveillez l'acceptation. Les enregistrements d'abonnement et de litige progressent selon les cycles de facturation et de litige de Braintree, quel que soit votre choix.

Limites et choses à savoir#

• Les autorisations manquantes produisent des domaines vides, pas des erreurs. Sans droits de lecture, les litiges et les clients se synchronisent à vide alors que la vérification réussit toujours.
• La couverture suit l'attribution du compte marchand. Les comptes auxquels l'utilisateur de l'API n'est pas affecté sont absents.
• Production et Sandbox sont des connexions distinctes. Chaque environnement émet son propre identifiant marchand et sa propre paire de clés : créez une connexion par environnement et ne mélangez jamais les informations d'identification entre eux.
• Les champs de règlement et de décaissement sont en retard jusqu'à deux jours derrière la transaction. Lisez les chiffres de règlement les jours arrivés à échéance, pas ceux d'aujourd'hui.
• Les montants sont décimaux - ne divisez jamais par 100.
• Les données de la carte sont minimisées. Le rôle ci-dessus accorde uniquement des données de paiement masqué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.