Bearing

Aide · Utiliser Bearing

Les revenus de Polar

Chaque paiement et chaque remboursement de votre compte Polar dans Bearing, avec la source et la campagne de la visite dont il vient. Polar prévient Bearing lui-même : rien à coder.

Bearing montre ce que vous vendez par Polar à côté de vos visites, et pour chaque paiement la source et la campagne de la visite dont il vient : quel post, quelle newsletter, quelle publicité finit en vente. Polar prévient Bearing lui-même de chaque paiement, au moment où il a lieu. Vous le mettez en place une fois, en quelques minutes.

Ce qu'il vous faut

  • Bearing installé sur le site où sont vos liens de paiement.
  • L'accès aux Settings de votre organisation Polar, sur Polar même, pas sur son bac à sable (voir plus bas).
  • Rien à coder quand votre site utilise les liens de paiement de Polar.

1. Copier l'adresse dans Bearing

  1. Ouvrez les Réglages de votre site dans Bearing, section Revenus (autre moyen de paiement), et ouvrez Polar.
  2. Copiez l'adresse affichée. Elle n'appartient qu'à ce site.

2. Demander à Polar de prévenir Bearing

Polar appelle cela un « webhook » : une adresse à prévenir, qu'il appelle chaque fois que quelque chose se passe dans votre organisation. Ici, cette adresse est celle de Bearing.

  1. Dans Polar, ouvrez Settings → Webhooks et cliquez sur Add Endpoint.
  2. URL : collez l'adresse copiée. Format : Raw.
  3. Cochez ces événements, et seulement ceux-là : order.paid, order.refunded. API Version : choisissez 2026-10. Laissez les autres champs tels quels.
  4. Enregistrez. Sur la page de l'adresse ainsi créée, cliquez sur Copy Secret : Polar fabrique le secret lui-même.

Le bac à sable de Polar est à part, et rien dans ses messages ne les distingue des vrais : ne connectez que votre organisation Polar réelle, sinon des ventes de test compteraient comme de vraies ventes.

3. Coller le secret dans Bearing

  1. De retour dans les Réglages de votre site, sous Polar, collez le secret dans Secret de signature et cliquez sur Brancher.
  2. Dès la vente suivante, la section dit quand le dernier message est arrivé.

Comment une vente trouve sa source

  • Un lien de paiement Polar (Checkout Link) : rien à faire. Quand un visiteur clique dessus depuis votre site, Bearing y ajoute le code de cette visite, en reference_id, et Polar renvoie ce code avec le paiement. Si le lien porte déjà un reference_id à vous, Bearing le laisse : ces ventes comptent en Source inconnue.
  • Une page de paiement que votre développeur crée par l'API de Polar : faites passer le jeton de visite dans metadata.reference_id, comme ci-dessous.
  • Les abonnements : le premier paiement prend la source de la visite ; les renouvellements gardent la source du premier paiement du client.
  • Sans le code (un lien partagé hors de votre site, un script bloqué), la vente est du vrai revenu en Source inconnue. Bearing ne la répartit jamais entre vos sources.
// Dans le navigateur, quand le visiteur commence à payer
const token = window.bearing && window.bearing.token ? window.bearing.token() : "";

// Sur votre serveur, en créant la session de paiement
// metadata: { reference_id: token }

L'essayer sans toucher à vos chiffres

Le bac à sable de Polar ne peut pas servir ici (voir plus haut). Achetez l'un de vos produits par un lien de paiement de votre site, depuis un navigateur où vous avez exclu vos propres visites, puis remboursez-le dans Polar : c'est un vrai paiement. Le code de ce navigateur le dit, et la vente arrive dans Bearing comme un essai : rien n'est compté, et les Réglages de votre site affichent essai reçu sous Revenus (autre moyen de paiement).

Ce qui est compté, et ce qui ne l'est pas

  • Le montant est ce que le client a payé, taxes comprises, dans la devise où il a payé. Les devises ne sont jamais additionnées.
  • Un remboursement est déduit, en tout ou en partie, dès que vous le faites dans Polar. Le formulaire de remboursement de Polar demande le montant hors taxes ; Bearing déduit ce que le client a vraiment récupéré, taxes comprises.
  • Les abonnements et les ventes ponctuelles sont distingués dans la carte Revenus.
  • Rien d'avant le premier jour où Bearing a mesuré votre site : une telle vente ne pourrait être reliée à aucune visite.
  • Les paiements ne comptent pas dans votre offre.
  • Jamais le nom, l'e-mail, l'adresse ni la carte de l'acheteur. Bearing garde le montant, la devise, la date, ce qui a été remboursé, la référence de la commande chez Polar, et une empreinte à sens unique de son numéro de client, pour reconnaître deux paiements d'un même client.

Votre revenu récurrent (MRR) reste calculé à partir de Stripe seulement. Et un paiement, une seule entrée : n'envoyez pas aussi ces ventes depuis le serveur de votre site, elles compteraient deux fois.

Si rien n'arrive, ou pour arrêter

  • Les Réglages de votre site disent quand le dernier message est arrivé, et quand l'un a été refusé parce que le secret ne correspond pas : copiez de nouveau le secret dans Polar et collez-le.
  • Dans Polar, la page de l'adresse liste chaque envoi et permet d'en refaire un. Après dix échecs de suite, Polar la désactive et vous prévient par e-mail : réactivez-la dans Settings → Webhooks.
  • Débrancher, dans les Réglages de votre site, fait oublier le secret à Bearing. Les paiements déjà enregistrés restent. Supprimez aussi l'adresse dans Polar.