Stripe Apps integrasjonsveiledning
Stripe Apps lar deg bygge inn egendefinert funksjonalitet direkte i Stripe Dashboard. Denne delen er en byggeveiledning: den dokumenterer hvordan en slik app for integrasjonen mellom Tajo og Brevo ville blitt bygget, testet og publisert.
Caution
Status: ennå ikke publisert. Det finnes ingen Tajo-app i Stripe App Marketplace i dag, og app-identifikatorene, URL-ene og legitimasjonen på disse sidene er illustrerende plassholdere, ikke ekte endepunkter. Vil du koble Stripe til Tajo nå, bruker du Stripe-koblingen (begrenset API-nøkkel, skrivebeskyttet synkronisering).
Tip
Målet er å publisere en Brevo-integrasjon på Stripe App Marketplace, slik at Stripe-selgere kan synkronisere kundedata, ordrer og hendelser direkte til Brevo for markedsautomatisering og CRM.
Hva er Stripe Apps?
Stripe Apps utvider Stripe Dashboard med egendefinerte UI-komponenter og backend-integrasjoner. De lar tredjepartsutviklere:
- Legge til egendefinerte visninger på Stripe Dashboard-sider (kunder, betalinger, fakturaer osv.)
- Få tilgang til Stripe-data gjennom omfangsbaserte tillatelser
- Synkronisere data mellom Stripe og eksterne plattformer som Brevo
- Tilby onboarding- og konfigurasjonsflyter inne i dashbordet
Tajo + Brevo integrasjonsmål
Tajo Stripe App kobler Stripe med Brevo for å levere:
- Kundeintelligens: Synkroniser Stripe-kundeprofiler, betalingshistorikk og levetidsverdi til Brevo-kontakter
- Hendelsessporing: Send Stripe-hendelser (betalinger, abonnementer, refusjoner) som transaksjonshendelser i Brevo
- Automatiserte kampanjer: Utløs Brevo-kampanjer på e-post, SMS og WhatsApp basert på Stripe-aktivitet
- Lojalitetsprogrammer: Bygg arbeidsflyter for kundelojalitet med Stripe-kjøpsdata synkronisert til Brevo
Arkitekturoversikt
Veiledningsinnhold
Denne dokumentasjonen dekker hele livsløpet for å bygge og publisere en Stripe App:
Kom i gang
| Veiledning | Beskrivelse |
|---|---|
| Publisere til marketplace | Krav og trinn for å sende inn appen din til gjennomgang |
| Krav til app-gjennomgang | Standarder for kvalitet, sikkerhet og UX for godkjenning |
Konfigurasjon og referanse
| Veiledning | Beskrivelse |
|---|---|
| App Manifest-referanse | Fullstendig skjema for manifestfilen stripe-app.json |
| Tillatelsesreferanse | Fullstendig liste over Stripe API-tillatelser og hvordan du ber om dem |
| Viewport-referanse | Steder i dashbordet der app-UI-en din kan vises |
Funksjoner og integrasjon
| Veiledning | Beskrivelse |
|---|---|
| Innebygde Stripe Apps | Bruke innebygde Connect-komponenter for plattformintegrasjoner |
| Installasjons- og dypelenker | Generer installasjons-URL-er og dype lenker inn i bestemte appvisninger |
| Handlinger etter installasjon | Konfigurer onboarding-flyter etter at appen er installert |
Drift og vekst
| Veiledning | Beskrivelse |
|---|---|
| App-analyse | Følg installasjoner, visninger og konverteringstall |
| Partnerøkosystem | Utnytt partnerprogrammet til Stripe for felles markedsføring og vekst |
Forutsetninger
Før du bygger en Stripe App, sørg for at du har:
- Stripe-konto: En aktivert Stripe-konto (ikke begrenset til testmodus)
- Stripe CLI: Installer Stripe CLI for lokal utvikling og opplasting av apper
- Node.js: Versjon 16 eller nyere for UI-utvidelsen til appen
- Tilgang til Tajo-plattformen: Aktiv Tajo-konto med Brevo API-legitimasjon konfigurert
Hurtigstart
# 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økkelbegreper
App Manifest
Hver Stripe App har et stripe-app.json-manifest som erklærer tillatelser, viewports og konfigurasjon. Se App Manifest-referansen for det fullstendige skjemaet.
UI-utvidelser
Stripe Apps kan gjengi React-baserte UI-komponenter i bestemte viewports i dashbordet. UI-verktøykassen gir ferdigbygde komponenter som samsvarer med designsystemet i Stripe Dashboard.
Tillatelser
Apper må erklære nøyaktig hvilke Stripe API-ressurser de trenger tilgang til. Brukerne godkjenner disse tillatelsene under installasjonen. Se Tillatelsesreferansen.
Signeringshemmelighet
Hver app får en signeringshemmelighet for å verifisere installasjonssignaturer og sikre kommunikasjonen mellom backend-en din og Stripe.
Utviklingsflyt
- Definer manifestet ditt med nødvendige tillatelser og viewports
- Bygg UI-utvidelsen med React-komponentbiblioteket til Stripe
- Implementer backend-endepunkter for datasynkronisering med Brevo via Tajo
- Test lokalt med
stripe apps start - Last opp med
stripe apps upload - Send inn til gjennomgang gjennom Stripe Dashboard
- Publiser og følg med via analyse
Caution
Stripe krever at apper skrives på engelsk for distribusjon i marketplace. App-oppføringen, UI-teksten og dokumentasjonen må alle være på engelsk.
Neste steg
Start med publiseringsveiledningen for å forstå alle kravene, og arbeid deretter gjennom de tekniske referansene for å konfigurere app-manifestet og tillatelsene dine.