RevGlanceDokumentacja

Lemon Squeezy

Połącz Lemon Squeezy kluczem API i podpisanym webhookiem.

RevGlance odczytuje kluczem API produkty, klientów, zamówienia, subskrypcje i faktury subskrypcji twojego sklepu Lemon Squeezy.

Połączenie

  1. W Lemon Squeezy otwórz Settings › API i utwórz nowy klucz API. Nazwij go RevGlance.
  2. Od razu skopiuj klucz: Lemon Squeezy pokazuje go tylko raz.
  3. Wklej go w polu Klucz API i wybierz Połącz Lemon Squeezy. RevGlance odczytuje produkty, klientów, zamówienia, subskrypcje i ich faktury.

O co pyta formularz

PoleWygląda tak
Klucz APIPrzechowywane w postaci zaszyfrowanejeyJ0eXAiOiJKV1Qi…

Dodawanie webhooka

  1. W RevGlance otwórz Ustawienia › Źródła, otwórz menu źródła Lemon Squeezy i wybierz Webhook. Skopiuj adres URL.
  2. W Lemon Squeezy otwórz Settings › Webhooks i dodaj webhook z tym adresem URL. Wymyśl długi losowy signing secret i wybierz zdarzenia zamówień, subskrypcji i płatności za subskrypcje.
  3. Wklej ten sam sekret w polu Sekret podpisywania w RevGlance i zapisz.

Co synchronizuje RevGlance

  • Warianty, aby odróżnić subskrypcje od produktów jednorazowych i odczytać okres rozliczeniowy każdego planu.
  • Subskrypcje, odczytywane za każdym razem w całości, na potrzeby MRR, planów, okresów próbnych i anulowań.
  • Klienci, zamówienia i faktury subskrypcji. Lemon Squeezy zwraca je od najnowszych, bez filtra dat, więc kolejne synchronizacje czytają wstecz do 60 dni przed poprzednią synchronizacją, a raz w tygodniu odczytują wszystko ponownie, aby wychwycić zwroty starszych zamówień.

Jak liczony jest Lemon Squeezy

  • Płatności to suma zamówienia lub faktury bez podatku.
  • Lemon Squeezy podaje zwroty z podatkiem, więc RevGlance proporcjonalnie odejmuje podatek. Czasem może wystąpić grosz różnicy z zaokrąglenia.
  • Pełne zwroty mają datę, w której Lemon Squeezy je wykonało. Częściowe zwroty nie mają daty, więc pojawiają się z datą faktury.
  • Anulowana subskrypcja liczy się do końca opłaconego okresu. Nieopłacona (cztery nieudane ponowienia) liczy się jako odpływ i wraca, jeśli płatność zostanie odzyskana.
  • Lemon Squeezy nie przesyła daty ani powodu anulowania: datą anulowania jest ostatnia zmiana subskrypcji.
  • Lemon Squeezy nie podaje prowizji, więc prowizje są pokazywane jako zero.
  • Rabat obniża MRR, gdy pokaże go odnowienie. Lemon Squeezy nie podaje, czy rabat się powtarza, więc rabat tylko na pierwszej fakturze się nie liczy.
  • Zwrot starszego zamówienia wychwytuje pełny odczyt raz w tygodniu, więc może pojawić się nawet tydzień później.
  • Okres próbny, który przeszedł w płatny przed połączeniem, nie jest pokazywany, bo Lemon Squeezy wskazuje okres próbny tylko w jego trakcie.
  • Obciążenia zwrotne nie są odczytywane, więc przegrane nadal liczy się jako płatność, chyba że dostawca zgłosi je też jako zwrot.