On this page

Vodič za integracijo Stripe Apps

Stripe Apps vam omogočajo vdelavo lastne funkcionalnosti neposredno v Stripe Dashboard, s čimer trgovcem zagotavljajo dostop do integracije Tajo Brevo brez zapuščanja njihovega plačilnega delovnega toka. Ta vodič pokriva vse, kar potrebujete za ustvarjanje, testiranje in objavo Stripe App, ki povezuje Stripe z Brevo prek Tajo.

Tip

Cilj je objaviti integracijo Brevo na Stripe App Marketplace, kar bo trgovcem Stripe omogočilo sinhronizacijo podatkov strank, naročil in dogodkov neposredno v Brevo za marketinške avtomatizacije in CRM.

Kaj so Stripe Apps?

Stripe Apps razširjajo Stripe Dashboard z lastnimi UI komponentami in zalednimi integracijami. Razvijalcem tretjih oseb omogočajo:

Dodajanje lastnih pogledov na strani Stripe Dashboard (stranke, plačila, računi itd.)
Dostop do podatkov Stripe prek omejenih dovoljenj
Sinhronizacijo podatkov med Stripe in zunanjimi platformami, kot je Brevo
Zagotavljanje tokov vklopitve in konfiguracije znotraj Dashboarda

Cilji integracije Tajo + Brevo

Tajo Stripe App povezuje Stripe z Brevo in zagotavlja:

Customer Intelligence: Sinhronizacija profilov strank Stripe, zgodovine plačil in življenjske vrednosti v kontakte Brevo
Sledenje dogodkov: Pošiljanje dogodkov Stripe (plačila, naročnine, vračila) kot transakcijske dogodke Brevo
Avtomatizirane kampanje: Sprožanje email, SMS in WhatsApp kampanj Brevo na podlagi aktivnosti Stripe
Programi zvestobe: Gradnja delovnih tokov zadrževanja z uporabo podatkov o nakupih Stripe, sinhroniziranih v Brevo

Pregled arhitekture

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Stripe Dashboard │────▶│   Tajo Platform  │────▶│     Brevo       │
│  (Stripe App UI) │◀────│   (Middleware)    │◀────│   (CRM/Email)   │
└─────────────────┘     └─────────────────┘     └─────────────────┘
        │                        │                        │
   Pogledi strank          Sinhronizacija podatkov &  Kontakti,
   Podrobnosti plačil        Usmerjanje dogodkov       Kampanje,
   Nastavitve App             Obdelava webhookov        Avtomatizacije

Vsebina vodiča

Začetek

Vodič	Opis
Objava na Marketplace	Zahteve in koraki za oddajo aplikacije v pregled
Zahteve za pregled aplikacije	Standardi kakovosti, varnosti in UX za odobritev

Konfiguracija in referenca

Vodič	Opis
Referenca App Manifest	Popolna shema za datoteko manifesta `stripe-app.json`
Referenca dovoljenj	Popoln seznam dovoljenj Stripe API in kako jih zahtevati
Referenca viewportov	Mesta v Dashboardu, kjer se lahko prikaže UI vaše aplikacije

Funkcije in integracija

Vodič	Opis
Vdelane Stripe Apps	Uporaba Connect vdelanih komponent za platformne integracije
Namestitvene in globoke povezave	Ustvarjanje namestitvenih URL-jev in globoko povezovanje na določene poglede aplikacije
Dejanja po namestitvi	Konfiguracija tokov vklopitve po namestitvi aplikacije

Operacije in rast

Vodič	Opis
Analitika aplikacije	Sledenje namestitvam, pogledom in konverzijskim metrikam
Partnerski ekosistem	Izkoriščanje partnerskega programa Stripe za co-marketing in rast

Predpogoji

Pred ustvarjanjem Stripe App se prepričajte, da imate:

Račun Stripe: Aktiviran račun Stripe (ni omejen samo na testni način)
Stripe CLI: Namestite Stripe CLI za lokalni razvoj in nalaganje aplikacij
Node.js: Različica 16 ali novejša za razširitev UI aplikacije
Dostop do platforme Tajo: Aktiven račun Tajo s konfiguriranimi poverilnicami Brevo API

Hitri začetek

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

# Prijavite se v vaš račun Stripe
stripe login

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

# Zaženite lokalni razvoj
stripe apps start

Ključni koncepti

App Manifest

Vsaka Stripe App ima manifest stripe-app.json, ki deklarira dovoljenja, viewporte in konfiguracijo. Oglejte Referenco App Manifest za popolno shemo.

UI Extensions

Stripe Apps lahko prikazujejo React-based UI komponente v določenih viewportih Dashboarda. UI toolkit zagotavlja vgrajene komponente, ki ustrezajo oblikovalnemu sistemu Stripe Dashboard.

Dovoljenja

Aplikacije morajo deklarirati določene vire Stripe API, do katerih potrebujejo dostop. Uporabniki ta dovoljenja odobrijo med namestitvijo. Oglejte Referenco dovoljenj.

Podpisni skrivni ključ

Vsaka aplikacija prejme podpisni skrivni ključ za preverjanje podpisov namestitve in zagotavljanje komunikacije med vašim zaledjem in Stripe.

Razvojni delovni tok

Definirajte vaš manifest z zahtevanimi dovoljenji in viewporti
Ustvarite UI razširitev z React knjižnico komponent Stripe
Implementirajte zaledne endpoints za sinhronizacijo podatkov z Brevo prek Tajo
Testirajte lokalno z stripe apps start
Naložite z stripe apps upload
Oddajte v pregled prek Stripe Dashboard
Objavite in spremljajte prek analitike

Caution

Stripe zahteva, da so aplikacije napisane v angleščini za distribucijo na marketplace. Vpis vaše aplikacije, besedilo UI in dokumentacija morajo biti vse v angleščini.

Naslednji koraki

Začnite z Vodijem za objavo za razumevanje celotnih zahtev, nato preglejte tehnične reference za konfiguracijo manifesta in dovoljenj aplikacije.