Sprievodca integráciou Stripe Apps
Stripe Apps umožňujú vkladať vlastnú funkcionalitu priamo do Stripe Dashboard. Táto sekcia je príručkou pre vývoj: opisuje, ako by sa taká aplikácia pre integráciu Tajo–Brevo vytvorila, otestovala a publikovala.
Caution
Stav: zatiaľ nepublikované. Na Stripe App Marketplace dnes žiadna aplikácia Tajo nie je a identifikátory aplikácie, URL a prihlasovacie údaje na týchto stránkach sú ilustratívne zástupné hodnoty, nie funkčné endpointy. Ak chcete Stripe prepojiť s Tajo hneď teraz, použite konektor Stripe (obmedzený API kľúč, synchronizácia len na čítanie).
Tip
Cieľom je publikovať integráciu Brevo na Stripe App Marketplace, čo umožní obchodníkom Stripe synchronizovať zákaznícke dáta, objednávky a udalosti priamo do Brevo pre marketingové automatizácie a CRM.
Č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 e-mailový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
Obsah príručky
Táto dokumentácia pokrýva celý životný cyklus vytvorenia a publikovania Stripe App:
Začíname
| Príručka | Popis |
|---|---|
| Publikovanie na Marketplace | Požiadavky a kroky na odoslanie aplikácie na preskúmanie |
| Požiadavky na preskúmanie aplikácie | Štandardy kvality, bezpečnosti a UX na schválenie |
Konfigurácia a referencia
| Príručka | Popis |
|---|---|
| Referencia App Manifest | Úplná schéma pre súbor manifestu stripe-app.json |
| Referencia oprávnení | Úplný zoznam oprávnení Stripe API a ako o ne požiadať |
| Referencia viewportov | Miesta v Dashboarde, kde sa môže zobraziť UI Vašej aplikácie |
Funkcie a integrácia
| Príručka | Popis |
|---|---|
| Vložené Stripe Apps | Používanie Connect vložených komponentov pre platformové integrácie |
| Inštalačné a hĺbkové odkazy | Generovanie inštalačných URL a hĺbkové prepojenie na konkrétne pohľady aplikácie |
| Akcie po inštalácii | Konfigurácia onboardingových tokov po inštalácii aplikácie |
Operácie a rast
| Príručka | Popis |
|---|---|
| Analytika aplikácie | Sledovanie inštalácií, pohľadov a konverzných metrík |
| Partnerský ekosystém | Využívanie partnerského programu Stripe pre co-marketing a rast |
Predpoklady
Pred vytvorením Stripe App sa uistite, že máte:
- Účet Stripe: Aktivovaný účet Stripe (nie obmedzený len na testovací režim)
- Stripe CLI: Nainštalujte Stripe CLI pre lokálny vývoj a nahrávanie aplikácií
- Node.js: Verzia 16 alebo novšia pre rozšírenie UI aplikácie
- Prístup k platforme Tajo: Aktívny účet Tajo s nakonfigurovanými prihlasovacími údajmi Brevo API
Rýchly štart
# Install Stripe CLIbrew install stripe/stripe-cli/stripe
# Login to your Stripe accountstripe login
# Create a new Stripe App projectstripe apps create tajo-brevo-integration
# Start local developmentstripe apps startKľúč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. UI toolkit poskytuje hotové komponenty, ktoré zodpovedajú dizajnovému systému Stripe Dashboard.
Oprávnenia
Aplikácie 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
- Definujte Váš manifest s požadovanými oprávneniami a viewportmi
- Vytvorte rozšírenie UI pomocou React komponentovej knižnice Stripe
- Implementujte backendové endpointy pre synchronizáciu dát s Brevo cez Tajo
- Testujte lokálne pomocou
stripe apps start - Nahrajte pomocou
stripe apps upload - Odošlite na preskúmanie cez Stripe Dashboard
- Publikujte a monitorujte cez analytiku
Caution
Stripe vyžaduje, aby boli aplikácie napísané v angličtine pre distribúciu na marketplace. Záznam Vašej aplikácie, text UI a dokumentácia musia byť všetky v angličtine.
Ď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.