Sprievodca integráciou Stripe Apps

Stripe Apps umožňujú vkladať vlastnú funkcionalitu priamo do Stripe Dashboard, čím obchodníkom poskytujú prístup k integrácii Tajo Brevo bez opustenia ich platobného pracovného toku. Táto príručka pokrýva všetko, čo potrebujete na vytvorenie, testovanie a publikovanie Stripe App, ktorá prepája Stripe s Brevo cez Tajo.

Čo sú Stripe Apps?

Stripe Apps rozširujú Stripe Dashboard o vlastné UI komponenty a backendové integrácie. Umožňujú vývojárom tretích strán:

• Pridávať vlastné pohľady na stránky Stripe Dashboard (zákazníci, platby, faktúry atď.)
• Pristupovať k dátam Stripe cez obmedzenú oprávnenia
• Synchronizovať dáta medzi Stripe a externými platformami ako Brevo
• Poskytovať onboardingové a konfiguračné toky v rámci Dashboardu

Ciele integrácie Tajo + Brevo

Stripe App Tajo prepája Stripe s Brevo a poskytuje:

• Customer Intelligence: Synchronizácia profilov zákazníkov Stripe, histórie platieb a celoživotnej hodnoty do kontaktov Brevo
• Sledovanie udalostí: Odosielanie udalostí Stripe (platby, predplatné, vrátenia) ako transakčné udalosti Brevo
• Automatizované kampane: Spúšťanie emailových, SMS a WhatsApp kampaní Brevo na základe aktivity Stripe
• Vernostné programy: Budovanie retenčných pracovných tokov pomocou nákupných dát Stripe synchronizovaných do Brevo

Prehľad architektúry

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Stripe Dashboard │────▶│   Tajo Platform  │────▶│     Brevo       │
│  (Stripe App UI) │◀────│   (Middleware)    │◀────│   (CRM/Email)   │
└─────────────────┘     └─────────────────┘     └─────────────────┘
        │                        │                        │
   Pohľady zákazníkov      Synchronizácia dát &      Kontakty,
   Detaily platieb          Smerovanie udalostí       Kampane,
   Nastavenia App            Spracovanie webhookov     Automatizácie

Obsah príručky

Začíname

Konfigurácia a referencia

Funkcie a integrácia

Operácie a rast

Predpoklady

Pred vytvorením Stripe App sa uistite, že máte:

1. Účet Stripe: Aktivovaný účet Stripe (nie obmedzený len na testovací režim)
2. Stripe CLI: Nainštalujte Stripe CLI pre lokálny vývoj a nahrávanie aplikácií
3. Node.js: Verzia 16 alebo novšia pre rozšírenie UI aplikácie
4. Prístup k platforme Tajo: Aktívny účet Tajo s nakonfigurovanými prihlasovacími údajmi Brevo API

Rýchly štart

# Nainštalujte Stripe CLI
brew install stripe/stripe-cli/stripe

# Prihláste sa do vášho účtu Stripe
stripe login

# Vytvorte nový projekt Stripe App
stripe apps create tajo-brevo-integration

# Spustite lokálny vývoj
stripe apps start

Kľúčové koncepty

App Manifest

Každá Stripe App má manifest stripe-app.json, ktorý deklaruje oprávnenia, viewporty a konfiguráciu. Pozrite Referenciu App Manifest pre úplnú schému.

UI Extensions

Stripe Apps môžu vykresľovať React-based UI komponenty v špecifických viewportoch Dashboardu. Toolkit UI poskytuje predbudované komponenty, ktoré zodpovedajú dizajnovému systému Stripe Dashboard.

Oprávnenia

Apps musia deklarovať špecifické zdroje Stripe API, ku ktorým potrebujú prístup. Používatelia tieto oprávnenia schvaľujú počas inštalácie. Pozrite Referenciu oprávnení.

Podpisový tajný kľúč

Každá aplikácia dostáva podpisový tajný kľúč na overovanie podpisov inštalácie a zabezpečenie komunikácie medzi vaším backendom a Stripe.

Vývojový pracovný tok

1. Definujte váš manifest s požadovanými oprávneniami a viewportmi
2. Vytvorte rozšírenie UI pomocou React komponentovej knižnice Stripe
3. Implementujte backendové endpointy pre synchronizáciu dát s Brevo cez Tajo
4. Testujte lokálne pomocou stripe apps start
5. Nahrajte pomocou stripe apps upload
6. Odošlite na preskúmanie cez Stripe Dashboard
7. Publikujte a monitorujte cez analytiku

Ďalšie kroky

Začnite s Príručkou publikovania na pochopenie úplných požiadaviek, potom prejdite technickými referenciami na konfiguráciu manifestu a oprávnení aplikácie.