RevGlanceDocumentazione

Braintree

Collega Braintree con una coppia di chiavi API per leggere transazioni e fatturazione ricorrente.

RevGlance legge la gateway API di Braintree, quella usata dagli SDK server di Braintree, perché la fatturazione ricorrente si trova solo lì.

Collegamento

  1. Nel Braintree Control Panel, apri Settings › API e genera una nuova coppia di chiavi API.
  2. Copia Merchant ID, Public key e Private key. L'utente API a cui appartengono deve avere un ruolo che può leggere transazioni e abbonamenti.
  3. Inseriscili, scrivi production (o sandbox per un account sandbox) in Ambiente e scegli Collega Braintree.

Cosa chiede il modulo

CampoEsempio
ID commercianteabc123def456ghi7
Chiave pubblica7xh9k3b2m4n5p6q8
Chiave privataSalvato cifrato0123456789abcdef0123456789abcdef
Ambienteproduction o sandbox

Aggiungi il webhook

Braintree firma i suoi webhook con le stesse chiavi API che la fonte possiede già, quindi non c'è alcun segreto da incollare.

  1. In RevGlance, apri Impostazioni › Fonti, apri il menu della fonte Braintree e scegli Webhook. Copia l'URL.
  2. Nel Braintree Control Panel, apri Settings › Webhooks, crea un webhook con quell'URL e seleziona le notifiche di abbonamenti e transazioni.

Cosa sincronizza RevGlance

  • Transazioni: le vendite regolate e in fase di regolamento diventano pagamenti; gli accrediti diventano rimborsi. Le autorizzazioni mai acquisite vengono escluse.
  • Abbonamenti con i loro piani, add-on e sconti, per MRR, prove e disdette.

La prima sincronizzazione legge ogni transazione che Braintree conserva. Braintree non riporta commissioni di elaborazione né motivi di disdetta tramite la sua API.

Come viene calcolato Braintree

  • Contano le vendite regolate e in fase di regolamento, al netto delle imposte quando invii gli importi delle imposte. Le autorizzazioni mai acquisite non contano.
  • I rimborsi sono le transazioni di credito, con la data in cui Braintree le ha effettuate.
  • Braintree non riporta le commissioni di elaborazione tramite la sua API, quindi le commissioni appaiono come zero.
  • L'MRR è il prezzo dell'abbonamento con i suoi componenti aggiuntivi, meno gli sconti che hanno ancora cicli di fatturazione residui. Un abbonamento non indica un cliente, quindi prende il cliente dei suoi addebiti; uno ancora senza addebiti appare sotto la sua carta.
  • Una disdetta prende la data dalla cronologia degli stati. Un abbonamento scaduto termina alla data fino a cui è pagato.
  • 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.