Aide · Utiliser Bearing
Les revenus de Lemon Squeezy
Chaque vente et chaque paiement d'abonnement de votre boutique Lemon Squeezy dans Bearing, avec la source et la campagne de la visite dont il vient. Lemon Squeezy prévient Bearing lui-même : rien à coder.
Bearing montre ce que rapporte votre boutique Lemon Squeezy à 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. Lemon Squeezy 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 d'achat.
- L'accès aux Settings de votre boutique Lemon Squeezy.
- Rien à coder quand votre site renvoie vers la page de paiement de Lemon Squeezy.
1. Copier l'adresse dans Bearing
- Ouvrez les Réglages de votre site dans Bearing, section Revenus (autre moyen de paiement), et ouvrez Lemon Squeezy.
- Copiez l'adresse affichée. Elle n'appartient qu'à ce site.
2. Demander à Lemon Squeezy de prévenir Bearing
Lemon Squeezy appelle cela un « webhook » : une adresse à prévenir, qu'il appelle chaque fois que quelque chose se passe dans votre boutique. Ici, cette adresse est celle de Bearing.
- Dans Lemon Squeezy, ouvrez Settings » Webhooks et cliquez sur le bouton +.
- Callback URL : collez l'adresse copiée.
- Signing secret : tapez un secret de votre choix, de 6 à 40 lettres et chiffres, et gardez-le sous la main : vous collerez le même dans Bearing. Il prouve à Bearing qu'un message vient bien de votre boutique.
- Cochez ces événements, et seulement ceux-là :
order_created,order_refunded,subscription_created,subscription_payment_success,subscription_payment_refunded. - Enregistrez.
Un webhook appartient à une seule boutique : si vous en avez plusieurs, créez-en un dans chacune. Lemon Squeezy sépare le mode réel et le mode test : un webhook créé en mode test n'entend que les ventes de test (voir plus bas).
3. Coller le secret dans Bearing
- De retour dans les Réglages de votre site, sous Lemon Squeezy, collez le même secret dans Secret de signature et cliquez sur Brancher.
- Dès la vente suivante, la section dit quand le dernier message est arrivé.
Comment une vente trouve sa source
- Un lien vers la page de paiement d'un produit (une adresse sur
lemonsqueezy.comqui contient/buy/, comme le lien de partage de votre produit) : rien à faire. Quand un visiteur clique dessus depuis votre site, Bearing y ajoute le code de cette visite, et Lemon Squeezy renvoie ce code avec le paiement. - Une boutique sur son propre domaine (
boutique.exemple.fr) : ajoutezdata-bearing-checkout="lemonsqueezy"au lien, comme ci-dessous. - Une page de paiement que votre développeur crée par l'API de Lemon Squeezy : faites passer le jeton de visite dans
checkout_data.custom.bearing_token, 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.
<a href="https://boutique.exemple.fr/checkout/buy/…" data-bearing-checkout="lemonsqueezy">Acheter</a>// 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 page de paiement (POST /v1/checkouts)
// attributes: { checkout_data: { custom: { bearing_token: token } } }L'essayer sans toucher à vos chiffres
Passez votre boutique en mode test dans Lemon Squeezy et créez-y le même webhook : la même adresse, le même secret, les mêmes événements. Achetez ensuite l'un de vos produits en mode test, avec la carte 4242 4242 4242 4242, une date future et n'importe quel code. 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). Vous savez alors que tout le chemin marche.
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.
- Le remboursement d'une vente ou d'un renouvellement est déduit, en tout ou en partie, dès que vous le faites dans Lemon Squeezy.
- 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 Lemon Squeezy, 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 : collez de nouveau le même secret des deux côtés.
- Dans Lemon Squeezy, Settings » Webhooks montre chaque message envoyé, et permet d'en envoyer un de nouveau.
- Débrancher, dans les Réglages de votre site, fait oublier le secret à Bearing. Les paiements déjà enregistrés restent. Supprimez aussi le webhook dans Lemon Squeezy.