RevGlanceDocumentazione

Chargebee

Collega Chargebee con una chiave API in sola lettura e un URL webhook che contiene un segreto.

RevGlance legge l'API v2 di Chargebee: fatture pagate, note di credito e abbonamenti. Funzionano sia i siti su Product Catalog 2.0 sia quelli sul catalogo precedente.

Collegamento

  1. In Chargebee, apri Settings › Configure Chargebee › API Keys e aggiungi una chiave read-only per tutti i dati del tuo sito.
  2. Copia la chiave (inizia con live_) e annota il nome del tuo sito: acme per acme.chargebee.com.
  3. Inserisci il sito e la chiave, poi scegli Collega Chargebee.

Cosa chiede il modulo

CampoEsempio
Sitoacme (da acme.chargebee.com)
Chiave APISalvato cifratolive_…

Aggiungi il webhook

Chargebee non firma i suoi webhook, quindi il segreto viaggia con l'URL.

  1. In RevGlance, apri Impostazioni › Fonti, apri il menu della fonte Chargebee e scegli Webhook. Salva un segreto lungo e casuale in Segreto di firma.
  2. Copia l'URL del webhook e aggiungi alla fine ?token= seguito dal tuo segreto.
  3. In Chargebee, apri Settings › Configure Chargebee › Webhooks e aggiungi un webhook con quell'indirizzo. Al posto di ?token=, puoi attivare l'autenticazione di base e usare il segreto come password.

Cosa sincronizza RevGlance

  • Fatture pagate, al netto delle tasse.
  • Note di credito rimborsabili come rimborsi, al netto delle tasse nella stessa proporzione della nota di credito.
  • Abbonamenti, per MRR, piani, prove e disdette, con il codice del motivo di disdetta che hai configurato in Chargebee.

Chargebee non riporta le commissioni del gateway, quindi le commissioni risultano pari a zero.

Come viene calcolato Chargebee

  • Le fatture pagate contano al netto delle imposte.
  • I rimborsi provengono dalle note di credito rimborsabili, al netto delle imposte nella stessa proporzione della nota di credito.
  • Chargebee non riporta le commissioni del gateway, quindi le commissioni appaiono come zero.
  • L'MRR è dato dalle voci di piano e dai componenti aggiuntivi, meno i coupon sull'intera fattura che continuano ad applicarsi. Gli addebiti una tantum sono esclusi.
  • Gli abbonamenti senza rinnovo continuano a contare fino alla fine del loro periodo. Quelli in pausa contano come abbandono. Il codice motivo di disdetta che hai configurato in Chargebee appare come motivo.
  • Un pagamento che non è stato possibile riscuotere conta come addebito non riuscito. Non sposta denaro.
  • Un chargeback conta solo quando una nota di credito rimborsabile lo registra.