RevGlanceDocumentazione

Paddle

Collega Paddle Billing con una chiave API che può leggere transazioni, rettifiche, abbonamenti e clienti.

Collegamento

  1. In Paddle, apri Developer tools › Authentication e crea una chiave API. Solo Paddle Billing: Paddle Classic non è supportato.
  2. Consentile di leggere transactions, adjustments, subscriptions e customers. Aggiungi transaction.write se invierai email di recupero.
  3. Copia la chiave. Una chiave live inizia con pdl_live_apikey_; funziona anche una chiave sandbox, che sincronizza dalla sandbox di Paddle.
  4. Incollala in Chiave API e scegli Collega Paddle.

Cosa chiede il modulo

CampoEsempio
Chiave APISalvato cifratopdl_live_apikey_…

Aggiungi il webhook

  1. In RevGlance, apri Impostazioni › Fonti, apri il menu della fonte Paddle e scegli Webhook. Copia l'URL.
  2. In Paddle, apri Developer tools › Notifications e aggiungi una destinazione con quell'URL. Seleziona gli eventi di transazioni, rettifiche e abbonamenti.
  3. Copia la secret key della destinazione, incollala in Segreto di firma in RevGlance e salva.

Cosa sincronizza RevGlance

  • Transazioni pagate o completate, con il loro cliente e indirizzo.
  • Rettifiche: i rimborsi e i chargeback approvati diventano rimborsi, e vengono tolti di nuovo quando vengono stornati.
  • Abbonamenti, per MRR, piani, prove e disdette, con gli sconti ricorrenti sottratti dall'MRR.
  • Clienti, attivi e archiviati.

Paddle non conserva i motivi di disdetta, quindi le disdette arrivano senza.

Come viene calcolato Paddle

  • Gli importi provengono dai totali dei pagamenti di Paddle, al netto delle imposte, con la commissione di Paddle come commissione.
  • Rimborsi e chargeback contano al netto delle imposte. Un chargeback vinto da Paddle, o un rimborso annullato da Paddle, non conta più.
  • Una commissione sui chargeback trattenuta da Paddle conta come commissione.
  • Un prezzo comprensivo di imposte conta al netto delle imposte nell'MRR, nella quota di imposte della prossima fattura.
  • Gli sconti ricorrenti vengono sottratti dall'MRR, anche se lo sconto è stato archiviato in seguito.
  • Un pagamento che non è stato possibile riscuotere conta come addebito non riuscito. Non sposta denaro.

Email di recupero

Recupera collega ogni pagamento non riuscito al checkout di Paddle per aggiornare il metodo di pagamento. Serve transaction.write sulla chiave; senza, l'email rimanda alla tua pagina per aggiornare la carta.