Konektor Stripe
Prepojte svoj účet Stripe s Tajo pre synchronizáciu platobných dát len na čítanie (zákazníci, platby, predplatné a faktúry) do priraďovania kontaktov, segmentácie a automatizácií riadených tržbami (cez Brevo a ďalších poskytovateľov zapojenia).
Prehľad
| Vlastnosť | Hodnota |
|---|---|
| Autentifikácia | Tajný kľúč Stripe (sk_live_... / sk_test_...) alebo obmedzený kľúč |
| Prístup | Len na čítanie, Tajo do Vášho účtu Stripe nikdy nezapisuje |
| Základné API | https://api.stripe.com/v1 |
| Smer synchronizácie | Stripe → Tajo |
| Webhooky v reálnom čase | Zatiaľ nie, synchronizácia dnes prebieha dopytovaním |
Nastavenie
- V Stripe Dashboard otvorte Developers → API keys.
- Vytvorte obmedzený kľúč. Stačí oprávnenie na čítanie pre Customers, Charges, Subscriptions a Invoices. Obmedzený kľúč je výrazne vhodnejší než plný tajný kľúč: Tajo iba číta, preto udeľte iba čítanie.
- Vložte kľúč do prepojenia Stripe v Tajo.
Prepojenie sa pred spustením akejkoľvek synchronizácie overí požiadavkou len na čítanie. Kľúč môžete v Stripe kedykoľvek vymeniť alebo zrušiť.
Čo sa synchronizuje
| Dáta | Čo s nimi Tajo robí |
|---|---|
| Zákazníci | Priradia sa ku kontaktom (e-mail, meno, telefón, adresa) pre identitu a segmentáciu. Súhlas sa nikdy neodvodzuje z toho, že záznam zákazníka existuje. |
| Platby | Udalosti tržieb pre automatizácie životného cyklu podľa nákupov a segmentáciu podľa LTV |
| Predplatné | Stav životného cyklu (active, past_due, canceled…) pre upomienky, znovuzískanie zákazníkov a retenčné toky |
| Faktúry | Stav platby pre komunikáciu súvisiacu s fakturáciou |
Stránkovanie využíva kurzorový model Stripe (starting_after), takže veľké účty sa synchronizujú úplne a s možnosťou pokračovania.
Aktuálne obmedzenia
Uvádzame ich priamo, aby ste s nimi mohli počítať:
- Zatiaľ žiadne webhooky v reálnom čase. Zmeny prichádzajú podľa plánu synchronizácie, nie v okamihu, keď platba prejde. Príjem webhookov je na pláne.
- Len na čítanie. Tajo v Stripe nevytvára ani nemení zákazníkov, platby ani predplatné.
- Žiadna Stripe App. Na Stripe App Marketplace dnes žiadna aplikácia Tajo nie je; prepojenie sa nastavuje v Tajo, nie v Stripe Dashboard.
Riešenie problémov
| Prejav | Príčina a riešenie |
|---|---|
| 401 zo Stripe | Kľúč bol zrušený alebo vymenený; vložte do prepojenia aktuálny kľúč |
| Zákazníci sa synchronizujú, platby nie | Obmedzenému kľúču chýba oprávnenie na čítanie pre Charges |
| Kontakt nemá e-mail | Zákazníci Stripe bez e-mailu sa synchronizujú ako anonymné záznamy o tržbách; do grafu kontaktov sa pripoja, keď sa e-mail neskôr doplní |
Ďalšie kroky
- Synchronizácia zákazníkov: mapovanie zákazníkov Stripe do Vášho systému záznamov
- Postavte v Tajo automatizácie pre upomienky a znovuzískanie zákazníkov na zmenách stavu predplatného