Integrationsguide för Stripe Apps
Med Stripe Apps kan du bädda in egen funktionalitet direkt i Stripe Dashboard. Det här avsnittet är en byggguide: det beskriver hur en sådan app för integrationen mellan Tajo och Brevo skulle byggas, testas och publiceras.
Caution
Status: ännu inte publicerad. Det finns i dag ingen Tajo-app i Stripe App Marketplace, och app-ID:n, URL:er och inloggningsuppgifter på de här sidorna är illustrativa platshållare, inte skarpa endpoints. För att koppla Stripe till Tajo just nu använder du Stripe-konnektorn (begränsad API-nyckel, synkronisering med enbart läsning).
Tip
Målet är att publicera en Brevo-integration i Stripe App Marketplace, så att Stripe-handlare kan synkronisera kunddata, ordrar och händelser direkt till Brevo för marknadsautomatisering och CRM.
Vad är Stripe Apps?
Stripe Apps utökar Stripe Dashboard med egna UI-komponenter och backend-integrationer. De låter tredjepartsutvecklare:
- Lägga till egna vyer på sidor i Stripe Dashboard (kunder, betalningar, fakturor och så vidare)
- Komma åt Stripe-data via avgränsade behörigheter
- Synkronisera data mellan Stripe och externa plattformar som Brevo
- Erbjuda flöden för onboarding och konfiguration inne i Dashboard
Mål för integrationen mellan Tajo och Brevo
Tajos Stripe-app kopplar Stripe till Brevo för att ge:
- Kundinsikt: synkronisera Stripe-kundprofiler, betalningshistorik och livstidsvärde till Brevo-kontakter
- Händelsespårning: skicka Stripe-händelser (betalningar, prenumerationer, återbetalningar) som transaktionella händelser i Brevo
- Automatiserade kampanjer: utlös kampanjer via e-post, SMS och WhatsApp i Brevo utifrån aktivitet i Stripe
- Lojalitetsprogram: bygg flöden för kundlojalitet med köpdata från Stripe som synkats till Brevo
Översikt över arkitekturen
Innehåll i guiden
Den här dokumentationen täcker hela livscykeln för att bygga och publicera en Stripe-app:
Kom igång
| Guide | Beskrivning |
|---|---|
| Publicera i Marketplace | Krav och steg för att skicka in din app för granskning |
| Krav vid appgranskning | Standarder för kvalitet, säkerhet och UX för att bli godkänd |
Konfiguration och referens
| Guide | Beskrivning |
|---|---|
| Referens för appmanifestet | Fullständigt schema för manifestfilen stripe-app.json |
| Referens för behörigheter | Fullständig lista över behörigheter i Stripe API och hur du begär dem |
| Referens för viewports | Platser i Dashboard där appens gränssnitt kan visas |
Funktioner och integration
| Guide | Beskrivning |
|---|---|
| Inbäddade Stripe Apps | Använda inbäddade Connect-komponenter för plattformsintegrationer |
| Installationslänkar och djuplänkar | Skapa installations-URL:er och djuplänka till specifika appvyer |
| Åtgärder efter installation | Konfigurera onboardingflöden efter att appen har installerats |
Drift och tillväxt
| Guide | Beskrivning |
|---|---|
| Appanalys | Följ installationer, visningar och konverteringsmått |
| Partnerekosystem | Använd Stripes partnerprogram för gemensam marknadsföring och tillväxt |
Förutsättningar
Innan du bygger en Stripe-app behöver du följande:
- Stripe-konto: ett aktiverat Stripe-konto (inte begränsat till testläge)
- Stripe CLI: installera Stripe CLI för lokal utveckling och uppladdning av appar
- Node.js: version 16 eller senare för appens UI-tillägg
- Åtkomst till Tajo-plattformen: ett aktivt Tajo-konto med konfigurerade Brevo API-uppgifter
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 startViktiga begrepp
Appmanifest
Varje Stripe-app har ett manifest stripe-app.json som deklarerar behörigheter, viewports och konfiguration. Se referensen för appmanifestet för hela schemat.
UI-tillägg
Stripe Apps kan rendera React-baserade UI-komponenter i specifika viewports i Dashboard. UI-verktygslådan innehåller färdiga komponenter som matchar designsystemet i Stripe Dashboard.
Behörigheter
Appar måste deklarera exakt vilka Stripe API-resurser de behöver åtkomst till. Användarna godkänner behörigheterna vid installationen. Se referensen för behörigheter.
Signeringsnyckel
Varje app får en signeringsnyckel för att verifiera installationssignaturer och skydda kommunikationen mellan din backend och Stripe.
Utvecklingsflöde
- Definiera ditt manifest med de behörigheter och viewports som krävs
- 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 följ upp via analysen
Caution
Stripe kräver att appar är skrivna på engelska för distribution i marketplace. Din appbeskrivning, gränssnittstext och dokumentation måste alla vara på engelska.
Nästa steg
Börja med publiceringsguiden för att förstå alla krav, och arbeta dig sedan igenom de tekniska referenserna för att konfigurera appens manifest och behörigheter.