Conector Stripe
Conectează contul tău Stripe la Tajo pentru sincronizarea doar de citire a datelor de plată (clienți, plăți, abonamente și facturi) și folosește-le în rezolvarea contactelor, în segmentare și în automatizări bazate pe venit (prin Brevo și alți furnizori de interacțiune).
Prezentare generală
| Proprietate | Valoare |
|---|---|
| Autentificare | Cheie secretă Stripe (sk_live_... / sk_test_...) sau cheie restricționată |
| Acces | Doar de citire. Tajo nu scrie niciodată în contul tău Stripe |
| API de bază | https://api.stripe.com/v1 |
| Direcția sincronizării | Stripe → Tajo |
| Webhookuri în timp real | Încă nu. Astăzi sincronizarea se face prin interogare periodică |
Configurare
- În Stripe Dashboard, deschide Developers → API keys.
- Creează o cheie restricționată, iar permisiunea de citire pe Customers, Charges, Subscriptions și Invoices este suficientă. O cheie restricționată este mult de preferat cheii secrete complete: Tajo doar citește, deci acordă doar drepturi de citire.
- Lipește cheia în conexiunea Stripe din Tajo.
Conexiunea este validată cu o cerere doar de citire înainte să înceapă orice sincronizare. Poți roti sau revoca cheia în Stripe oricând.
Ce se sincronizează
| Date | Ce face Tajo cu ele |
|---|---|
| Clienți | Sunt rezolvați în contacte (e-mail, nume, telefon, adresă) pentru identitate și segmentare. Consimțământul nu este niciodată dedus din simpla existență a unei înregistrări de client. |
| Plăți | Evenimente de venit pentru automatizări de ciclu de viață bazate pe cumpărare și pentru segmentare după LTV |
| Abonamente | Statusul din ciclul de viață (active, past_due, canceled…) pentru fluxuri de recuperare a plăților restante, de recâștigare și de retenție |
| Facturi | Statusul plății pentru mesajele legate de facturare |
Paginarea folosește modelul cu cursor al Stripe (starting_after), așa că și conturile mari se sincronizează complet și se pot relua din punctul în care au rămas.
Limitări actuale
Spuse pe șleau, ca să îți poți face planul în jurul lor:
- Încă nu există webhookuri în timp real. Modificările ajung la ora programată a sincronizării, nu în clipa în care o plată reușește. Preluarea prin webhook este pe foaia de parcurs.
- Doar de citire. Tajo nu creează și nu modifică clienți, plăți sau abonamente în Stripe.
- Nu există o aplicație Stripe. Astăzi nu există nicio aplicație Tajo în Stripe App Marketplace; conexiunea se configurează în Tajo, nu în Stripe Dashboard.
Depanare
| Simptom | Cauză și rezolvare |
|---|---|
| 401 de la Stripe | Cheia a fost revocată sau rotită. Lipește cheia actuală în conexiune |
| Clienții se sincronizează, dar plățile nu | Cheii restricționate îi lipsește permisiunea de citire pe Charges |
| Contactul nu are e-mail | Clienții Stripe fără e-mail se sincronizează ca înregistrări de venit anonime; intră în graful de contacte dacă e-mailul este adăugat mai târziu |
Pașii următori
- Sincronizarea clienților: cum mapezi clienții Stripe în sistemul tău de evidență
- Construiește în Tajo automatizări de recuperare a plăților restante și de recâștigare pe baza schimbărilor de status ale abonamentelor