Ghid de integrare cu Stripe Apps

Stripe Apps îți permit să integrezi funcționalități proprii direct în Stripe Dashboard. Această secțiune este un ghid de construcție: documentează cum ar fi construită, testată și publicată o astfel de aplicație pentru integrarea dintre Tajo și Brevo.

Ce sunt Stripe Apps?

Stripe Apps extind Stripe Dashboard cu componente de interfață proprii și integrări de backend. Ele le permit dezvoltatorilor terți:

• Să adauge vizualizări proprii în paginile din Stripe Dashboard (clienți, plăți, facturi etc.)
• Să acceseze datele din Stripe prin permisiuni delimitate
• Să sincronizeze date între Stripe și platforme externe precum Brevo
• Să ofere fluxuri de inițiere și configurare chiar în Dashboard

Obiectivele integrării Tajo + Brevo

Aplicația Stripe de la Tajo conectează Stripe cu Brevo ca să livreze:

• Informații despre clienți: sincronizează profilurile clienților din Stripe, istoricul plăților și valoarea pe durata de viață în contactele din Brevo
• Urmărirea evenimentelor: trimite evenimentele din Stripe (plăți, abonamente, rambursări) ca evenimente tranzacționale în Brevo
• Campanii automatizate: declanșează campanii de e-mail, SMS și WhatsApp din Brevo pe baza activității din Stripe
• Programe de fidelitate: creează fluxuri de retenție folosind datele de cumpărare din Stripe sincronizate în Brevo

Prezentare generală a arhitecturii

Cuprinsul ghidului

Această documentație acoperă tot ciclul de viață al construirii și publicării unei aplicații Stripe:

Primii pași

Configurare și referință

Funcționalități și integrare

Operare și creștere

Cerințe preliminare

Înainte să construiești o aplicație Stripe, asigură-te că ai:

1. Cont Stripe: un cont Stripe activat (nu limitat la modul de test)
2. Stripe CLI: instalează Stripe CLI pentru dezvoltare locală și încărcarea aplicației
3. Node.js: versiunea 16 sau mai nouă pentru extensia de interfață a aplicației
4. Acces la platforma Tajo: cont Tajo activ, cu credențialele API Brevo configurate

Start rapid

# Install Stripe CLI
brew install stripe/stripe-cli/stripe

# Login to your Stripe account
stripe login

# Create a new Stripe App project
stripe apps create tajo-brevo-integration

# Start local development
stripe apps start

Concepte importante

Manifestul aplicației

Fiecare aplicație Stripe are un manifest stripe-app.json care declară permisiunile, viewporturile și configurarea. Vezi Referința manifestului aplicației pentru schema completă.

Extensii de interfață

Aplicațiile Stripe pot randa componente de interfață bazate pe React în viewporturi anume din Dashboard. Setul de instrumente de interfață oferă componente gata făcute, potrivite cu design systemul din Stripe Dashboard.

Permisiuni

Aplicațiile trebuie să declare resursele exacte din API-ul Stripe la care au nevoie de acces. Utilizatorii aprobă aceste permisiuni în timpul instalării. Vezi Referința permisiunilor.

Secretul de semnare

Fiecare aplicație primește un secret de semnare pentru verificarea semnăturilor de instalare și pentru securizarea comunicării dintre backendul tău și Stripe.

Fluxul de dezvoltare

1. Definește manifestul cu permisiunile și viewporturile necesare
2. Construiește extensia de interfață folosind biblioteca de componente React de la Stripe
3. Implementează endpointurile de backend pentru sincronizarea datelor cu Brevo prin Tajo
4. Testează local cu stripe apps start
5. Încarcă cu stripe apps upload
6. Trimite la evaluare din Stripe Dashboard
7. Publică și urmărește rezultatele în analytics

Pașii următori

Începe cu Ghidul de publicare ca să înțelegi toate cerințele, apoi parcurge referințele tehnice ca să configurezi manifestul și permisiunile aplicației tale.