On this page

Stripe Apps integrációs útmutató

A Stripe Apps lehetővé teszi, hogy egyedi funkciókat ágyazzon be közvetlenül a Stripe vezérlőpultba, így a kereskedők hozzáférhetnek a Tajo Brevo integrációjához anélkül, hogy elhagynák a fizetési munkafolyamatot. Ez az útmutató mindent lefed, amire szüksége van a Stripe App fejlesztéséhez, teszteléséhez és közzétételéhez, amely összekapcsolja a Stripe-ot a Brevo-val a Tajo-n keresztül.

Tip

A cél egy Brevo integráció közzététele a Stripe App Marketplace-en, amely lehetővé teszi a Stripe kereskedők számára, hogy az ügyféladatokat, rendeléseket és eseményeket közvetlenül szinkronizálják a Brevo-ba marketing automatizálás és CRM céljára.

Mik azok a Stripe Apps?

A Stripe Apps egyedi UI komponensekkel és háttér integrációkkal bővítik a Stripe vezérlőpultot. Lehetővé teszik harmadik fél fejlesztők számára:

Egyedi nézetek hozzáadását Stripe vezérlőpult oldalakhoz (ügyfelek, fizetések, számlák stb.)
Stripe adatok elérését hatókörbe helyezett engedélyekkel
Adatok szinkronizálását Stripe és külső platformok, mint a Brevo között
Bevezetési és konfigurációs folyamatok biztosítását a vezérlőpulton belül

Tajo + Brevo integrációs célok

A Tajo Stripe App összekapcsolja a Stripe-ot a Brevo-val a következők érdekében:

Ügyfél intelligencia: Stripe ügyfélprofilok, fizetési előzmények és élettartam-értékek szinkronizálása Brevo kapcsolatokba
Eseménykövetés: Stripe események (fizetések, előfizetések, visszatérítések) küldése Brevo tranzakciós eseményekként
Automatizált kampányok: Brevo email, SMS és WhatsApp kampányok kiváltása Stripe tevékenység alapján
Hűségprogramok: Megtartási munkafolyamatok fejlesztése Stripe vásárlási adatok Brevo-ba szinkronizálásával

Architektúra áttekintés

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Stripe vezérlőpult│────▶│   Tajo platform  │────▶│     Brevo       │
│  (Stripe App UI) │◀────│   (közvetítő)    │◀────│   (CRM/Email)   │
└─────────────────┘     └─────────────────┘     └─────────────────┘
        │                        │                        │
   Ügyfél nézetek          Adatszinkronizáció       Kapcsolatok,
   Fizetési részletek       és eseményrouting        Kampányok,
   Alkalmazás beállítások   Webhook kezelés          Automatizálások

Útmutató tartalma

Ez a dokumentáció a Stripe App teljes életciklusát lefedi:

Kezdeti lépések

Útmutató	Leírás
Közzététel a Marketplace-en	Követelmények és lépések az app felülvizsgálatra való beküldéséhez
App felülvizsgálati követelmények	Minőségi, biztonsági és UX szabványok az elfogadáshoz

Konfiguráció és referencia

Útmutató	Leírás
App manifest referencia	Teljes séma a `stripe-app.json` manifesztfájlhoz
Engedélyek referencia	Stripe API engedélyek teljes listája és igénylési módja
Viewport referencia	Vezérlőpult helyek, ahol az app UI megjelenhet

Funkciók és integráció

Útmutató	Leírás
Beágyazott Stripe Apps	Connect beágyazott komponensek platformintegrációkhoz
Telepítési és mély hivatkozások	Telepítési URL-ek generálása és mély hivatkozás konkrét app nézetekbe
Telepítés utáni műveletek	Bevezetési folyamatok konfigurálása az app telepítése után

Működtetés és növekedés

Útmutató	Leírás
App analitika	Telepítések, nézetek és konverziós mérőszámok követése
Partner ökoszisztéma	Stripe partnerprogramjának kihasználása co-marketinghez és növekedéshez

Előfeltételek

Stripe App fejlesztése előtt győződjön meg arról, hogy rendelkezik:

Stripe fiók: Aktivált Stripe fiók (nem korlátozva teszti módra)
Stripe CLI: Telepítse a Stripe CLI-t helyi fejlesztéshez és app feltöltéshez
Node.js: 16-os vagy újabb verzió az app UI bővítményhez
Tajo Platform hozzáférés: Aktív Tajo fiók konfigurált Brevo API hitelesítő adatokkal

Gyors kezdés

# Stripe CLI telepítése
brew install stripe/stripe-cli/stripe

# Bejelentkezés a Stripe fiókba
stripe login

# Új Stripe App projekt létrehozása
stripe apps create tajo-brevo-integration

# Helyi fejlesztés indítása
stripe apps start

Kulcsfogalmak

App manifest

Minden Stripe App rendelkezik egy stripe-app.json manifeszttel, amely meghatározza az engedélyeket, viewportokat és konfigurációt. Lásd az App manifest referencia oldalt a teljes sémáért.

UI bővítmények

A Stripe Apps React-alapú UI komponenseket jeleníthetnek meg konkrét vezérlőpult viewportokban. Az UI eszközkészlet előre felépített komponenseket biztosít, amelyek illeszkednek a Stripe vezérlőpult dizájnrendszeréhez.

Engedélyek

Az appoknak meg kell határozniuk a szükséges Stripe API erőforrásokat. A felhasználók jóváhagyják ezeket az engedélyeket telepítés során. Lásd az Engedélyek referencia oldalt.

Aláírási titkos kulcs

Minden app kap egy aláírási titkos kulcsot a telepítési aláírások ellenőrzéséhez és a háttér és a Stripe közötti kommunikáció biztonságossá tételéhez.

Fejlesztési munkafolyamat

Definiálja a manifesztet szükséges engedélyekkel és viewportokkal
Fejlessze a UI bővítményt a Stripe React komponens könyvtárával
Implementálja a háttérvégpontokat az adatszinkronizáláshoz a Brevo-val a Tajo-n keresztül
Tesztelje helyileg a stripe apps start paranccsal
Töltse fel a stripe apps upload paranccsal
Küldje be felülvizsgálatra a Stripe vezérlőpulton keresztül
Tegye közzé és monitorozza az analitikán keresztül

Caution

A Stripe megköveteli, hogy az appok angol nyelven legyenek írva a marketplace terjesztéshez. Az app listázás, UI szöveg és dokumentáció mind angolul kell legyen.

Következő lépések

Kezdje a Közzétételi útmutatóval a teljes követelmények megértéséhez, majd dolgozzon végig a technikai referenciákon az app manifest és az engedélyek konfigurálásához.