Průvodce integrací Stripe Apps
Stripe Apps Vám umožňují vložit vlastní funkce přímo do Stripe Dashboard. Tato sekce je průvodce vývojem: popisuje, jak by se taková aplikace pro integraci Tajo–Brevo stavěla, testovala a publikovala.
Caution
Stav: zatím nepublikováno. Na Stripe App Marketplace dnes žádná aplikace Tajo není a identifikátory aplikace, URL i přihlašovací údaje na těchto stránkách jsou ilustrativní zástupné hodnoty, nikoli živé endpointy. Pokud chcete propojit Stripe s Tajo hned teď, použijte konektor Stripe (omezený API klíč, synchronizace pouze pro čtení).
Tip
Cílem je publikovat integraci Brevo na Stripe App Marketplace, která obchodníkům na Stripe umožní synchronizovat zákaznická data, objednávky a události přímo do Brevo pro marketingovou automatizaci a CRM.
Co jsou Stripe Apps?
Stripe Apps rozšiřují Stripe Dashboard o vlastní UI komponenty a backendové integrace. Vývojářům třetích stran umožňují:
- 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 je Brevo
- Poskytovat onboardingové a konfigurační toky přímo v Dashboard
Cíle integrace Tajo + Brevo
Stripe App od Tajo propojuje Stripe s Brevo a přináší:
- Přehled o zákaznících: synchronizaci zákaznických profilů, historie plateb a celoživotní hodnoty ze Stripe do kontaktů v Brevo
- Sledování událostí: odesílání událostí ze Stripe (platby, předplatná, vratky) jako transakčních událostí v Brevo
- Automatizované kampaně: spouštění e-mailových, SMS a WhatsApp kampaní v Brevo podle aktivity ve Stripe
- Věrnostní programy: tvorbu retenčních workflow nad nákupními daty ze Stripe synchronizovanými do Brevo
Přehled architektury
Obsah průvodce
Tato dokumentace pokrývá kompletní životní cyklus tvorby a publikace Stripe App:
Začínáme
| Průvodce | Popis |
|---|---|
| Publikování na Marketplace | Požadavky a kroky pro odeslání aplikace k posouzení |
| Požadavky na posouzení aplikace | Standardy kvality, bezpečnosti a UX pro schválení |
Konfigurace a reference
| Průvodce | Popis |
|---|---|
| Reference manifestu aplikace | Kompletní schéma souboru manifestu stripe-app.json |
| Reference oprávnění | Úplný seznam oprávnění Stripe API a postup, jak o ně požádat |
| Reference viewportů | Místa v Dashboard, kde se může UI Vaší aplikace zobrazit |
Funkce a integrace
| Průvodce | Popis |
|---|---|
| Vestavěné Stripe Apps | Použití vestavěných komponent Connect pro integrace platforem |
| Instalační a hluboké odkazy | Generování instalačních URL a hluboké odkazy do konkrétních pohledů aplikace |
| Akce po instalaci | Nastavení onboardingových toků po instalaci aplikace |
Provoz a růst
| Průvodce | Popis |
|---|---|
| Analytika aplikace | Sledování instalací, zobrazení a konverzních metrik |
| Partnerský ekosystém | Využití partnerského programu Stripe pro společný marketing a růst |
Předpoklady
Než začnete stavět Stripe App, ujistěte se, že máte:
- Účet Stripe: aktivovaný účet Stripe (neomezený pouze na testovací režim)
- Stripe CLI: nainstalujte Stripe CLI pro lokální vývoj a nahrávání aplikací
- Node.js: verzi 16 nebo novější pro UI rozšíření aplikace
- Přístup k platformě Tajo: aktivní účet Tajo s nastavenými přihlašovacími údaji k Brevo API
Rychlý start
# Install Stripe CLIbrew install stripe/stripe-cli/stripe
# Login to your Stripe accountstripe login
# Create a new Stripe App projectstripe apps create tajo-brevo-integration
# Start local developmentstripe apps startKlíčové pojmy
Manifest aplikace
Každá Stripe App má manifest stripe-app.json, který deklaruje oprávnění, viewporty a konfiguraci. Úplné schéma najdete v referenci manifestu aplikace.
UI rozšíření
Stripe Apps mohou vykreslovat UI komponenty postavené na Reactu v konkrétních viewportech Dashboard. Sada UI nástrojů nabízí předpřipravené komponenty, které odpovídají designovému systému Stripe Dashboard.
Oprávnění
Aplikace musí deklarovat konkrétní zdroje Stripe API, ke kterým potřebují přístup. Uživatelé tato oprávnění schvalují při instalaci. Viz reference oprávnění.
Podpisový tajný klíč
Každá aplikace dostane podpisový tajný klíč pro ověřování instalačních podpisů a zabezpečení komunikace mezi Vaším backendem a Stripe.
Vývojový postup
- Definujte svůj manifest s potřebnými oprávněními a viewporty
- Postavte UI rozšíření pomocí knihovny React komponent od Stripe
- Implementujte backendové endpointy pro synchronizaci dat s Brevo přes Tajo
- Otestujte lokálně příkazem
stripe apps start - Nahrajte příkazem
stripe apps upload - Odešlete k posouzení přes Stripe Dashboard
- Publikujte a sledujte přes analytiku
Caution
Stripe vyžaduje, aby aplikace pro distribuci na marketplace byly napsané v angličtině. Výpis Vaší aplikace, texty v UI i dokumentace musí být v angličtině.
Další kroky
Začněte průvodcem publikováním, abyste pochopili všechny požadavky, a poté projděte technické reference pro nastavení manifestu a oprávnění aplikace.