Stripe Apps integrációs útmutató

A Stripe Apps lehetővé teszi, hogy egyedi funkciókat ágyazz be közvetlenül a Stripe irányítópultba. Ez a szakasz fejlesztői útmutató: azt írja le, hogyan épülne fel, hogyan lehetne tesztelni és közzétenni egy ilyen appot a Tajo és a Brevo integrációjához.

Mik azok a Stripe appok?

A Stripe Apps egyedi UI-komponensekkel és háttérintegrációkkal bővíti a Stripe irányítópultot. Ezekkel a külső fejlesztők a következőket tehetik:

• Egyedi nézeteket adhatnak a Stripe irányítópult oldalaihoz (vásárlók, fizetések, számlák stb.)
• Hatókörhöz kötött engedélyekkel érhetik el a Stripe adatait
• Adatokat szinkronizálhatnak a Stripe és külső platformok, például a Brevo között
• Bevezetési és beállítási folyamatokat kínálhatnak az irányítópulton belül

A Tajo és a Brevo integrációs céljai

A Tajo Stripe appja a következőkért köti össze a Stripe-ot a Brevóval:

• Vásárlói intelligencia: a Stripe vásárlói profiljainak, fizetési előzményeinek és élettartam-értékének szinkronizálása a Brevo kapcsolataiba
• Eseménykövetés: a Stripe eseményeinek (fizetések, előfizetések, visszatérítések) továbbítása Brevo tranzakciós eseményként
• Automatizált kampányok: Brevo e-mail-, SMS- és WhatsApp-kampányok indítása a Stripe-on történtek alapján
• Hűségprogramok: megtartási munkafolyamatok építése a Brevóba szinkronizált Stripe vásárlási adatokból

Architektúra áttekintése

Az útmutató tartalma

Ez a dokumentáció a Stripe appok fejlesztésének és közzétételének teljes életciklusát lefedi:

Kezdeti lépések

Beállítás és referencia

Funkciók és integráció

Üzemeltetés és növekedés

Előfeltételek

Mielőtt Stripe appot fejlesztenél, győződj meg róla, hogy megvan a következő:

1. Stripe fiók: aktivált Stripe fiók (nem csak tesztmódra korlátozva)
2. Stripe CLI: telepítsd a Stripe CLI-t a helyi fejlesztéshez és az app feltöltéséhez
3. Node.js: 16-os vagy újabb verzió az app UI-bővítményéhez
4. Tajo platform-hozzáférés: aktív Tajo fiók beállított Brevo API-hitelesítő adatokkal

Gyors indítás

# 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

Kulcsfogalmak

App manifest

Minden Stripe app rendelkezik egy stripe-app.json manifesttel, amely deklarálja az engedélyeket, a viewportokat és a beállításokat. A teljes sémát az App manifest referencia oldalon találod.

UI-bővítmények

A Stripe appok React-alapú UI-komponenseket jeleníthetnek meg az irányítópult adott viewportjaiban. Az UI-eszközkészlet előre elkészített komponenseket ad, amelyek illeszkednek a Stripe irányítópult dizájnrendszeréhez.

Engedélyek

Az appoknak deklarálniuk kell, mely Stripe API-erőforrásokhoz kérnek hozzáférést. A felhasználók a telepítéskor hagyják jóvá ezeket az engedélyeket. Lásd az Engedélyek referencia oldalt.

Aláírási titok

Minden app kap egy aláírási titkot, amellyel ellenőrizhető a telepítési aláírás, és biztonságossá tehető a háttérrendszered és a Stripe közötti kommunikáció.

Fejlesztési munkafolyamat

1. Definiáld a manifestet a szükséges engedélyekkel és viewportokkal
2. Építsd meg a UI-bővítményt a Stripe React komponenskönyvtárával
3. Valósítsd meg a háttérvégpontokat a Brevóval való adatszinkronizáláshoz a Tajón keresztül
4. Teszteld helyben a stripe apps start paranccsal
5. Töltsd fel a stripe apps upload paranccsal
6. Küldd be felülvizsgálatra a Stripe irányítópulton
7. Tedd közzé, majd kövesd az analitikában

Következő lépések

Kezdd a Közzétételi útmutatóval, hogy megértsd a teljes követelménylistát, majd dolgozd végig a technikai referenciákat az app manifest és az engedélyek beállításához.