RevGlanceBraintree
Connectez Braintree avec une paire de clés API pour lire les transactions et la facturation récurrente.
RevGlance lit l’API de la passerelle Braintree, celle qu’utilisent les SDK serveur de Braintree, car la facturation récurrente n’existe que là.
Connexion
- Dans le Braintree Control Panel, ouvrez Settings › API et générez une nouvelle paire de clés API.
- Copiez le Merchant ID, la Clé publique et la Clé privée. L’utilisateur API auquel elles appartiennent doit avoir un rôle qui permet de lire les transactions et les abonnements.
- Saisissez-les, indiquez
production(ousandboxpour un compte sandbox) sous Environnement, puis choisissez Connecter Braintree.
Ce que demande le formulaire
| Champ | Ressemble à |
|---|---|
| Merchant ID | abc123def456ghi7 |
| Clé publique | 7xh9k3b2m4n5p6q8 |
| Clé privéeStocké chiffré | 0123456789abcdef0123456789abcdef |
| Environnement | production ou sandbox |
Ajouter le webhook
Braintree signe ses webhooks avec les clés API que la source possède déjà : il n’y a donc aucun secret à coller.
- Dans RevGlance, ouvrez Paramètres › Sources, ouvrez le menu de la source Braintree et choisissez Webhook. Copiez l’URL.
- Dans le Braintree Control Panel, ouvrez Settings › Webhooks, créez un webhook avec cette URL et sélectionnez les notifications d’abonnement et de transaction.
Ce que RevGlance synchronise
- Transactions : les ventes réglées ou en cours de règlement deviennent des paiements ; les crédits deviennent des remboursements. Les autorisations jamais capturées sont exclues.
- Abonnements, avec leurs plans, options et remises, pour le MRR, les essais et les annulations.
La première synchronisation lit toutes les transactions conservées par Braintree. Braintree ne transmet ni commissions de traitement ni motifs d’annulation via son API.
Comment Braintree est calculé
- Les ventes réglées et en cours de règlement comptent, hors taxes si vous envoyez les montants de taxe. Les autorisations jamais capturées ne comptent pas.
- Les remboursements sont les transactions de crédit, datées du jour où Braintree les a effectuées.
- Braintree ne fournit aucune commission de traitement via son API : les commissions s’affichent donc à zéro.
- Le MRR correspond au prix de l’abonnement avec ses options, moins les remises auxquelles il reste des cycles de facturation. Un abonnement ne nomme aucun client : il prend donc le client de ses paiements ; un abonnement sans paiement apparaît sous sa carte.
- Une annulation est datée d’après l’historique des statuts. Un abonnement expiré prend fin à sa date de fin de période payée.
- Un paiement qui n’a pas pu être encaissé compte comme un paiement échoué. Il ne déplace aucun argent.
- Les rétrofacturations ne sont pas lues : une rétrofacturation perdue reste donc comptée comme un paiement, sauf si le fournisseur la signale aussi comme remboursement.