Bearing

Aide · Utiliser Bearing

Les revenus de Paddle

Chaque paiement et chaque remboursement de votre compte Paddle dans Bearing, avec la source et la campagne de la visite dont il vient. Paddle prévient Bearing lui-même ; une ligne de code relie chaque vente à sa visite.

Bearing montre ce que vous vendez par Paddle à côté de vos visites, et pour chaque paiement la source et la campagne de la visite dont il vient. Paddle prévient Bearing lui-même de chaque paiement, au moment où il a lieu. Ce guide vaut pour Paddle Billing, le Paddle d'aujourd'hui ; Paddle Classic n'est pas pris en charge.

Ce qu'il vous faut

  • Bearing installé sur votre site.
  • L'accès à votre compte Paddle réel, pas au bac à sable (voir plus bas).
  • Pour savoir de quelle visite vient chaque vente : une ligne de code là où votre site ouvre la page de paiement de Paddle, pour un développeur ou pour l'IA qui écrit le code de votre site (étape 4).

1. Copier l'adresse dans Bearing

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

2. Demander à Paddle de prévenir Bearing

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

  1. Dans Paddle, ouvrez Events, puis Notifications, et cliquez sur New destination.
  2. Description : Bearing. Notification type : webhook. URL : collez l'adresse copiée.
  3. Usage type : Platform only, pour que seuls les vrais événements soient envoyés.
  4. Cochez ces événements, et seulement ceux-là : transaction.completed, adjustment.created, adjustment.updated. Laissez API version tel quel.
  5. Enregistrez, puis copiez la clé secrète de la destination : elle commence par pdl_ntfset_. Si Paddle ne l'affiche plus, ouvrez le menu à côté de la destination, puis Edit destination.

Le bac à sable de Paddle est un compte à part, et rien dans ses messages ne les distingue des vrais : ne connectez que votre compte réel, sinon des ventes de test compteraient comme de vraies ventes. Pour la même raison, n'envoyez jamais les simulations de Paddle à cette adresse.

3. Coller le secret dans Bearing

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

4. Relier chaque vente à sa visite

La page de paiement de Paddle s'ouvre depuis le code de votre site : c'est donc là qu'on lui confie le code de la visite. Une ligne, pour un développeur ou pour l'IA qui écrit le code de votre site :

// Là où votre site ouvre la page de paiement de Paddle
const token = window.bearing && window.bearing.token ? window.bearing.token() : "";
Paddle.Checkout.open({
  items: [{ priceId: "pri_…", quantity: 1 }],
  customData: token ? { bearing_token: token } : undefined,
});
  • Un bouton qui ouvre la page de paiement par les attributs HTML de Paddle : donnez à son data-custom-data la valeur {"bearing_token": "…"}, avec le jeton, avant le clic.
  • Paddle le recopie sur l'abonnement : les renouvellements gardent eux aussi la source.
  • Sans cette ligne, chaque vente est quand même comptée, en Source inconnue. Bearing ne la répartit jamais entre vos sources.

L'essayer sans toucher à vos chiffres

Le bac à sable de Paddle ne peut pas servir ici (voir plus haut). Une fois la ligne de l'étape 4 en place, achetez l'un de vos produits depuis un navigateur où vous avez exclu vos propres visites, puis remboursez-le dans Paddle : 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 une fois que Paddle l'a approuvé : Paddle examine d'abord la plupart des remboursements.
  • 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 transaction chez Paddle, 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 la clé secrète de la destination et collez-la.
  • Dans Paddle, le journal de la destination montre chaque message et chaque tentative. Paddle réessaie pendant environ deux jours quand Bearing ne répond pas.
  • Débrancher, dans les Réglages de votre site, fait oublier le secret à Bearing. Les paiements déjà enregistrés restent. Supprimez aussi la destination dans Paddle.