Stripe

Connectez Stripe avec une clé restreinte en lecture seule, puis ajoutez un webhook pour que les nouveaux paiements apparaissent aussitôt.

RevGlance lit votre compte Stripe via l’API de Stripe avec une clé que vous créez. Il lit les paiements, remboursements, commissions, litiges et abonnements, et n’effectue jamais de paiement ni de remboursement et ne modifie jamais rien.

Avant de commencer

Vous devez être propriétaire ou administrateur de l’entreprise dans RevGlance. Les lecteurs ne peuvent pas ajouter de sources.
Utilisez une clé restreinte plutôt que votre clé secrète. RevGlance accepte les deux (rk_… ou sk_…), mais une clé restreinte ne peut lire que ce que vous autorisez.
Les clés du mode test fonctionnent aussi, ce qui est pratique pour un premier aperçu. Connectez une deuxième source avec votre clé live quand vous êtes prêt.

Connexion

Dans le Dashboard Stripe, ouvrez Developers › API keys et choisissez Create restricted key. Nommez-la RevGlance.
Donnez-lui l’accès Read à Balance, Charges, Customers, Disputes, Invoices, Checkout Sessions, Subscriptions et Coupons. Laissez tout le reste sur None.
Créez la clé et copiez-la. Elle commence par rk_live_.
Collez-la sous Clé restreinte et choisissez Connecter Stripe. La première synchronisation lit tout votre historique.

Ce que demande le formulaire

Champ	Ressemble à
Clé restreinteStocké chiffré	`rk_live_…`

Le champ Nom est facultatif. Il permet de distinguer deux comptes Stripe dans une même entreprise.

Ajouter le webhook

Sans webhook, RevGlance synchronise Stripe toutes les heures. Avec un webhook, un nouveau paiement, un remboursement ou une annulation met une synchronisation en file en quelques secondes.

Dans RevGlance, ouvrez Paramètres › Sources, trouvez la source Stripe, ouvrez son menu et choisissez Webhook. Copiez l’URL.
Dans Stripe, ouvrez Developers › Webhooks et ajoutez un endpoint avec cette URL.
Sélectionnez les événements qui modifient vos chiffres : charge.succeeded, charge.failed, charge.refunded, charge.dispute.closed, customer.subscription.created, customer.subscription.updated, customer.subscription.deleted et invoice.paid. N’importe quel événement fonctionne : chacun lance simplement une synchronisation.
Copiez le Signing secret de l’endpoint (whsec_…), collez-le sous Secret de signature dans RevGlance et enregistrez.

Ce que RevGlance synchronise

Balance transactions : chaque paiement, remboursement, litige et commission Stripe, dans la devise de règlement de Stripe.
Paiements échoués, pour la métrique des paiements échoués et pour Récupérer.
Abonnements de tous statuts, avec leur client, leurs éléments, leurs remises et leur dernière facture, pour le MRR, les plans, les essais et les annulations. Le motif d’annulation de Stripe et le commentaire du client sont inclus quand Stripe les a.

La première synchronisation lit tout votre historique. Ensuite, chaque synchronisation lit à partir de trois jours avant la précédente, pour rattraper les modifications tardives, et les abonnements sont lus en entier à chaque fois.

Comment Stripe est calculé

Les paiements, les remboursements et les commissions de Stripe proviennent de vos balance transactions, dans la devise dans laquelle Stripe les a réglés.
Les remboursements par carte comptent le jour où Stripe les enregistre. Les paiements bancaires (ACH, SEPA et autres moyens locaux) comptent aussi ; un remboursement renvoyé par la banque réduit à nouveau vos remboursements.
Un litige compte comme un remboursement quand Stripe reprend l’argent, et le remboursement est annulé si vous le gagnez. La commission de litige de Stripe est conservée comme commission.
Les coupons sur l’abonnement et sur des articles individuels sont déduits du MRR. Un coupon à montant fixe ne compte que dans sa propre devise.
Les abonnements suspendus et impayés comptent dans l’attrition ; un abonnement en retard de paiement continue de compter pendant que Stripe relance la carte.
Les paiements, remboursements et litiges comptent hors taxes, selon la part de taxe de leur facture ou de leur Checkout Session. Sans accès en lecture aux Checkout Sessions, la taxe des ventes hors facture reste incluse.
Un prix TTC compte hors taxes dans le MRR, selon la part de taxe de la dernière facture.
La suspension de l’encaissement des paiements compte dans l’attrition à partir du jour où RevGlance la voit pour la première fois, car Stripe ne la date pas.

Voir Comment nous comptons pour les règles qui s’appliquent à tous les fournisseurs.

E-mails de récupération

Récupérer relie un paiement d’abonnement échoué à la page de sa facture ouverte dans Stripe, où le client peut payer avec une nouvelle carte. Quand il n’y a pas de facture ouverte, une session du portail client Stripe s’ouvre à la place. Cette solution de repli nécessite que le portail soit activé dans Stripe et une clé autorisée à écrire des sessions Customer portal ; sinon, l’e-mail renvoie vers votre propre page de mise à jour de carte.

Dépannage

« Collez une clé secrète ou restreinte Stripe. » La clé doit commencer par rk_ ou sk_. Une clé publiable (pk_) ne peut rien lire.
« Stripe refused that key. » La clé a été révoquée, ou elle n’a pas d’accès en lecture à Balance.
« Stripe refused the failed-charge request » ou « the subscription request » : la clé ne peut pas lire Charges ou Subscriptions. Les paiements continuent de se synchroniser ; ajoutez l’autorisation manquante et relancez la synchronisation.