Konektor Stripe
Propojte svůj účet Stripe s Tajo a synchronizujte platební data pouze pro čtení, tedy zákazníky, platby, předplatná a faktury, do rozpoznávání kontaktů, segmentace a automatizací řízených příjmy (přes Brevo a další poskytovatele zapojení).
Přehled
| Vlastnost | Hodnota |
|---|---|
| Ověření | Tajný klíč Stripe (sk_live_... / sk_test_...) nebo omezený klíč |
| Přístup | Pouze pro čtení, Tajo do Vašeho účtu Stripe nikdy nezapisuje |
| Základní API | https://api.stripe.com/v1 |
| Směr synchronizace | Stripe → Tajo |
| Webhooky v reálném čase | Zatím ne, synchronizace dnes probíhá dotazováním |
Nastavení
- V Stripe Dashboard otevřete Developers → API keys.
- Vytvořte omezený klíč, stačí oprávnění pro čtení u zdrojů Customers, Charges, Subscriptions a Invoices. Omezený klíč je výrazně vhodnější než plný tajný klíč: Tajo pouze čte, udělte tedy jen čtení.
- Vložte klíč do připojení Stripe v Tajo.
Připojení se před zahájením jakékoli synchronizace ověří požadavkem pouze pro čtení. Klíč můžete ve Stripe kdykoli obnovit nebo odvolat.
Co se synchronizuje
| Data | Co s nimi Tajo dělá |
|---|---|
| Zákazníci | Rozpoznají se do kontaktů (e-mail, jméno, telefon, adresa) pro identitu a segmentaci. Souhlas se nikdy neodvozuje z existence záznamu zákazníka. |
| Platby | Příjmové události pro automatizace životního cyklu podle nákupů a segmentaci podle LTV |
| Předplatná | Stav životního cyklu (active, past_due, canceled…) pro upomínky, získání zákazníka zpět a retenční toky |
| Faktury | Stav platby pro zprávy související s fakturací |
Stránkování používá kurzorový model Stripe (starting_after), takže i velké účty se synchronizují kompletně a s možností navázat.
Aktuální omezení
Uvádíme je na rovinu, abyste s nimi mohli počítat:
- Zatím žádné webhooky v reálném čase. Změny přicházejí podle plánu synchronizace, nikoli ve chvíli, kdy platba proběhne. Příjem webhooků je v plánu vývoje.
- Pouze pro čtení. Tajo ve Stripe nevytváří ani neupravuje zákazníky, platby ani předplatná.
- Žádná Stripe App. Na Stripe App Marketplace dnes žádná aplikace Tajo není; připojení se nastavuje v Tajo, nikoli ve Stripe Dashboard.
Řešení potíží
| Příznak | Příčina a náprava |
|---|---|
| 401 ze Stripe | Klíč byl odvolán nebo obnoven, vložte do připojení aktuální klíč |
| Zákazníci se synchronizují, ale platby ne | Omezenému klíči chybí oprávnění pro čtení u zdroje Charges |
| Kontakt nemá e-mail | Zákazníci ze Stripe bez e-mailu se synchronizují jako anonymní příjmové záznamy; do grafu kontaktů se připojí, jakmile e-mail doplníte |
Další kroky
- Synchronizace zákazníků: mapování zákazníků ze Stripe do Vašeho systému záznamů
- Postavte v Tajo automatizace pro upomínky a získání zákazníka zpět nad změnami stavu předplatného