Revenus : connecter Stripe

Bearing peut lire les paiements du compte Stripe de votre site et les montrer à côté de vos visites : ce que vous avez encaissé et, pour chaque paiement qu'il peut rattacher à une visite, la source et la campagne de cette visite. Bearing ne fait que lire : la clé que vous lui confiez ne peut rien modifier dans votre compte Stripe, et vous pouvez l'annuler dans Stripe à tout moment.

1. Créer la clé dans Stripe

1. Connectez-vous à Stripe et ouvrez la page des clés API. Vérifiez en haut à gauche que vous êtes sur le bon compte Stripe, et pas en mode test.
2. Cliquez sur Créer une clé limitée. Si Stripe demande à quoi servira la clé, choisissez Envoi de cette clé à une application tierce : son nom est Bearing, son adresse bearingstats.com.
3. Donnez à la clé un nom que vous reconnaîtrez, par exemple Bearing.
4. Stripe a peut-être coché des autorisations d'avance : une vingtaine de droits d'Écriture quand la clé est destinée à une application tierce. Remettez toutes les lignes sur Aucune, puis passez seulement deux lignes sur Lecture : Charges and Refunds, et Checkout Sessions.
5. Faites défiler la liste une fois pour vérifier que rien d'autre n'est coché, cliquez sur Créer une clé, confirmez que c'est bien vous si Stripe le demande, puis copiez la clé. Elle commence par rk_live_. Stripe ne l'affiche qu'une fois.

2. La coller dans Bearing

1. Ouvrez les Réglages de votre site, section Revenus (Stripe).
2. Collez la clé et cliquez sur Connecter.

Bearing importe vos paiements des 12 derniers mois, ce qui prend quelques minutes, puis relève les nouveaux une fois par jour. Le bouton Relever maintenant les lit tout de suite. Votre page Statistiques gagne une carte Revenus.

Bearing refuse une clé secrète (sk_…), qui pourrait tout faire dans votre compte. Un compte Stripe compte pour un seul site.

Où les voir

• Sur la courbe des visiteurs : l'argent qui est rentré apparaît en barres sous les visiteurs, les mêmes jours, avec sa propre échelle. Passez sur un jour pour lire les deux.
• Dans la carte Revenus : le total de la période, puis par source et par campagne.
• Sur la page de tous vos sites, sur la carte de chaque site, et en direct dans l'onglet En direct.

Comment un paiement trouve sa source

• Les liens de paiement Stripe (adresses commençant par buy.stripe.com) : rien à faire. Quand un visiteur clique sur le lien depuis votre site, Bearing y ajoute un code propre à cette visite, et Stripe renvoie ce code avec le paiement.
• Les abonnements : le premier paiement reçoit la source de la visite ; les renouvellements la gardent.
• Une page de paiement faite par un développeur : voir plus bas.
• Tout le reste (une facture payée par virement, une vente en personne, une plateforme qui encaisse par votre compte Stripe) compte dans vos revenus en Source inconnue. C'est un vrai revenu : Bearing ne le répartit jamais entre vos sources.

La source est celle de la visite où le paiement a commencé. Pour voir aussi quelles visites finissent par un achat, marquez l'événement comme objectif.

Pour un développeur

bearing.token() renvoie le code de la visite en cours (32 caractères). Transmettez-le à Stripe quand vous créez le paiement :

// Dans le navigateur, quand le visiteur commence à payer
const token = window.bearing?.token?.();

// Sur votre serveur, pour une Checkout Session
await stripe.checkout.sessions.create({ client_reference_id: token /* , … */ });

// ou pour un PaymentIntent
await stripe.paymentIntents.create({ metadata: { bearing_token: token } /* , … */ });

• Un lien vers votre propre page de paiement : ajoutez-lui l'attribut data-bearing-checkout, et Bearing ajoute client_reference_id à son adresse.
• Une table de prix Stripe : donnez le jeton à son attribut client-reference-id.
• Un essai gratuit sans carte : gardez le jeton avec le compte à l'inscription, et transmettez-le quand le client paie, même des semaines plus tard.
• Le jeton est créé dans la mémoire de la page quand vous le demandez. Ce n'est pas un cookie, et rien n'est stocké sur l'appareil du visiteur.

Ce que Bearing garde, et ce qu'il ne garde pas

• Pour chaque paiement : son montant, sa devise, sa date, ce qui a été remboursé, et la référence que Stripe donne au paiement.
• Une empreinte à sens unique de la référence client de Stripe, uniquement pour reconnaître que deux paiements viennent du même client.
• Jamais le nom, l'email, l'adresse ni la carte de l'acheteur.
• Votre clé est conservée chiffrée et n'est jamais réaffichée.

Déconnecter

Dans les Réglages, section Revenus (Stripe), cliquez sur Déconnecter : Bearing oublie la clé et arrête de relever. Les paiements déjà importés restent dans vos statistiques. Pour couper l'accès du côté de Stripe, ouvrez le menu de la clé sur la page des clés API et choisissez Faire expirer la clé.