Stripe Apps integrationsvägledning
Stripe Apps låter dig bädda in anpassad funktionalitet direkt i Stripe Dashboard, och ger säljare åtkomst till Tajos Brevo-integration utan att lämna betalningsarbetsflödet. Den här guiden täcker allt du behöver för att bygga, testa och publicera en Stripe App som kopplar Stripe med Brevo via Tajo.
Tip
Målet är att publicera en Brevo-integration på Stripe App Marketplace, så att Stripe-säljare kan synkronisera kunddata, bestellningar och händelser direkt till Brevo för marknadsföringsautomation och CRM.
Vad är Stripe Apps?
Stripe Apps utökar Stripe Dashboard med anpassade UI-komponenter och backend-integrationer. De låter tredjepartsutvecklare:
- Lägga till anpassade vyer på Stripe Dashboard-sidor (kunder, betalningar, fakturor osv.)
- Få åtkomst till Stripe-data via omfångsbaserade behörigheter
- Synkronisera data mellan Stripe och externa plattformar som Brevo
- Erbjuda onboarding- och konfigurationsflöden inom instrumentpanelen
Tajo + Brevo integrationsmål
Tajo Stripe App kopplar Stripe med Brevo för att leverera:
- Kundintelligens: Synkronisera Stripe-kundprofiler, betalningshistorik och livstidsvärde till Brevo-kontakter
- Händelsespårning: Skicka Stripe-händelser (betalningar, prenumerationer, återbetalningar) som Brevo-transaktionshändelser
- Automatiserade kampanjer: Utlös Brevo e-post, SMS och WhatsApp-kampanjer baserat på Stripe-aktivitet
- Lojalitetsprogram: Bygg retentionsarbetsflöden med Stripes köpdata synkroniserad till Brevo
Arkitekturöversikt
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐│ Stripe Dashboard │────▶│ Tajo Platform │────▶│ Brevo ││ (Stripe App UI) │◀────│ (Middleware) │◀────│ (CRM/Email) │└─────────────────┘ └─────────────────┘ └─────────────────┘ │ │ │ Kundvyer Datasynkronisering & Kontakter, Betalningsdetaljer Händelserouting Kampanjer, App-inställningar Webhook-hantering AutomatiseringarGuidinnehåll
Den här dokumentationen täcker hela livscykeln för att bygga och publicera en Stripe App:
Kom igång
| Guide | Beskrivning |
|---|---|
| Publicera till marketplace | Krav och steg för att skicka in din app för granskning |
| Krav för appgranskning | Kvalitets-, säkerhets- och UX-standarder för godkännande |
Konfiguration och referens
| Guide | Beskrivning |
|---|---|
| App Manifest-referens | Fullständigt schema för manifestfilen stripe-app.json |
| Behörighetsreferens | Fullständig lista över Stripe API-behörigheter och hur du begär dem |
| Viewport-referens | Instrumentpanelplatser där appens UI kan visas |
Funktioner och integration
| Guide | Beskrivning |
|---|---|
| Inbäddade Stripe Apps | Använda Connect inbäddade komponenter för plattformsintegrationer |
| Installations- och djuplänkar | Generera installations-URL:er och djuplänkar in i specifika appvyer |
| Åtgärder efter installation | Konfigurera onboarding-flöden efter appinstallation |
Drift och tillväxt
| Guide | Beskrivning |
|---|---|
| Appanalys | Spåra installationer, vyer och konverteringsmätvärden |
| Partnerekosystem | Utnyttja Stripes partnerprogram för co-marknadsföring och tillväxt |
Förutsättningar
Innan du bygger en Stripe App, se till att du har:
- Stripe-konto: Ett aktiverat Stripe-konto (inte begränsat till testläge)
- Stripe CLI: Installera Stripe CLI för lokal utveckling och app-uppladdningar
- Node.js: Version 16 eller nyare för app UI-tillägget
- Tajo Platform-åtkomst: Aktivt Tajo-konto med Brevo API-uppgifter konfigurerade
Snabbstart
# 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 startNyckelkoncept
App Manifest
Varje Stripe App har ett stripe-app.json-manifest som deklarerar behörigheter, viewports och konfiguration. Se App Manifest-referensen för det fullständiga schemat.
UI-tillägg
Stripe Apps kan rendera React-baserade UI-komponenter i specifika Dashboard-viewports. UI-verktygsuppsättningen tillhandahåller förbyggda komponenter som matchar Stripe Dashboards designsystem.
Behörigheter
Appar måste deklarera de specifika Stripe API-resurser de behöver åtkomst till. Användare godkänner dessa behörigheter under installationen. Se Behörighetsreferensen.
Signeringshemlighet
Varje app tar emot en signeringshemlighet för verifiering av installationssignaturer och säkring av kommunikation mellan backend och Stripe.
Utvecklingsarbetsflöde
- Definiera ditt manifest med nödvändiga behörigheter och viewports
- Bygg UI-tillägget med Stripes React-komponentbibliotek
- Implementera backend-endpoints för datasynkronisering med Brevo via Tajo
- Testa lokalt med
stripe apps start - Ladda upp med
stripe apps upload - Skicka in för granskning via Stripe Dashboard
- Publicera och övervaka via analys
Caution
Stripe kräver att appar skrivs på engelska för marketplace-distribution. Applistan, UI-texten och dokumentationen måste alla vara på engelska.
Nästa steg
Börja med Publiceringsvägledningen för att förstå de fullständiga kraven, och arbeta sedan igenom de tekniska referenserna för att konfigurera ditt app-manifest och dina behörigheter.