Connecter Paddle
Collez une clé API Paddle en lecture seule pour importer les ventes de logiciels et de SaaS, les remboursements et les taxes par produit et par pays.
Paddle est le merchant of record des logiciels que vous vendez hors des app stores : applications de bureau, applications web, offres SaaS et licences. La connexion se fait avec une seule clé API en lecture seule plutôt qu'avec OAuth. Vous créez la clé dans le tableau de bord Paddle, vous la collez dans Revenue Sensor et vous choisissez les produits Paddle à synchroniser. La clé est stockée chiffrée et ne quitte jamais notre serveur ; vos identifiants Paddle ne sont jamais utilisés.
Avant de commencer
- Un accès au tableau de bord Paddle du compte vendeur dont vous voulez suivre les ventes, avec l'autorisation de créer des clés API dans Developer tools.
- Savoir si vous voulez le compte live ou le sandbox. Paddle émet des clés distinctes pour chacun, et c'est la clé qui décide lequel nous lisons ; il n'y a rien d'autre à choisir.
Créer une clé API en lecture seule
- 1
Ouvrir Developer tools
Dans le tableau de bord Paddle, allez dans Developer tools → Authentication et créez une nouvelle clé API. Donnez-lui un nom que vous reconnaîtrez plus tard, par exemple « Revenue Sensor ».
- 2
N'accorder que des droits de lecture
Cochez l'accès en lecture pour Transactions, Adjustments, Products et Addresses. Addresses figure sous Customers et nous donne le pays de l'acheteur ; laissez-le coché même si cela semble sans rapport. Aucun droit d'écriture n'est nécessaire.
- 3
Copier la clé une seule fois
Paddle n'affiche la clé qu'une seule fois, à sa création. Copiez-la immédiatement ; si vous la perdez, révoquez-la et créez-en une autre.
Connecter le compte
- 1
Coller la clé
Integrations → Paddle → Connect dans la console Revenue Sensor, puis collez la clé API. Revenue Sensor lit le préfixe de la clé pour distinguer une clé live d'une clé sandbox et confirme laquelle sera utilisée avant que vous continuiez.
- 2
Choisir vos produits
Les unités synchronisées sont des produits Paddle, pas des applications de store. Choisissez les produits que vous voulez dans le grand livre ; chacun apparaît comme sa propre ligne de revenus et peut être rattaché à une application s'il en fait partie. Seul ce que vous sélectionnez est récupéré, et seul ce que vous sélectionnez compte pour votre forfait.
- 3
Laisser tourner la première synchronisation
Paddle conserve tout votre historique : la première synchronisation récupère donc jusqu'à un an de transactions payées et de remboursements. Cela prend en général quelques minutes et vous pouvez quitter la page pendant ce temps.
Ce qui est importé
| Champ | Remarques |
|---|---|
| Revenus | Transactions payées, comptabilisées le jour où l'argent a été encaissé plutôt que le jour d'émission de la facture. Affichées par produit, par jour et par pays de l'acheteur, hors taxes. Les frais de Paddle ne sont pas déduits, de la même façon que Google Play est affiché brut, avant la commission de Google. |
| Taxes | Paddle collecte la taxe sur les ventes et la TVA en tant que merchant of record et l'indique sur chaque ligne ; la taxe est donc importée séparément et la vue taxes incluses est disponible pour cette source. |
| Remboursements et rétrofacturations | Les remboursements et rétrofacturations approuvés réduisent les revenus le jour de leur approbation, et le montant est aussi reporté comme chiffre de remboursement pour le contexte. Une rétrofacturation annulée remet l'argent en place. Les avoirs et les alertes de rétrofacturation ne sont pas traités comme des remboursements. |
| Pays | Tiré de l'adresse de facturation du client. Seul le code pays est utilisé. |
Toutes les devises Paddle sont prises en charge
Les transactions sont importées dans la devise de facturation et converties comme pour toute autre source. Les devises sans décimales comme le JPY et le KRW sont lues correctement, si bien qu'une vente au Japon n'est pas rapportée au centième de sa valeur.
Mises à jour en temps réel (facultatif)
Revenue Sensor synchronise Paddle toutes les 30 minutes. Si vous préférez voir une nouvelle vente ou un remboursement en une ou deux minutes, pointez une destination de notification Paddle vers nous. Les chiffres proviennent toujours de l'API Paddle ; le webhook nous dit seulement de synchroniser plus tôt.
- 1
Copier l'URL du webhook
Ouvrez la connexion Paddle dans la console Revenue Sensor. Le panneau « Real-time updates » affiche une URL propre à cette connexion ; copiez-la.
- 2
Créer une destination de notification
Dans Paddle, allez dans Developer tools → Notifications → New destination. Collez l'URL, choisissez Webhook comme type et abonnez-vous aux événements transaction, adjustment et subscription.
- 3
Enregistrer le secret
Paddle affiche un secret de signature à la création de la destination. Collez-le dans le panneau « Real-time updates » et enregistrez. Nous l'utilisons pour vérifier chaque livraison et rejeter tout ce qui n'est pas signé ; il est stocké chiffré et n'est plus jamais affiché.
Dépannage
- La clé est refusée : vérifiez qu'elle a l'accès en lecture aux quatre périmètres Transactions, Adjustments, Products et Addresses. Une clé sans Addresses passe la vérification de base mais échoue à la synchronisation.
- Aucun produit n'apparaît : la clé appartient à un autre compte, ou au sandbox alors que vous attendiez le live (ou l'inverse). Le préfixe de la clé vous dit lequel.
- Une vente manque : seules les transactions payées et finalisées sont importées. Les brouillons, les factures impayées et les transactions annulées ne sont pas encore des revenus.
- Les revenus semblent supérieurs à votre versement : c'est normal. La taxe est conservée à part et les frais de Paddle ne sont pas déduits ; le chiffre est donc le revenu brut avant la part de Paddle.
- Un remboursement apparaît un autre jour que la vente : les remboursements sont comptabilisés le jour de leur approbation, sans être antidatés à l'achat d'origine.