RevGlanceDokumentacja

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_… lub sk_…), 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

  1. W Stripe Dashboard otwórz Developers › API keys i wybierz Create restricted key. Nazwij go RevGlance.
  2. Nadaj mu dostęp Read do Balance, Charges, Customers, Disputes, Invoices, Checkout Sessions, Subscriptions i Coupons. Wszystko inne zostaw na None.
  3. Utwórz klucz i go skopiuj. Zaczyna się od rk_live_.
  4. Wklej go w polu Klucz ograniczony i wybierz Połącz Stripe. Pierwsza synchronizacja odczytuje całą twoją historię.

O co pyta formularz

PoleWygląda tak
Klucz ograniczonyPrzechowywane w postaci zaszyfrowanejrk_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.

  1. W RevGlance otwórz Ustawienia › Źródła, znajdź źródło Stripe, otwórz jego menu i wybierz Webhook. Skopiuj adres URL.
  2. W Stripe otwórz Developers › Webhooks i dodaj punkt końcowy z tym adresem URL.
  3. Wybierz zdarzenia, które zmieniają twoje liczby: charge.succeeded, charge.failed, charge.refunded, charge.dispute.closed, customer.subscription.created, customer.subscription.updated, customer.subscription.deleted i invoice.paid. Każde zdarzenie zadziała: każde po prostu uruchamia synchronizację.
  4. 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_ lub sk_. 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.