Konektor Stripe
Povežite svoj račun Stripe s Tajom za sinhronizacijo plačilnih podatkov samo za branje (stranke, bremenitve, naročnine in računi) v razreševanje kontaktov, segmentacijo in avtomatizacije, ki jih poganjajo prihodki (prek platforme Brevo in drugih ponudnikov sodelovanja).
Pregled
| Lastnost | Vrednost |
|---|---|
| Overjanje | Skrivni ključ Stripe (sk_live_... / sk_test_...) ali omejeni ključ |
| Dostop | Samo za branje, Tajo v vaš račun Stripe nikoli ne piše |
| Osnovni API | https://api.stripe.com/v1 |
| Smer sinhronizacije | Stripe → Tajo |
| Webhooki v realnem času | Še ne, sinhronizacija danes poteka s poizvedovanjem |
Nastavitev
- V Stripe Dashboard odprite Developers → API keys.
- Ustvarite omejeni ključ. Zadostuje dovoljenje za branje za Customers, Charges, Subscriptions in Invoices. Omejeni ključ je močno priporočljivejši od polnega skrivnega ključa: Tajo samo bere, zato dodelite samo branje.
- Ključ prilepite v povezavo Stripe v Tajo.
Povezava se pred začetkom kakršne koli sinhronizacije preveri z zahtevo samo za branje. Ključ lahko v Stripe kadar koli zamenjate ali prekličete.
Kaj se sinhronizira
| Podatki | Kaj Tajo počne z njimi |
|---|---|
| Stranke | Razrešijo se v kontakte (e-pošta, ime, telefon, naslov) za identiteto in segmentacijo. Privolitev se nikoli ne sklepa iz tega, da zapis stranke obstaja. |
| Bremenitve | Dogodki prihodkov za avtomatizacije življenjskega cikla na podlagi nakupov in segmentacijo po LTV |
| Naročnine | Stanje življenjskega cikla (active, past_due, canceled…) za opomine, vračanje strank in tokove zadrževanja |
| Računi | Stanje plačila za sporočila, povezana z zaračunavanjem |
Paginacija uporablja kazalčni model Stripe (starting_after), zato se veliki računi sinhronizirajo v celoti in z možnostjo nadaljevanja.
Trenutne omejitve
Navedene so naravnost, da jih lahko upoštevate pri načrtovanju:
- Webhookov v realnem času še ni. Spremembe prispejo po urniku sinhronizacije, ne v trenutku, ko plačilo uspe. Sprejem webhookov je na načrtu.
- Samo za branje. Tajo v Stripe ne ustvarja in ne spreminja strank, plačil ali naročnin.
- Ni aplikacije Stripe App. Na Stripe App Marketplace danes ni nobene aplikacije Tajo; povezava se nastavi v Tajo, ne v Stripe Dashboard.
Odpravljanje težav
| Znak | Vzrok in rešitev |
|---|---|
| 401 iz Stripe | Ključ je bil preklican ali zamenjan; v povezavo prilepite trenutni ključ |
| Stranke se sinhronizirajo, bremenitve ne | Omejenemu ključu manjka dovoljenje za branje za Charges |
| Kontakt nima e-poštnega naslova | Stranke Stripe brez e-poštnega naslova se sinhronizirajo kot anonimni zapisi o prihodkih; v graf kontaktov se pridružijo, ko je e-poštni naslov pozneje dodan |
Naslednji koraki
- Sinhronizacija strank: preslikava strank Stripe v vaš sistem zapisov
- V Tajo zgradite avtomatizacije za opomine in vračanje strank ob spremembah stanja naročnine