RevGlanceDocumentatie

Lemon Squeezy

Koppel Lemon Squeezy met een API-sleutel en een ondertekende webhook.

RevGlance leest met een API-sleutel de producten, klanten, bestellingen, abonnementen en abonnementsfacturen van je Lemon Squeezy-winkel.

Koppelen

  1. Open in Lemon Squeezy Settings › API en maak een nieuwe API-sleutel aan. Noem hem RevGlance.
  2. Kopieer de sleutel meteen: Lemon Squeezy toont hem maar één keer.
  3. Plak hem onder API-sleutel en kies Lemon Squeezy koppelen. RevGlance leest producten, klanten, bestellingen, abonnementen en hun facturen.

Wat het formulier vraagt

VeldZiet eruit als
API-sleutelVersleuteld opgeslageneyJ0eXAiOiJKV1Qi…

Voeg de webhook toe

  1. Open in RevGlance Instellingen › Bronnen, open het menu van de Lemon Squeezy-bron en kies Webhook. Kopieer de URL.
  2. Open in Lemon Squeezy Settings › Webhooks en voeg een webhook toe met die URL. Verzin een lang willekeurig signing secret en selecteer de events voor bestellingen, abonnementen en abonnementsbetalingen.
  3. Plak hetzelfde geheim onder Ondertekeningsgeheim in RevGlance en sla op.

Wat RevGlance synchroniseert

  • Varianten, om abonnementen te onderscheiden van eenmalige producten en het interval van elk abonnement te lezen.
  • Abonnementen, elke keer volledig gelezen, voor MRR, abonnementsvormen, proefperiodes en opzeggingen.
  • Klanten, bestellingen en abonnementsfacturen. Lemon Squeezy toont deze met de nieuwste eerst, zonder datumfilter, dus latere synchronisaties lezen terug tot 60 dagen vóór de vorige synchronisatie en lezen eens per week alles opnieuw, om terugbetalingen van oudere bestellingen op te vangen.

Hoe Lemon Squeezy wordt geteld

  • Betalingen zijn het totaal van de bestelling of factuur min belasting.
  • Lemon Squeezy meldt terugbetalingen inclusief belasting, dus RevGlance haalt de belasting er naar verhouding af. Reken af en toe op een cent afrondingsverschil.
  • Volledige terugbetalingen krijgen de datum waarop Lemon Squeezy ze uitvoerde. Gedeeltelijke terugbetalingen hebben geen datum, dus die verschijnen op de factuurdatum.
  • Een opgezegd abonnement blijft meetellen tot de betaalde periode afloopt. Een onbetaald abonnement (vier mislukte nieuwe pogingen) telt als verloop en komt terug als de betaling alsnog lukt.
  • Lemon Squeezy stuurt geen opzegdatum of reden: de opzegdatum is wanneer het abonnement voor het laatst is gewijzigd.
  • Lemon Squeezy meldt geen kosten, dus kosten worden als nul getoond.
  • Een korting gaat van de MRR af zodra een verlenging die toont. Lemon Squeezy zegt niet of een korting terugkeert, dus een korting op alleen de eerste factuur telt niet.
  • Een terugbetaling van een oudere bestelling wordt opgevangen door een volledige leesronde eens per week, dus die kan tot een week later verschijnen.
  • Een proefperiode die is omgezet voordat je verbinding maakte, wordt niet getoond, omdat Lemon Squeezy een proefperiode alleen noemt zolang die loopt.
  • Chargebacks worden niet gelezen, dus een verloren chargeback blijft als betaling meetellen, tenzij de provider die ook als terugbetaling meldt.