RevGlanceDocumentation

Paddle

Connectez Paddle Billing avec une clé API qui peut lire les transactions, les ajustements, les abonnements et les clients.

Connexion

  1. Dans Paddle, ouvrez Developer tools › Authentication et créez une clé API. Paddle Billing uniquement : Paddle Classic n’est pas pris en charge.
  2. Autorisez-la à lire transactions, adjustments, subscriptions et customers. Ajoutez transaction.write si vous comptez envoyer des e-mails de récupération.
  3. Copiez la clé. Une clé live commence par pdl_live_apikey_ ; une clé sandbox fonctionne aussi et se synchronise depuis la sandbox de Paddle.
  4. Collez-la sous Clé API et choisissez Connecter Paddle.

Ce que demande le formulaire

ChampRessemble à
Clé APIStocké chiffrépdl_live_apikey_…

Ajouter le webhook

  1. Dans RevGlance, ouvrez Paramètres › Sources, ouvrez le menu de la source Paddle et choisissez Webhook. Copiez l’URL.
  2. Dans Paddle, ouvrez Developer tools › Notifications et ajoutez une destination avec cette URL. Sélectionnez les événements de transaction, d’ajustement et d’abonnement.
  3. Copiez la secret key de la destination, collez-la sous Secret de signature dans RevGlance et enregistrez.

Ce que RevGlance synchronise

  • Transactions payées ou terminées, avec leur client et leur adresse.
  • Ajustements : les remboursements et rétrofacturations approuvés deviennent des remboursements, et sont retirés à nouveau s’ils sont annulés.
  • Abonnements, pour le MRR, les plans, les essais et les annulations, avec les remises récurrentes déduites du MRR.
  • Clients, actifs et archivés.

Paddle ne conserve aucun motif d’annulation : les annulations arrivent donc sans motif.

Comment Paddle est calculé

  • Les montants proviennent des totaux de versement de Paddle, hors taxes, avec la commission de Paddle comme commission.
  • Les remboursements et rétrofacturations comptent hors taxes. Une rétrofacturation gagnée par Paddle, ou un remboursement annulé par Paddle, ne compte plus.
  • Une commission de rétrofacturation conservée par Paddle compte comme commission.
  • Un prix TTC compte hors taxes dans le MRR, selon la part de taxe de la prochaine facture.
  • Les remises récurrentes sont déduites du MRR, y compris si la remise a été archivée par la suite.
  • Un paiement qui n’a pas pu être encaissé compte comme un paiement échoué. Il ne déplace aucun argent.

E-mails de récupération

Récupérer relie chaque paiement échoué au checkout Paddle de mise à jour du moyen de paiement. Cela nécessite transaction.write sur la clé ; sans cette autorisation, l’e-mail renvoie vers votre propre page de mise à jour de carte.