Guide til integration med Stripe Apps
Med Stripe Apps kan du lægge egen funktionalitet direkte ind i Stripe-dashboardet. Dette afsnit er en byggeguide: det beskriver, hvordan sådan en app til Tajo-Brevo-integrationen ville blive bygget, testet og udgivet.
Caution
Status: endnu ikke udgivet. Der findes ingen Tajo-app i Stripe App Marketplace i dag, og app-ID’er, URL’er og loginoplysninger på disse sider er illustrative pladsholdere, ikke aktive endpoints. Vil du forbinde Stripe til Tajo lige nu, skal du bruge Stripe-connectoren (begrænset API-nøgle, skrivebeskyttet synkronisering).
Tip
Målet er at udgive en Brevo-integration i Stripe App Marketplace, så Stripe-forhandlere kan synkronisere kundedata, ordrer og hændelser direkte ind i Brevo til marketingautomatisering og CRM.
Hvad er Stripe Apps?
Stripe Apps udvider Stripe-dashboardet med egne UI-komponenter og backend-integrationer. De giver tredjepartsudviklere mulighed for at:
- Tilføje egne visninger til sider i Stripe-dashboardet (kunder, betalinger, fakturaer og så videre)
- Tilgå Stripe-data via afgrænsede tilladelser
- Synkronisere data mellem Stripe og eksterne platforme som Brevo
- Tilbyde onboarding- og konfigurationsflows inde i dashboardet
Mål for Tajo + Brevo-integrationen
Tajos Stripe-app forbinder Stripe med Brevo og leverer:
- Kundeindsigt: Synkroniser Stripe-kundeprofiler, betalingshistorik og livstidsværdi ind i Brevo-kontakter
- Hændelsessporing: Send Stripe-hændelser (betalinger, abonnementer, refusioner) videre som transaktionelle hændelser i Brevo
- Automatiserede kampagner: Udløs e-mail-, SMS- og WhatsApp-kampagner i Brevo ud fra aktivitet i Stripe
- Loyalitetsprogrammer: Byg arbejdsgange til fastholdelse ud fra Stripe-købsdata synkroniseret til Brevo
Arkitekturoverblik
Guidens indhold
Denne dokumentation dækker hele livscyklussen for at bygge og udgive en Stripe-app:
Kom i gang
| Guide | Beskrivelse |
|---|---|
| Udgivelse til Marketplace | Krav og trin til at indsende din app til gennemgang |
| Krav til gennemgang af apps | Standarder for kvalitet, sikkerhed og UX, der skal opfyldes for at blive godkendt |
Konfiguration og reference
| Guide | Beskrivelse |
|---|---|
| Reference for app-manifestet | Komplet skema for manifestfilen stripe-app.json |
| Reference for tilladelser | Fuld liste over Stripe API-tilladelser, og hvordan du anmoder om dem |
| Reference for viewports | De steder i dashboardet, hvor din apps UI kan vises |
Funktioner og integration
| Guide | Beskrivelse |
|---|---|
| Indlejrede Stripe-apps | Brug af indlejrede Connect-komponenter til platformsintegrationer |
| Installationslinks og deep links | Dan installations-URL’er, og lav deep links ind i bestemte app-visninger |
| Handlinger efter installation | Konfigurer onboardingflows, når appen er installeret |
Drift og vækst
| Guide | Beskrivelse |
|---|---|
| App-analyser | Følg installationer, visninger og konverteringsmetrikker |
| Partnerøkosystem | Udnyt Stripes partnerprogram til fælles markedsføring og vækst |
Forudsætninger
Før du bygger en Stripe-app, skal du have:
- Stripe-konto: En aktiveret Stripe-konto (ikke begrænset til testtilstand)
- Stripe CLI: Installer Stripe CLI til lokal udvikling og upload af apps
- Node.js: Version 16 eller nyere til appens UI-udvidelse
- Adgang til Tajo-platformen: Aktiv Tajo-konto med konfigurerede Brevo API-loginoplysninger
Hurtig 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 startNøglebegreber
App-manifestet
Hver Stripe-app har et stripe-app.json-manifest, der erklærer tilladelser, viewports og konfiguration. Se referencen for app-manifestet for det fulde skema.
UI-udvidelser
Stripe Apps kan vise React-baserede UI-komponenter i bestemte viewports i dashboardet. UI-værktøjskassen indeholder præbyggede komponenter, der matcher designsystemet i Stripe-dashboardet.
Tilladelser
Apps skal erklære præcis de Stripe API-ressourcer, de har brug for adgang til. Brugerne godkender disse tilladelser under installationen. Se referencen for tilladelser.
Signeringsnøgle
Hver app får en signeringsnøgle, der bruges til at verificere installationssignaturer og sikre kommunikationen mellem din backend og Stripe.
Udviklingsforløb
- Definer dit manifest med de nødvendige tilladelser og viewports
- Byg UI-udvidelsen med Stripes React-komponentbibliotek
- Implementer backend-endpoints til datasynkronisering med Brevo via Tajo
- Test lokalt med
stripe apps start - Upload med
stripe apps upload - Indsend til gennemgang via Stripe-dashboardet
- Udgiv, og følg op via analyser
Caution
Stripe kræver, at apps er skrevet på engelsk for at kunne distribueres i marketplace. Din app-omtale, dine UI-tekster og din dokumentation skal alt sammen være på engelsk.
Næste trin
Start med udgivelsesguiden for at forstå alle kravene, og arbejd dig derefter gennem de tekniske referencer for at sætte dit app-manifest og dine tilladelser op.