Průvodce integrací Stripe Apps

Stripe Apps vám umožňují vložit vlastní funkce přímo do Stripe Dashboard, čímž obchodníkům poskytujete přístup k integraci Brevo od Tajo bez opuštění pracovního postupu plateb. Tento průvodce pokrývá vše, co potřebujete k vytvoření, testování a publikování Stripe App, která propojuje Stripe s Brevo přes Tajo.

Co jsou Stripe Apps?

Stripe Apps rozšiřují Stripe Dashboard o vlastní UI komponenty a backendové integrace. Umožňují vývojářům třetích stran:

• Přidávat vlastní pohledy na stránky Stripe Dashboard (zákazníci, platby, faktury atd.)
• Přistupovat k datům Stripe prostřednictvím vymezených oprávnění
• Synchronizovat data mezi Stripe a externími platformami jako Brevo
• Poskytovat onboardingové a konfigurační toky v rámci Dashboard

Cíle integrace Tajo + Brevo

Aplikace Tajo Stripe propojuje Stripe s Brevo pro:

• Zákaznickou inteligenci: Synchronizaci profilů zákazníků Stripe, platební historii a celoživotní hodnotu do kontaktů Brevo
• Sledování událostí: Odesílání událostí Stripe (platby, předplatné, vrácení) jako transakčních událostí Brevo
• Automatizované kampaně: Spouštění kampaní Brevo e-mail, SMS a WhatsApp na základě aktivity Stripe
• Věrnostní programy: Budování retenčních pracovních postupů pomocí dat nákupů Stripe synchronizovaných do Brevo

Přehled architektury

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Stripe Dashboard │────▶│   Tajo Platform  │────▶│     Brevo       │
│  (Stripe App UI) │◀────│   (Middleware)    │◀────│   (CRM/Email)   │
└─────────────────┘     └─────────────────┘     └─────────────────┘
        │                        │                        │
   Pohledy zákazníků      Synchronizace dat &      Kontakty,
   Platební detaily        Směrování událostí       Kampaně,
   Nastavení aplikace       Zpracování webhooků      Automatizace

Obsah průvodce

Tato dokumentace pokrývá celý životní cyklus vytvoření a publikování Stripe App:

Začínáme

Konfigurace a reference

Funkce a integrace

Operace a růst

Předpoklady

Před vytvořením Stripe App se ujistěte, že máte:

1. Účet Stripe: Aktivovaný účet Stripe (není omezen pouze na testovací režim)
2. Stripe CLI: Nainstalujte Stripe CLI pro lokální vývoj a nahrávání aplikací
3. Node.js: Verze 16 nebo novější pro UI rozšíření aplikace
4. Přístup k platformě Tajo: Aktivní účet Tajo s nakonfigurovanými přihlašovacími údaji Brevo API

Rychlý start

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

# Přihlaste se ke svému účtu Stripe
stripe login

# Vytvořte nový projekt Stripe App
stripe apps create tajo-brevo-integration

# Spusťte lokální vývoj
stripe apps start

Klíčové koncepty

Manifest aplikace

Každá Stripe App má manifest stripe-app.json, který deklaruje oprávnění, viewporty a konfiguraci. Viz Reference manifestu aplikace pro úplné schéma.

UI rozšíření

Stripe Apps mohou renderovat React-based UI komponenty v konkrétních viewportech Dashboard. Sada UI nástrojů poskytuje předem vytvořené komponenty odpovídající designovému systému Stripe Dashboard.

Oprávnění

Aplikace musí deklarovat specifické zdroje Stripe API, ke kterým potřebují přístup. Uživatelé tato oprávnění schvalují během instalace. Viz Reference oprávnění.

Podpisové tajemství

Každá aplikace dostane podpisové tajemství pro ověření instalačních podpisů a zabezpečení komunikace mezi vaším backendem a Stripe.

Pracovní postup vývoje

1. Definujte svůj manifest s požadovanými oprávněními a viewporty
2. Vytvořte UI rozšíření pomocí knihovny React komponent Stripe
3. Implementujte backendové endpointy pro synchronizaci dat s Brevo přes Tajo
4. Testujte lokálně pomocí stripe apps start
5. Nahrajte pomocí stripe apps upload
6. Odešlete ke kontrole přes Stripe Dashboard
7. Publikujte a sledujte pomocí analytiky

Další kroky

Začněte s Průvodcem publikování, abyste pochopili úplné požadavky, a poté projděte technické reference pro konfiguraci manifestu a oprávnění aplikace.