RevGlanceDocumentazione

Recurly

Collega Recurly con una chiave API privata, nella regione US o EU.

RevGlance legge la versione 2021-02-25 dell'API di Recurly: fatture di addebito pagate, transazioni di rimborso e abbonamenti.

Collegamento

  1. In Recurly, apri Integrations › API Credentials e aggiungi una chiave API privata. Chiamala RevGlance.
  2. Copia la chiave e annota il sottodominio del tuo sito: acme per acme.recurly.com.
  3. Inserisci la chiave, la regione in cui è ospitato il tuo sito (us o eu) e il sottodominio, poi scegli Collega Recurly.

Cosa chiede il modulo

CampoEsempio
Chiave API privataSalvato cifrato0123456789abcdef0123456789abcdef
Regioneus o eu
Sottodominio del sitoacme (da acme.recurly.com)

Inserisci us o eu come regione. I siti ospitati nell'UE usano l'API EU di Recurly.

Aggiungi il webhook

  1. In RevGlance, apri Impostazioni › Fonti, apri il menu della fonte Recurly e scegli Webhook. Copia l'URL.
  2. In Recurly, apri Integrations › Webhooks e aggiungi un endpoint con quell'URL in formato JSON.
  3. Copia il segreto di firma dell'endpoint, incollalo in Segreto di firma in RevGlance e salva.

RevGlance verifica l'header recurly-signature e rifiuta le chiamate più vecchie di cinque minuti.

Cosa sincronizza RevGlance

  • Fatture di addebito pagate, al netto delle tasse.
  • Transazioni di rimborso riuscite, con le tasse sottratte nella stessa proporzione della fattura.
  • Abbonamenti, per MRR, piani, prove e disdette. Recurly non fornisce il motivo di disdetta tramite la sua API e non riporta le commissioni del gateway.

Come viene calcolato Recurly

  • Le fatture di addebito pagate contano al netto delle imposte.
  • I rimborsi sono le transazioni di rimborso riuscite. Includono le imposte, quindi RevGlance sottrae le imposte nella stessa proporzione della fattura.
  • Recurly non riporta le commissioni del gateway, quindi le commissioni appaiono come zero.
  • L'MRR è il subtotale di Recurly per l'abbonamento (importo unitario, quantità e componenti aggiuntivi, dopo i coupon, al netto delle imposte).
  • Un abbonamento disdetto continua a contare finché non scade; quelli scaduti, non riusciti e in pausa contano come abbandono. Recurly non fornisce il motivo della disdetta tramite la API.
  • Un pagamento che non è stato possibile riscuotere conta come addebito non riuscito. Non sposta denaro.
  • I chargeback non vengono letti, quindi uno perso resta conteggiato come addebito, a meno che il fornitore non lo comunichi anche come rimborso.

Email di recupero

Recupera manda il cliente alla pagina dell'account ospitata sul tuo sito Recurly, ed è per questo che il modulo chiede il sottodominio.