Intégrations · Prestataires de paiement
Commandes et renouvellements Lemon Squeezy, liés à leurs visites.
Connectez une boutique Lemon Squeezy avec une clé API. Tally lit les commandes et les factures d’abonnement avec leurs remboursements, et lie chaque vente au visiteur dont l’identifiant est passé par les données personnalisées du paiement, ou par l’e-mail de l’acheteur.
14 jours gratuits, sans carte bancaire.
01Ce que Tally lit
- Les commandes comme nouvelles ventes, les factures d’abonnement comme renouvellements ou changements d’offre ; le premier paiement d’un abonnement est compté une seule fois, comme sa commande.
- Les remboursements, totaux ou partiels, d’après le cumul remboursé que tient Lemon Squeezy : chaque nouveau total n’ajoute que la différence.
- Les boutiques en mode test comme en production : c’est le mode de la clé qui décide.
- Les montants hors taxes, en cents US au taux de référence du jour.
02Comment une vente retrouve sa visite
- Données personnalisées du lien de paiementAjoutez checkout[custom][tally_visitor_id] à un lien de paiement, ou renseignez-le dans checkout_data.custom quand votre serveur crée le paiement.
- E-mailL’e-mail de l’acheteur, haché, correspond à un appel tally('identify'). C’est le seul lien possible pour les commandes passées avant la connexion.
- Renouvellements et remboursementsUne facture d’abonnement reprend le lien de sa première commande ; un remboursement s’impute sur la commande ou la facture à laquelle il se rattache.
03Ce qu’il ne peut pas lire
- Lemon Squeezy ne signale aucune rétrofacturation : il rembourse lui-même une commande contestée, ce qui arrive sous forme de remboursement.
- Son API ne renvoie pas les données personnalisées : les commandes antérieures à la connexion ne se lient que par e-mail.
- Le snippet ne marque pas de lui-même les liens de paiement Lemon Squeezy ; la page Coverage donne les quelques lignes qui le font.
- Les clés API n’ont pas de portées (scopes) : l’accès minimal est une clé créée uniquement pour Tally, que rien d’autre n’utilise.
04Le connecter
- Dans Lemon Squeezy, ouvrez Settings, API, et créez une clé réservée à Tally.
- Collez-la sur la page Integrations de votre site. Une clé voit toutes les boutiques de son compte : indiquez la boutique s’il y en a plusieurs.
- Tally crée pour cette boutique un webhook doté de son propre secret et importe les 365 derniers jours.
- Ajoutez l’identifiant du visiteur à vos liens de paiement ou à checkout_data, comme le montre la page Coverage.
Ce dont la clé API a besoin
Tally demande une clé API qui ne peut faire que cela, et vérifie chaque autorisation par un vrai appel quand vous la collez, si bien qu’une autorisation manquante est nommée :
| Autorisation | Accès | Pourquoi |
|---|---|---|
| Orders | Lecture | Chaque vente : son montant, sa taxe et ses remboursements, et l’e-mail du client (haché aussitôt, jamais conservé). |
| Subscription invoices | Lecture | Renouvellements et changements d’offre. |
| Webhooks | Écriture | Tally ajoute son propre webhook à la boutique, pour que les paiements arrivent en quelques secondes. |
Où la créer : Lemon Squeezy, Settings, API.
05Questions fréquentes
Puis-je connecter plusieurs boutiques Lemon Squeezy ?
Chaque boutique alimente un seul site. Une clé qui voit plusieurs boutiques vous fait préciser laquelle, par identifiant, slug, domaine ou nom, et une boutique qui alimente déjà un autre site est refusée.
Comment les remboursements partiels sont-ils comptés ?
Lemon Squeezy tient un montant remboursé cumulé plutôt que des remboursements distincts : Tally enregistre chaque nouveau total pour ce qu’il ajoute. Quel que soit l’ordre d’arrivée, le webhook et l’import aboutissent à la même somme, avec la taxe remboursée au prorata.
Pourquoi les anciennes commandes n’ont-elles pas de source ?
L’API de Lemon Squeezy ne renvoie pas les données personnalisées qu’un paiement transportait : les commandes antérieures à la connexion ne peuvent se lier que par l’e-mail de l’acheteur. Les commandes suivantes portent l’identifiant du visiteur.