Stripe

Collega Stripe con una chiave con restrizioni in sola lettura, poi aggiungi un webhook perché i nuovi pagamenti compaiano subito.

RevGlance legge il tuo account Stripe tramite l'API di Stripe con una chiave che crei tu. Legge addebiti, rimborsi, commissioni, contestazioni e abbonamenti, e non addebita, non rimborsa e non modifica mai nulla.

Prima di iniziare

Devi essere il proprietario o un amministratore dell'attività in RevGlance. I visualizzatori non possono aggiungere fonti.
Usa una chiave con restrizioni anziché la tua chiave segreta. RevGlance le accetta entrambe (rk_… o sk_…), ma una chiave con restrizioni può leggere solo ciò che consenti.
Funzionano anche le chiavi in modalità test, comode per un primo sguardo. Collega una seconda fonte con la tua chiave live quando sei pronto.

Collegamento

Nella Stripe Dashboard, apri Developers › API keys e scegli Create restricted key. Chiamala RevGlance.
Assegnale accesso Read a Balance, Charges, Customers, Disputes, Invoices, Checkout Sessions, Subscriptions e Coupons. Lascia tutto il resto su None.
Crea la chiave e copiala. Inizia con rk_live_.
Incollala in Chiave con restrizioni e scegli Collega Stripe. La prima sincronizzazione legge tutto il tuo storico.

Cosa chiede il modulo

Campo	Esempio
Chiave con restrizioniSalvato cifrato	`rk_live_…`

Il campo Nome è facoltativo. Serve a distinguere due account Stripe nella stessa attività.

Aggiungi il webhook

Senza un webhook RevGlance sincronizza Stripe ogni ora. Con un webhook, un nuovo pagamento, rimborso o disdetta mette in coda una sincronizzazione entro pochi secondi.

In RevGlance, apri Impostazioni › Fonti, trova la fonte Stripe, apri il suo menu e scegli Webhook. Copia l'URL.
In Stripe, apri Developers › Webhooks e aggiungi un endpoint con quell'URL.
Seleziona gli eventi che cambiano i tuoi numeri: charge.succeeded, charge.failed, charge.refunded, charge.dispute.closed, customer.subscription.created, customer.subscription.updated, customer.subscription.deleted e invoice.paid. Va bene qualsiasi evento: ognuno avvia semplicemente una sincronizzazione.
Copia il signing secret dell'endpoint (whsec_…), incollalo in Segreto di firma in RevGlance e salva.

Cosa sincronizza RevGlance

Balance transactions: ogni addebito, rimborso, contestazione e commissione Stripe, nella valuta in cui Stripe l'ha regolato.
Addebiti non riusciti, per la metrica degli addebiti non riusciti e per Recupera.
Abbonamenti di ogni stato, con il loro cliente, voci, sconti e ultima fattura, per MRR, piani, prove e disdette. Il motivo di disdetta di Stripe e il commento del cliente arrivano insieme quando Stripe li ha.

La prima sincronizzazione legge tutto il tuo storico. Dopo, ogni sincronizzazione legge a partire da tre giorni prima dell'ultima, così le modifiche tardive vengono intercettate, e gli abbonamenti vengono letti per intero ogni volta.

Come viene calcolato Stripe

Addebiti, rimborsi e commissioni di Stripe provengono dalle tue transazioni di saldo, nella valuta in cui Stripe le ha regolate.
I rimborsi su carta contano nel giorno in cui Stripe li registra. Contano anche i pagamenti bancari (ACH, SEPA e altri metodi locali); un rimborso che la banca restituisce riduce di nuovo i tuoi rimborsi.
Una contestazione conta come rimborso quando Stripe riprende il denaro, e il rimborso viene annullato se la vinci. La commissione di contestazione di Stripe resta come commissione.
I coupon sull'abbonamento e sui singoli articoli vengono sottratti dall'MRR. Un coupon a importo fisso conta solo nella propria valuta.
Gli abbonamenti in pausa e non pagati contano come abbandono; uno scaduto continua a contare mentre Stripe ritenta la carta.
Addebiti, rimborsi e contestazioni contano al netto delle imposte, nella quota di imposte della loro fattura o Checkout Session. Senza accesso in lettura alle Checkout Sessions, le imposte sulle vendite fuori da una fattura restano incluse.
Un prezzo comprensivo di imposte conta al netto delle imposte nell'MRR, nella quota di imposte dell'ultima fattura.
La sospensione della riscossione dei pagamenti conta come abbandono dal giorno in cui RevGlance la vede per la prima volta, perché Stripe non la data.

Vedi Come contiamo per le regole valide per ogni provider.

Email di recupero

Recupera collega un pagamento di abbonamento non riuscito alla pagina della sua fattura aperta in Stripe, dove il cliente può pagare con una nuova carta. Quando non c'è una fattura aperta, apre invece una sessione del portale clienti di Stripe. Questo ripiego richiede il portale attivato in Stripe e una chiave autorizzata a scrivere sessioni Customer portal; senza, l'email rimanda alla tua pagina per aggiornare la carta.

Risoluzione dei problemi

"Incolla una chiave segreta o con restrizioni di Stripe." La chiave deve iniziare con rk_ o sk_. Una chiave pubblicabile (pk_) non può leggere nulla.
"Stripe refused that key." La chiave è stata revocata, oppure non ha accesso in lettura a Balance.
"Stripe refused the failed-charge request" o "the subscription request": la chiave non può leggere Charges o Subscriptions. I pagamenti si sincronizzano comunque; aggiungi il permesso mancante e sincronizza di nuovo.