Stripe konnektor
Kösd össze a Stripe fiókodat a Tajóval a fizetési adatok csak olvasó szinkronizálásához: a vásárlók, a terhelések, az előfizetések és a számlák a kapcsolatfeloldásba, a szegmentálásba és a bevételvezérelt automatizálásokba kerülnek (a Brevón és más ügyfélkapcsolati szolgáltatókon keresztül).
Áttekintés
| Tulajdonság | Érték |
|---|---|
| Hitelesítés | Stripe titkos kulcs (sk_live_... / sk_test_...) vagy korlátozott kulcs |
| Hozzáférés | Csak olvasás, a Tajo soha nem ír a Stripe fiókodba |
| API alapcím | https://api.stripe.com/v1 |
| Szinkronizálás iránya | Stripe → Tajo |
| Valós idejű webhookok | Még nincsenek, a szinkronizálás ma lekérdezésalapú |
Beállítás
- A Stripe irányítópulton nyisd meg a Developers → API keys oldalt.
- Hozz létre korlátozott kulcsot, elég az olvasási jog a Customers, a Charges, a Subscriptions és az Invoices erőforrásokra. A korlátozott kulcs sokkal jobb választás a teljes titkos kulcsnál: a Tajo csak olvas, ezért csak olvasási jogot adj neki.
- Illeszd be a kulcsot a Tajóban a Stripe kapcsolatba.
A kapcsolatot csak olvasó kérés ellenőrzi, mielőtt bármilyen szinkronizálás elindulna. A kulcsot bármikor lecserélheted vagy visszavonhatod a Stripe-ban.
Mi szinkronizálódik
| Adat | Mit kezd vele a Tajo |
|---|---|
| Vásárlók | Kapcsolatokká oldódnak fel (e-mail, név, telefonszám, cím) az azonosításhoz és a szegmentáláshoz. A hozzájárulást soha nem következtetjük ki abból, hogy létezik egy vásárlói rekord. |
| Terhelések | Bevételi események a vásárlásalapú életciklus-automatizálásokhoz és az LTV szerinti szegmentáláshoz |
| Előfizetések | Életciklus-státusz (active, past_due, canceled…) a fizetési emlékeztetőkhöz, a visszaszerző és a megtartási folyamatokhoz |
| Számlák | Fizetési státusz a számlázáshoz kapcsolódó üzenetekhez |
A lapozás a Stripe kurzoros modelljét (starting_after) használja, így a nagy fiókok hiánytalanul és megszakítás után folytathatóan szinkronizálódnak.
Jelenlegi korlátok
Nyíltan kimondva, hogy tudj tervezni velük:
- Még nincsenek valós idejű webhookok. A változások a szinkronizálási ütemezés szerint érkeznek, nem abban a pillanatban, amikor egy fizetés sikerül. A webhookok fogadása a tervek között szerepel.
- Csak olvasás. A Tajo nem hoz létre és nem módosít vásárlókat, fizetéseket vagy előfizetéseket a Stripe-ban.
- Nincs Stripe app. Ma nincs Tajo app a Stripe App Marketplace-en; a kapcsolatot a Tajóban állítod be, nem a Stripe irányítópulton.
Hibaelhárítás
| Tünet | Ok és megoldás |
|---|---|
| 401 a Stripe-tól | A kulcsot visszavonták vagy lecserélték, illeszd be az aktuális kulcsot a kapcsolatba |
| A vásárlók szinkronizálódnak, a terhelések nem | A korlátozott kulcsból hiányzik a Charges olvasási joga |
| A kapcsolatnak nincs e-mail-címe | Az e-mail-cím nélküli Stripe vásárlók névtelen bevételi rekordként szinkronizálódnak; ha később bekerül az e-mail-cím, csatlakoznak a kapcsolati gráfhoz |
Következő lépések
- Vásárlószinkronizálás: a Stripe vásárlóinak leképezése a rendszernyilvántartásodba
- Építs fizetési emlékeztető és visszaszerző automatizálásokat a Tajóban az előfizetési állapotváltozásokra