RevGlancePaddle
Połącz Paddle Billing kluczem API, który może odczytywać transakcje, korekty, subskrypcje i klientów.
Połączenie
- W Paddle otwórz Developer tools › Authentication i utwórz klucz API. Tylko Paddle Billing: Paddle Classic nie jest obsługiwany.
- Pozwól mu odczytywać transactions, adjustments, subscriptions i customers. Dodaj
transaction.write, jeśli będziesz wysyłać e-maile odzyskiwania. - Skopiuj klucz. Klucz produkcyjny zaczyna się od
pdl_live_apikey_; klucz sandbox też działa i synchronizuje dane z sandboxa Paddle. - Wklej go w polu Klucz API i wybierz Połącz Paddle.
O co pyta formularz
| Pole | Wygląda tak |
|---|---|
| Klucz APIPrzechowywane w postaci zaszyfrowanej | pdl_live_apikey_… |
Dodawanie webhooka
- W RevGlance otwórz Ustawienia › Źródła, otwórz menu źródła Paddle i wybierz Webhook. Skopiuj adres URL.
- W Paddle otwórz Developer tools › Notifications i dodaj miejsce docelowe (destination) z tym adresem URL. Wybierz zdarzenia transakcji, korekt i subskrypcji.
- Skopiuj secret key miejsca docelowego, wklej go w polu Sekret podpisywania w RevGlance i zapisz.
Co synchronizuje RevGlance
- Transakcje opłacone lub zakończone, z klientem i adresem.
- Korekty: zatwierdzone zwroty i obciążenia zwrotne stają się zwrotami i znikają, gdy zostaną cofnięte.
- Subskrypcje, na potrzeby MRR, planów, okresów próbnych i anulowań, z rabatami cyklicznymi odjętymi od MRR.
- Klienci, aktywni i zarchiwizowani.
Paddle nie przechowuje powodów anulowania, więc anulowania docierają bez nich.
Jak liczony jest Paddle
- Kwoty pochodzą z sum wypłat Paddle, przed podatkiem, z opłatą Paddle jako prowizją.
- Zwroty i obciążenia zwrotne liczą się przed podatkiem. Obciążenie zwrotne wygrane przez Paddle lub zwrot cofnięty przez Paddle przestaje się liczyć.
- Prowizja za obciążenie zwrotne zatrzymana przez Paddle liczy się jako prowizja.
- Cena z podatkiem liczy się w MRR przed podatkiem, w proporcji podatku z następnej faktury.
- Cykliczne rabaty obniżają MRR, także gdy rabat został później zarchiwizowany.
- Płatność, której nie udało się pobrać, liczy się jako nieudana płatność. Nie przenosi pieniędzy.
E-maile odzyskiwania
Odzyskaj łączy każdą nieudaną płatność z checkoutem aktualizacji metody płatności Paddle. Wymaga to uprawnienia transaction.write w kluczu; bez niego e-mail prowadzi do twojej własnej strony aktualizacji karty.