RevGlanceDocumentazione

Collegare le fonti

Come funzionano fonti, chiavi, webhook e sincronizzazioni, qualunque provider tu usi.

Una fonte è un account presso un provider di pagamenti, collegato a un'attività. Un'attività può avere più fonti, anche dello stesso provider: un account Stripe e un'app dell'App Store, oppure due account Stripe. Proprietari e amministratori collegano le fonti; i visualizzatori le vedono.

Provider supportati

I provider contrassegnati come beta sono stati sviluppati e testati sulla documentazione del provider, ma non sono ancora stati usati con un account reale. Facci sapere se un numero è diverso dai report del provider.

Chiavi

Ogni fonte si collega con una chiave che crei nel provider. RevGlance salva le credenziali cifrate, non le mostra mai più e si limita a leggere. Preferisci una chiave con restrizioni o in sola lettura ovunque il provider la offra.

Due funzioni possono scrivere, e solo se lo consenti sulla chiave:

  • Le email di recupero possono creare un link per aggiornare la carta (una sessione del portale Stripe, una sessione cliente Polar, una transazione Paddle di aggiornamento del pagamento).
  • In modalità privata, l'invio di email di recupero o del sondaggio chiede al provider l'indirizzo del cliente al momento dell'invio.

Sincronizzazione

  • La prima sincronizzazione legge tutto ciò che il provider conserva, salvo dove il provider pone dei limiti (l'App Store conserva un anno di report giornalieri).
  • Le sincronizzazioni successive leggono a partire da tre giorni prima dell'ultima, così le modifiche tardive vengono intercettate. Lo stato attuale, come gli abbonamenti, viene letto per intero.
  • Le fonti si sincronizzano ogni ora finché qualcuno usa l'attività. Quando nessuno accede da 30 giorni, si sincronizzano una volta al giorno; al ritorno viene sincronizzato tutto ciò che è più vecchio di un'ora.
  • Sincronizza ora nello stato di sincronizzazione della barra superiore sincronizza tutte le fonti dell'attività insieme.

Quando un provider rifiuta una richiesta, la fonte mostra l'errore sotto il suo nome in Impostazioni › Fonti. Una sincronizzazione parziale mantiene il punto raggiunto, quindi l'esecuzione successiva rilegge la stessa finestra.

Webhook

Un webhook permette al provider di comunicare a RevGlance che qualcosa è cambiato, e RevGlance mette subito in coda una sincronizzazione di quella fonte. Trovi l'URL del webhook di una fonte in Impostazioni › Fonti, nel suo menu, alla voce Webhook. I provider verificano i webhook in uno di tre modi:

ComeProviderCosa fai
Segreto di firmaStripe, Polar, Lemon Squeezy, Paddle, RecurlyIncolla in RevGlance il segreto di firma del provider
Segreto nell'URLGumroad, App Store, Google Play, ChargebeeSalva un segreto casuale in RevGlance, poi aggiungi ?token= e il segreto all'URL che dai al provider
Le chiavi della fonteBraintree, ShopifyNiente: il provider firma con le chiavi che la fonte ha già

Calcolo

Ogni provider riporta il denaro in modo un po' diverso: rimborsi con o senza tasse, commissioni o nessuna, date di disdetta o no. RevGlance uniforma queste differenze allo stesso modo ovunque e indica dove non può farlo. Ogni guida all'integrazione elenca le regole del suo provider, e Come contiamo le riunisce tutte in una pagina.

Rimuovere una fonte

Scegli Rimuovi fonte nel suo menu e tieni premuto il pulsante. I suoi pagamenti e abbonamenti vengono rimossi con essa; ricollegarla li riporta indietro.