Konektor Stripe
Połącz swoje konto Stripe z Tajo, aby synchronizować tylko do odczytu dane płatnicze (klientów, obciążenia, subskrypcje i faktury) na potrzeby rozpoznawania kontaktów, segmentacji i automatyzacji opartych na przychodach (przez Brevo i innych dostawców zaangażowania).
Przegląd
| Właściwość | Wartość |
|---|---|
| Uwierzytelnianie | Tajny klucz Stripe (sk_live_... / sk_test_...) albo klucz ograniczony |
| Dostęp | Tylko do odczytu: Tajo nigdy nie zapisuje danych na Twoim koncie Stripe |
| Bazowe API | https://api.stripe.com/v1 |
| Kierunek synchronizacji | Stripe → Tajo |
| Webhooki w czasie rzeczywistym | Jeszcze nie: dziś synchronizacja opiera się na odpytywaniu |
Konfiguracja
- W panelu Stripe otwórz Developers → API keys.
- Utwórz restricted key: wystarczy uprawnienie odczytu dla Customers, Charges, Subscriptions i Invoices. Klucz ograniczony jest zdecydowanie lepszy od pełnego klucza tajnego: Tajo tylko czyta, więc przyznaj wyłącznie odczyt.
- Wklej klucz do połączenia Stripe w Tajo.
Połączenie jest weryfikowane zapytaniem tylko do odczytu, zanim ruszy jakakolwiek synchronizacja. Klucz możesz w każdej chwili zmienić lub unieważnić w Stripe.
Co się synchronizuje
| Dane | Co Tajo z nimi robi |
|---|---|
| Klienci | Rozpoznawani jako kontakty (email, imię i nazwisko, telefon, adres) na potrzeby tożsamości i segmentacji. Zgoda nigdy nie jest wnioskowana z samego istnienia rekordu klienta. |
| Obciążenia | Zdarzenia przychodowe dla automatyzacji cyklu życia opartych na zakupach i segmentacji według LTV |
| Subskrypcje | Status cyklu życia (active, past_due, canceled…) dla procesów windykacyjnych, win-back i retencyjnych |
| Faktury | Status płatności dla komunikacji okołorozliczeniowej |
Paginacja korzysta z modelu kursorowego Stripe (starting_after), więc duże konta synchronizują się w całości i z możliwością wznowienia.
Obecne ograniczenia
Mówimy o nich wprost, żebyś mógł je uwzględnić w planach:
- Na razie brak webhooków w czasie rzeczywistym. Zmiany docierają zgodnie z harmonogramem synchronizacji, a nie w chwili, gdy płatność się powiedzie. Odbieranie webhooków jest w planach.
- Tylko do odczytu. Tajo nie tworzy ani nie modyfikuje klientów, płatności ani subskrypcji w Stripe.
- Brak aplikacji Stripe. W Stripe App Marketplace nie ma dziś żadnej aplikacji Tajo; połączenie konfigurujesz w Tajo, a nie w panelu Stripe.
Rozwiązywanie problemów
| Objaw | Przyczyna i rozwiązanie |
|---|---|
| 401 ze Stripe | Klucz został unieważniony lub zmieniony: wklej do połączenia aktualny klucz |
| Klienci się synchronizują, a obciążenia nie | Ograniczonemu kluczowi brakuje uprawnienia odczytu dla Charges |
| Kontakt nie ma adresu email | Klienci Stripe bez adresu email synchronizują się jako anonimowe rekordy przychodowe; dołączają do grafu kontaktów, jeśli adres zostanie dodany później |
Kolejne kroki
- Synchronizacja klientów: mapowanie klientów Stripe do Twojego systemu źródła prawdy
- Zbuduj w Tajo automatyzacje windykacyjne i win-back na zmianach statusu subskrypcji