Stripe
Połącz Stripe ograniczonym kluczem tylko do odczytu, a potem dodaj webhook, aby nowe płatności pojawiały się od razu.
RevGlance odczytuje twoje konto Stripe przez API Stripe kluczem, który tworzysz. Odczytuje płatności, zwroty, prowizje, spory i subskrypcje i nigdy nie pobiera płatności, nie zwraca pieniędzy ani niczego nie zmienia.
Zanim zaczniesz
- Musisz być właścicielem lub administratorem firmy w RevGlance. Przeglądający nie mogą dodawać źródeł.
- Użyj klucza ograniczonego zamiast klucza tajnego. RevGlance akceptuje oba (
rk_…lubsk_…), ale klucz ograniczony może odczytywać tylko to, na co pozwolisz. - Klucze trybu testowego też działają, co przydaje się na początek. Gdy wszystko będzie gotowe, połącz drugie źródło kluczem produkcyjnym.
Połączenie
- W Stripe Dashboard otwórz Developers › API keys i wybierz Create restricted key. Nazwij go RevGlance.
- Nadaj mu dostęp Read do Balance, Charges, Customers, Disputes, Invoices, Checkout Sessions, Subscriptions i Coupons. Wszystko inne zostaw na None.
- Utwórz klucz i go skopiuj. Zaczyna się od
rk_live_. - Wklej go w polu Klucz ograniczony i wybierz Połącz Stripe. Pierwsza synchronizacja odczytuje całą twoją historię.
O co pyta formularz
| Pole | Wygląda tak |
|---|---|
| Klucz ograniczonyPrzechowywane w postaci zaszyfrowanej | rk_live_… |
Pole Nazwa jest opcjonalne. Pozwala rozróżnić dwa konta Stripe w jednej firmie.
Dodawanie webhooka
Bez webhooka RevGlance synchronizuje Stripe co godzinę. Z webhookiem nowa płatność, zwrot lub anulowanie kolejkuje synchronizację w ciągu kilku sekund.
- W RevGlance otwórz Ustawienia › Źródła, znajdź źródło Stripe, otwórz jego menu i wybierz Webhook. Skopiuj adres URL.
- W Stripe otwórz Developers › Webhooks i dodaj punkt końcowy z tym adresem URL.
- Wybierz zdarzenia, które zmieniają twoje liczby:
charge.succeeded,charge.failed,charge.refunded,charge.dispute.closed,customer.subscription.created,customer.subscription.updated,customer.subscription.deletediinvoice.paid. Każde zdarzenie zadziała: każde po prostu uruchamia synchronizację. - Skopiuj signing secret punktu końcowego (
whsec_…), wklej go w polu Sekret podpisywania w RevGlance i zapisz.
Co synchronizuje RevGlance
- Transakcje salda (balance transactions): każda płatność, zwrot, spór i prowizja Stripe, w walucie, w której Stripe je rozliczył.
- Nieudane płatności, na potrzeby wskaźnika nieudanych płatności i funkcji Odzyskaj.
- Subskrypcje w każdym statusie, z klientem, pozycjami, rabatami i ostatnią fakturą, na potrzeby MRR, planów, okresów próbnych i anulowań. Powód anulowania ze Stripe i komentarz klienta są pobierane, gdy Stripe je ma.
Pierwsza synchronizacja odczytuje całą twoją historię. Potem każda synchronizacja odczytuje dane od trzech dni przed poprzednią, więc późne zmiany zostają wychwycone, a subskrypcje są za każdym razem odczytywane w całości.
Jak liczony jest Stripe
- Płatności, zwroty i prowizje Stripe pochodzą z transakcji salda, w walucie, w której Stripe je rozliczył.
- Zwroty kartowe liczą się w dniu, w którym Stripe je zarejestruje. Płatności bankowe (ACH, SEPA i inne metody lokalne) też się liczą; zwrot cofnięty przez bank ponownie obniża twoje zwroty.
- Spór liczy się jako zwrot, gdy Stripe odbiera pieniądze, a zwrot jest anulowany, jeśli spór wygrasz. Opłata Stripe za spór jest liczona jako prowizja.
- Kupony na subskrypcji i na pojedynczych pozycjach obniżają MRR. Kupon o stałej kwocie liczy się tylko w swojej walucie.
- Wstrzymane i nieopłacone subskrypcje liczą się jako odpływ; zaległa liczy się dalej, gdy Stripe ponawia obciążenie karty.
- Płatności, zwroty i spory liczą się przed podatkiem, w proporcji podatku z ich faktury lub Checkout Session. Bez dostępu do odczytu Checkout Sessions podatek od sprzedaży poza fakturą pozostaje wliczony.
- Cena z podatkiem liczy się w MRR przed podatkiem, w proporcji podatku z ostatniej faktury.
- Wstrzymanie pobierania płatności liczy się jako odpływ od dnia, w którym RevGlance pierwszy raz je zobaczy, bo Stripe nie podaje jego daty.
Zobacz Jak liczymy, aby poznać reguły obowiązujące każdego dostawcę.
E-maile odzyskiwania
Odzyskaj łączy nieudaną płatność za subskrypcję ze stroną jej otwartej faktury w Stripe, gdzie klient może zapłacić nową kartą. Gdy nie ma otwartej faktury, otwiera zamiast tego sesję portalu klienta Stripe. Ta alternatywa wymaga włączenia portalu w Stripe i klucza z uprawnieniem do zapisu sesji Customer portal; bez tego e-mail prowadzi do twojej własnej strony aktualizacji karty.
Rozwiązywanie problemów
- „Wklej tajny lub ograniczony klucz Stripe.” Klucz musi zaczynać się od
rk_lubsk_. Klucz publikowany (pk_) nie może niczego odczytać. - „Stripe refused that key.” Klucz został unieważniony lub nie ma dostępu do odczytu Balance.
- „Stripe refused the failed-charge request” lub „the subscription request”: klucz nie może odczytywać Charges lub Subscriptions. Płatności nadal się synchronizują; dodaj brakujące uprawnienie i zsynchronizuj ponownie.

RevGlance