Intégrations · Prestataires de paiement
Commandes et abonnements Polar, chacun avec sa source.
Connectez Polar avec un jeton d’accès d’organisation limité à cinq portées (scopes). Tally lit les achats et les cycles d’abonnement avec leurs remboursements et leurs litiges perdus, et lie chacun au visiteur via les métadonnées du paiement, la référence d’un lien de paiement ou l’e-mail.
14 jours gratuits, sans carte bancaire.
01Ce que Tally lit
- Les commandes une fois payées, si elles portent un montant : achats et premiers paiements d’abonnement comme nouvelles ventes, cycles et cycles à l’usage comme renouvellements, changements d’offre comme passages à une offre supérieure.
- Les remboursements en attente ou réussis ; un remboursement qui échoue ou est annulé ajoute son inverse, si bien que les deux s’annulent.
- Les litiges perdus comme rétrofacturations, hors taxes.
- Les montants remises déduites et hors taxes, en cents US au taux de référence du jour.
- Les jetons sandbox se connectent en mode test.
02Comment une vente retrouve sa visite
- Métadonnées du paiementL’identifiant du visiteur dans les métadonnées d’un paiement, que Polar recopie sur sa commande et son abonnement.
- Liens de paiementLe reference_id d’un lien de paiement arrive dans les métadonnées du paiement et se lie comme un Payment Link Stripe.
- E-mailL’e-mail du client, haché dès réception, correspond à un appel tally('identify'). Confiance moyenne.
03Ce qu’il ne peut pas lire
- Polar n’envoie aucun événement de litige : un litige perdu est lu au prochain changement de sa commande, ou lors d’une réimportation.
- Le snippet ne marque pas de lui-même les liens de paiement Polar ; quelques lignes sur votre page le font, pour les liens que l’embed Polar marque data-polar-checkout.
- Les commandes sans montant, comme les produits gratuits, ne sont pas des ventes et ne sont pas comptées.
04Le connecter
- Dans Polar, ouvrez Settings, Access Tokens, et créez un jeton d’organisation avec les cinq portées ci-dessous.
- Collez-le sur la page Integrations de votre site ; chaque portée est vérifiée, et un jeton sandbox est reconnu comme mode test.
- Tally crée son propre endpoint de webhook et importe les 365 derniers jours, remboursements et litiges perdus compris.
- Placez l’identifiant du visiteur dans les métadonnées du paiement, ou en reference_id sur les liens de paiement, comme le montre la page Coverage.
Ce dont le jeton d’accès a besoin
Tally demande un jeton d’accès qui ne peut faire que cela, et vérifie chaque autorisation par un vrai appel quand vous le collez, si bien qu’une autorisation manquante est nommée :
| Autorisation | Accès | Pourquoi |
|---|---|---|
| Organizations | organizations:read | Le nom de l’organisation, pour savoir laquelle est connectée. |
| Orders | orders:read | Chaque paiement : son montant, sa taxe, ses métadonnées et l’e-mail du client (haché aussitôt, jamais conservé). |
| Refunds | refunds:read | Remboursements. |
| Disputes | disputes:read | Rétrofacturations : les litiges perdus. |
| Webhooks | webhooks:write | Tally ajoute son propre endpoint de webhook, pour que les paiements arrivent en quelques secondes. |
Où la créer : Polar, Settings, Access Tokens.
05Questions fréquentes
Tally compte-t-il l’usage facturé à la consommation via Polar ?
Oui : une commande pour un cycle d’abonnement à l’usage est un renouvellement, compté au montant facturé par Polar et attribué à la visite qui a converti le client.
Pourquoi la portée des litiges est-elle nécessaire avec Polar ?
Polar n’envoie aucun événement de litige : Tally lit donc l’API Disputes pour repérer les litiges que vous avez perdus et les compter comme rétrofacturations sur la vente.
Puis-je d’abord essayer dans la sandbox de Polar ?
Oui. Collez un jeton sandbox et l’intégration se connecte en mode test, avec son propre webhook : vous pouvez vérifier un paiement sandbox de bout en bout.