Aide · Utiliser Bearing
Les revenus de n'importe quel moyen de paiement : envoyés par le serveur de votre site
PayPal, la caisse de votre boutique, une plateforme qui prévient votre site à chaque vente : le serveur de votre site dit chaque paiement à Bearing, qui le relie à la visite dont il vient.
Si votre site est payé autrement que par Stripe, son serveur peut dire lui-même chaque paiement à Bearing. Bearing le montre alors comme les autres : dans la carte Revenus, sur le graphique, par source et par campagne. Cette page s'adresse à un développeur, ou à l'IA qui écrit le code de votre site : donnez-lui cette page.
Le mettre en place
- Ouvrez Accès IA, puis Les clés, et créez une clé Pour le serveur de votre site. Elle ne fait qu'envoyer, et ne lit rien. Gardez-la sur votre serveur, jamais dans une page.
- Dans la page, quand le visiteur commence à payer, prenez le jeton de visite et envoyez-le à votre serveur avec la commande (ou faites-le passer par votre système de paiement, s'il permet de joindre une valeur au paiement et la rend ensuite). Le jeton est créé dans la mémoire de la page, n'est jamais enregistré sur l'appareil du visiteur, et sert seulement à ce qu'un paiement rejoigne la visite où il a commencé.
- Sur votre serveur, une fois le paiement confirmé (votre système de paiement le dit, souvent en appelant une adresse de votre site), envoyez-le à Bearing avec la clé et le jeton.
// Dans la page, avec la commande :
const token = window.bearing && window.bearing.token ? window.bearing.token() : "";curl -X POST https://bearingstats.com/api/v1/payments \
-H "Authorization: Bearer bst_…" \
-H "Content-Type: application/json" \
-d '{"site": "exemple.fr", "amount": 29.99, "currency": "EUR", "id": "commande-1042", "token": "…"}'site: le domaine de votre site, ou son identifiant.amount: ce qui a été payé, dans l'unité de la devise :29.99pour 29,99 €, pas2999.currency: son code à trois lettres,EUR,USD…id: votre propre référence pour ce paiement (un numéro de commande, l'identifiant d'une transaction). La même n'est enregistrée qu'une fois : un nouvel envoi ne compte jamais double, et c'est elle qu'un remboursement nomme.token: facultatif, ce quebearing.token()a renvoyé. Ne l'envoyez pas quand la page n'en avait pas (le script était bloqué).paid_at: facultatif, le moment du paiement, date et heure avec leur décalage (2026-11-15T10:42:00+01:00). Sans lui : maintenant.customer: facultatif, votre propre référence pour le client, jamais un e-mail. Bearing n'en garde qu'une empreinte, pour reconnaître deux paiements d'un même client.recurring: facultatif,truepour le paiement d'un abonnement,falsepour une vente ponctuelle. Sans lui le paiement apparaît en Non connu, jamais en vente ponctuelle par défaut.renewal: facultatif,truequand ce n'est pas le premier paiement de ce client. Sans lui, Bearing le voit d'aprèscustomer.refunded: facultatif, ce qui a été remboursé jusqu'ici, dans la même unité queamount.provider: facultatif, un mot court pour ce qui a encaissé le paiement (paypal,woocommerce) : il apparaît dans les Réglages de votre site et dans votre export.
Comment c'est compté
- Avec un jeton que Bearing connaît, le paiement rejoint sa visite et prend la source et la campagne de cette visite, même s'il est payé des jours plus tard.
- Sans jeton, ou avec un jeton que Bearing n'a jamais reçu parce que le navigateur n'a rien envoyé, le paiement est du vrai revenu en Source inconnue. Bearing ne le répartit jamais entre vos sources.
- Avec `customer`, un paiement suivant du même client qui arrive sans jeton garde la source de son premier paiement (le renouvellement d'un abonnement), et compte parmi les clients qui payaient déjà.
- Rien d'avant le premier jour où Bearing a mesuré votre site : un tel paiement est refusé, et la réponse donne ce jour.
- Un paiement ne compte pas dans votre offre.
Un remboursement
Envoyez de nouveau le paiement avec le même id et refunded, le total remboursé jusqu'ici. Un paiement déjà enregistré garde son montant, sa date et sa visite : seul ce qui a été remboursé change.
Ce que Bearing répond
Votre serveur détient une clé : la réponse dit donc ce qui s'est passé.
{ "recorded": true, "visit": true } enregistré, avec la source d'une visite
{ "recorded": true, "visit": false } enregistré, source inconnue
{ "recorded": false, "refunded": true } paiement connu : ce qui a été remboursé est mis à jour
{ "recorded": false, "duplicate": true } cet id était déjà enregistré, rien n'a changé
{ "recorded": false, "test": true } un essai : voir plus basUne erreur vient avec une phrase qui dit quoi changer : 401 pour une clé absente ou révoquée, 404 pour un site qui n'est pas dans votre compte, 400 pour un message que Bearing ne sait pas lire, 409 pour un paiement daté d'avant la mesure de votre site, 429 quand trop de choses arrivent d'un coup.
L'essayer sans toucher à vos chiffres
Commencez un paiement depuis un navigateur où vous avez exclu vos propres visites. Le jeton de ce navigateur le dit, et ce que votre serveur envoie avec lui est un essai : rien n'est enregistré, la réponse dit test, et les Réglages de votre site affichent essai reçu sous Revenus (autre moyen de paiement). Vous savez alors que tout le chemin marche, de la page à votre serveur puis à Bearing.
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é, votre référence pour lui et le mot que vous avez donné pour ce qui l'a encaissé.
- Une empreinte à sens unique de votre référence client, seulement pour reconnaître que deux paiements viennent du même client.
- Jamais le nom, l'e-mail, l'adresse ni la carte de l'acheteur : ne les envoyez pas, Bearing n'a aucun champ pour eux.
Stripe ne passe pas par ici : connectez-le et Bearing le lit lui-même. Un paiement, une seule entrée : ce que Bearing lit dans Stripe ne doit pas être envoyé aussi par votre serveur. Voir tous les moyens de paiement que Bearing suit.