RevGlanceDocumentazione

Lemon Squeezy

Collega Lemon Squeezy con una chiave API e un webhook firmato.

RevGlance legge prodotti, clienti, ordini, abbonamenti e fatture degli abbonamenti del tuo negozio Lemon Squeezy con una chiave API.

Collegamento

  1. In Lemon Squeezy, apri Settings › API e crea una nuova chiave API. Chiamala RevGlance.
  2. Copia subito la chiave: Lemon Squeezy la mostra una sola volta.
  3. Incollala in Chiave API e scegli Collega Lemon Squeezy. RevGlance legge prodotti, clienti, ordini, abbonamenti e le relative fatture.

Cosa chiede il modulo

CampoEsempio
Chiave APISalvato cifratoeyJ0eXAiOiJKV1Qi…

Aggiungi il webhook

  1. In RevGlance, apri Impostazioni › Fonti, apri il menu della fonte Lemon Squeezy e scegli Webhook. Copia l'URL.
  2. In Lemon Squeezy, apri Settings › Webhooks e aggiungi un webhook con quell'URL. Inventa un signing secret lungo e casuale e seleziona gli eventi di ordini, abbonamenti e pagamenti degli abbonamenti.
  3. Incolla lo stesso segreto in Segreto di firma in RevGlance e salva.

Cosa sincronizza RevGlance

  • Varianti, per distinguere gli abbonamenti dai prodotti una tantum e leggere l'intervallo di ogni piano.
  • Abbonamenti, letti per intero ogni volta, per MRR, piani, prove e disdette.
  • Clienti, ordini e fatture degli abbonamenti. Lemon Squeezy li elenca dal più recente senza un filtro per data, quindi le sincronizzazioni successive leggono a ritroso fino a 60 giorni prima dell'ultima sincronizzazione e, una volta alla settimana, rileggono tutto, per individuare i rimborsi di ordini meno recenti.

Come viene calcolato Lemon Squeezy

  • Gli addebiti sono il totale dell'ordine o della fattura al netto delle imposte.
  • Lemon Squeezy segnala i rimborsi imposte incluse, quindi RevGlance sottrae le imposte in proporzione. Aspettati ogni tanto un centesimo di arrotondamento.
  • I rimborsi totali hanno la data in cui Lemon Squeezy li ha effettuati. I rimborsi parziali non hanno data, quindi appaiono alla data della fattura.
  • Un abbonamento disdetto continua a contare fino alla fine del periodo pagato. Uno non pagato (quattro tentativi falliti) conta come abbandono e rientra se il pagamento viene recuperato.
  • Lemon Squeezy non invia data né motivo della disdetta: la data della disdetta è l'ultima modifica dell'abbonamento.
  • Lemon Squeezy non riporta commissioni, quindi le commissioni appaiono come zero.
  • Uno sconto viene sottratto dall'MRR quando un rinnovo lo mostra. Lemon Squeezy non indica se uno sconto si ripete, quindi uno presente solo sulla prima fattura non conta.
  • Un rimborso di un ordine meno recente viene individuato da una lettura completa una volta alla settimana, quindi può comparire con un massimo di una settimana di ritardo.
  • Una prova convertita prima del collegamento non viene mostrata, perché Lemon Squeezy indica una prova solo mentre è in corso.
  • I chargeback non vengono letti, quindi uno perso resta conteggiato come addebito, a meno che il fornitore non lo comunichi anche come rimborso.