Stripe Apps integrasjonsveiledning
Stripe Apps lar deg bygge inn egendefinert funksjonalitet direkte i Stripe Dashboard, og gir selgere tilgang til Tajos Brevo-integrasjon uten å forlate arbeidsflyt for betalinger. Denne veiledningen dekker alt du trenger for å bygge, teste og publisere en Stripe App som kobler Stripe med Brevo gjennom Tajo.
Tip
Målet er å publisere en Brevo-integrasjon på Stripe App Marketplace, slik at Stripe-selgere kan synkronisere kundedata, bestillinger 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 innenfor 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: Push Stripe-hendelser (betalinger, abonnementer, refusjoner) som Brevo-transaksjonshendelser
- Automatiserte kampanjer: Utløs Brevo e-post, SMS og WhatsApp-kampanjer basert på Stripe-aktivitet
- Lojalitetsprogrammer: Bygg oppbevaringsarbeidsflyter ved hjelp av Stripe kjøpsdata synkronisert til Brevo
Arkitekturoversikt
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐│ Stripe Dashboard │────▶│ Tajo Platform │────▶│ Brevo ││ (Stripe App UI) │◀────│ (Middleware) │◀────│ (CRM/Email) │└─────────────────┘ └─────────────────┘ └─────────────────┘ │ │ │ Kundevisninger Datasynkronisering & Kontakter, Betalingsdetaljer Hendelsesruting Kampanjer, App-innstillinger Webhook-håndtering AutomatiseringerVeiledningsinnhold
Denne dokumentasjonen dekker den fullstendige livssyklusen for å bygge og publisere en Stripe App:
Kom i gang
| Veiledning | Beskrivelse |
|---|---|
| Publisere til marketplace | Krav og trinn for å sende inn appen din for gjennomgang |
| App-gjennomgangskrav | Kvalitets-, sikkerhets- og UX-standarder for godkjenning |
Konfigurasjon og referanse
| Veiledning | Beskrivelse |
|---|---|
| App Manifest-referanse | Fullstendig skjema for stripe-app.json-manifestfilen |
| Tillatelsesreferanse | Fullstendig liste over Stripe API-tillatelser og hvordan du ber om dem |
| Viewport-referanse | Dashbord-steder der app-UI-en kan vises |
Funksjoner og integrasjon
| Veiledning | Beskrivelse |
|---|---|
| Innebygde Stripe Apps | Bruke Connect innebygde komponenter for plattformintegrasjoner |
| Installasjons- og dypelenker | Generer installasjons-URL-er og dype lenker inn i spesifikke appvisninger |
| Post-installasjonshandlinger | Konfigurer onboarding-flyter etter appinstallasjon |
Operasjoner og vekst
| Veiledning | Beskrivelse |
|---|---|
| App-analyse | Spor installasjoner, visninger og konverteringsmålinger |
| Partnerøkosystem | Utnytt Stripes partnerprogram for co-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 app-opplastinger
- Node.js: Versjon 16 eller nyere for app UI-utvidelsen
- Tajo Platform-tilgang: 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økkelkonsepter
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 spesifikke Dashboard-viewports. UI-verktøykassen gir forhåndsbygde komponenter som samsvarer med Stripe Dashboard-designsystemet.
Tillatelser
Apps må erklære de spesifikke Stripe API-ressursene de trenger tilgang til. Brukere godkjenner disse tillatelsene under installasjonen. Se Tillatelsesreferansen.
Signeringshemmelighet
Hver app mottar en signeringshemmelighet for verifisering av installasjonsignaturer og sikring av kommunikasjon mellom backend og Stripe.
Utviklingsarbeidsflyt
- Definer manifestet ditt med nødvendige tillatelser og viewports
- Bygg UI-utvidelsen ved hjelp av Stripes React-komponentbibliotek
- Implementer backend-endepunkter for datasynkronisering med Brevo via Tajo
- Test lokalt med
stripe apps start - Last opp med
stripe apps upload - Send inn for gjennomgang gjennom Stripe Dashboard
- Publiser og overvåk via analyse
Caution
Stripe krever at apper skrives på engelsk for marketplace-distribusjon. App-oppføringen, UI-teksten og dokumentasjonen må alle være på engelsk.
Neste steg
Start med Publiseringsveiledningen for å forstå de fullstendige kravene, og arbeid deretter gjennom de tekniske referansene for å konfigurere app-manifestet og tillatelsene dine.