Požiadajte o skorý prístup

Uveďte svoje krstné meno a e-mailovú adresu alebo telefónne číslo. Pošleme Vám podrobnosti o prístupe k platforme Tajo.

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

Kam putujú dáta Stripe aplikácie
Kam putujú dáta Stripe aplikácie Stripe Dashboard a Tajo si vymieňajú dáta o zákazníkoch a platbách a Tajo synchronizuje kontakty, kampane a automatizácie s Brevo. Stripe Dashboard Stripe App UI Pohľady zákazníkov Detaily platieb Nastavenia aplikácie Tajo middleware Synchronizácia dát Smerovanie udalostí Spracovanie webhookov Brevo CRM + e-mail Kontakty Kampane Automatizácie

Obsah príručky

Táto dokumentácia pokrýva celý životný cyklus vytvorenia a publikovania Stripe App:

Začíname

PríručkaPopis
Publikovanie na MarketplacePož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čkaPopis
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 viewportovMiesta v Dashboarde, kde sa môže zobraziť UI Vašej aplikácie

Funkcie a integrácia

PríručkaPopis
Vložené Stripe AppsPoužívanie Connect vložených komponentov pre platformové integrácie
Inštalačné a hĺbkové odkazyGenerovanie inštalačných URL a hĺbkové prepojenie na konkrétne pohľady aplikácie
Akcie po inštaláciiKonfigurácia onboardingových tokov po inštalácii aplikácie

Operácie a rast

PríručkaPopis
Analytika aplikácieSledovanie inštalácií, pohľadov a konverzných metrík
Partnerský ekosystémVyužívanie partnerského programu Stripe pre co-marketing 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

Terminal window
# 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

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. 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

  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

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.

Požiadajte o skorý prístup

Uveďte svoje krstné meno a e-mailovú adresu alebo telefónne číslo. Pošleme Vám podrobnosti o prístupe k platforme Tajo.

automatické rozpoznanie
AI asistent

Ahoj! Opýtajte sa ma na dokumentáciu.