Intégrations · Prestataires de paiement
Transactions, renouvellements et remboursements Paddle, liés à la visite.
Connectez Paddle Billing avec une clé API limitée à quatre autorisations. Tally lit chaque transaction finalisée, distingue les nouvelles ventes des renouvellements et des passages à une offre supérieure, et lie chacune au visiteur dont l’identifiant figurait dans les données personnalisées du paiement.
14 jours gratuits, sans carte bancaire.
01Ce que Tally lit
- Chaque transaction que Paddle finalise : paiements via Paddle.js, ceux créés par l’API et cycles d’abonnement.
- Le type, d’après l’origine de la transaction : nouvelle vente, renouvellement ou passage à une offre supérieure, les frais ponctuels sur un abonnement étant comptés comme expansion ; un essai converti compte comme nouvelle vente.
- Les remboursements et rétrofacturations issus des ajustements, une fois approuvés par Paddle ; les crédits ne font circuler aucun argent et sont laissés de côté.
- Les montants hors taxes, convertis en cents US au taux de référence du jour.
- Les clés sandbox se connectent en mode test : un paiement sandbox peut être essayé de bout en bout.
02Comment une vente retrouve sa visite
- customData de Paddle.jsTransmettez l’identifiant du visiteur en tally_visitor_id dans customData à l’ouverture du paiement. Paddle le recopie de l’abonnement sur chaque renouvellement, qui en hérite ainsi.
- custom_data de la transactionUne transaction créée par votre serveur porte la même clé dans son custom_data.
- E-mailL’e-mail du client, haché dès réception, correspond à un appel tally('identify') sur votre site. Confiance moyenne.
03Ce qu’il ne peut pas lire
- Paddle ne documente aucun moyen de faire passer l’identifiant du visiteur par sa page de paiement hébergée ou son lien de paiement par défaut : ces ventes ne se lient que par e-mail.
- Les anciennes clés API, créées avant que Paddle n’ajoute les autorisations, ne peuvent pas être limitées : elles sont refusées.
- Un remboursement en attente d’approbation par Paddle n’est compté qu’une fois approuvé ; un remboursement rejeté ne l’est jamais.
- Les ajustements portant sur des transactions antérieures aux 365 jours importés ne sont pas récupérés.
04Le connecter
- Dans Paddle, ouvrez Developer tools, Authentication, et créez une clé API avec les quatre autorisations ci-dessous.
- Collez-la sur la page Integrations de votre site ; chaque autorisation est vérifiée par un appel distinct.
- Tally ajoute sa propre destination de notifications dans Paddle et importe les 365 derniers jours de transactions.
- Ajoutez tally_visitor_id à customData là où vous ouvrez les paiements Paddle.js ; la page Coverage donne les lignes pour votre page et pour les transactions créées par votre serveur.
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 |
|---|---|---|
| Transaction | Lecture | Chaque paiement : son montant, sa taxe, son origine et ses données personnalisées. |
| Adjustment | Lecture | Remboursements et rétrofacturations. |
| Customer | Lecture | L’e-mail du client pour le rapprocher de tally('identify') : haché aussitôt, jamais conservé. |
| Notification setting | Écriture | Tally ajoute sa propre destination de notifications, pour que les paiements arrivent en quelques secondes. |
Où la créer : Paddle, Developer tools, Authentication.
05Questions fréquentes
Tally fonctionne-t-il avec Paddle Classic ?
Tally lit Paddle Billing, version 1 de l’API, avec des clés dotées d’autorisations. Une ancienne clé sans autorisations est refusée, avec une phrase qui l’explique.
Pourquoi quatre autorisations pour Paddle ?
Les transactions pour les paiements, les ajustements pour les remboursements et rétrofacturations, les clients pour la correspondance par e-mail, et les réglages de notifications pour que Tally ajoute sa propre destination et soit informé de chaque paiement en quelques secondes.
Les rétrofacturations sont-elles comptées ?
Oui : un ajustement de rétrofacturation approuvé compte comme une rétrofacturation négative, et un ajustement annulé revient en positif, si bien que les deux se compensent sur la vente à laquelle ils se rattachent.