Integratiegids voor Stripe Apps
Met Stripe Apps bouw je eigen functionaliteit rechtstreeks in het Stripe Dashboard. Dit onderdeel is een bouwgids: het beschrijft hoe zo’n app voor de integratie tussen Tajo en Brevo gebouwd, getest en gepubliceerd zou worden.
Caution
Status: nog niet gepubliceerd. Er staat vandaag geen Tajo-app in de Stripe App Marketplace, en de app-identifiers, URL’s en credentials op deze pagina’s zijn illustratieve voorbeelden, geen werkende endpoints. Wil je Stripe nu al aan Tajo koppelen, gebruik dan de Stripe-connector (beperkte API-sleutel, read-only synchronisatie).
Tip
Het doel is om een Brevo-integratie te publiceren op de Stripe App Marketplace, zodat Stripe-merchants klantgegevens, bestellingen en events rechtstreeks naar Brevo synchroniseren voor marketingautomatisering en CRM.
Wat zijn Stripe Apps?
Stripe Apps breiden het Stripe Dashboard uit met eigen UI-componenten en backendintegraties. Externe ontwikkelaars kunnen daarmee:
- Eigen weergaven toevoegen aan pagina’s in het Stripe Dashboard (klanten, betalingen, facturen enzovoort)
- Stripe-gegevens benaderen via afgebakende permissies
- Gegevens synchroniseren tussen Stripe en externe platformen zoals Brevo
- Onboarding- en configuratiestappen aanbieden binnen het Dashboard
Doelen van de Tajo + Brevo-integratie
De Stripe App van Tajo verbindt Stripe met Brevo en levert:
- Klantinzicht: synchroniseer Stripe-klantprofielen, betalingsgeschiedenis en lifetime value naar Brevo-contacten
- Eventtracking: stuur Stripe-events (betalingen, abonnementen, terugbetalingen) door als transactionele events in Brevo
- Geautomatiseerde campagnes: start e-mail-, SMS- en WhatsApp-campagnes in Brevo op basis van activiteit in Stripe
- Loyaltyprogramma’s: bouw retentieworkflows met Stripe-aankoopgegevens die naar Brevo zijn gesynchroniseerd
Architectuur in het kort
Inhoud van deze gids
Deze documentatie beschrijft de volledige levensloop van het bouwen en publiceren van een Stripe App:
Aan de slag
| Gids | Beschrijving |
|---|---|
| Publiceren op de Marketplace | Vereisten en stappen om je app ter beoordeling in te dienen |
| Beoordelingsvereisten voor apps | Kwaliteits-, beveiligings- en UX-normen voor goedkeuring |
Configuratie en naslag
| Gids | Beschrijving |
|---|---|
| Naslag app-manifest | Volledig schema voor het manifestbestand stripe-app.json |
| Naslag permissies | Volledige lijst met Stripe API-permissies en hoe je ze aanvraagt |
| Naslag viewports | Plekken in het Dashboard waar de UI van je app kan verschijnen |
Functies en integratie
| Gids | Beschrijving |
|---|---|
| Ingebedde Stripe Apps | Connect-componenten inbedden voor platformintegraties |
| Installatielinks en deeplinks | Installatie-URL’s genereren en deeplinken naar specifieke appweergaven |
| Acties na installatie | Onboardingstappen instellen na installatie van de app |
Beheer en groei
| Gids | Beschrijving |
|---|---|
| App-analytics | Volg installaties, weergaven en conversiecijfers |
| Partnerecosysteem | Benut het partnerprogramma van Stripe voor co-marketing en groei |
Vereisten
Zorg dat je het volgende hebt voordat je een Stripe App bouwt:
- Stripe-account: een geactiveerd Stripe-account (niet beperkt tot testmodus)
- Stripe CLI: installeer de Stripe CLI voor lokale ontwikkeling en het uploaden van apps
- Node.js: versie 16 of hoger voor de UI-extensie van de app
- Toegang tot het Tajo-platform: een actief Tajo-account met geconfigureerde Brevo API-gegevens
Snel starten
# 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 startKernbegrippen
App-manifest
Elke Stripe App heeft een manifest stripe-app.json waarin permissies, viewports en configuratie staan. Bekijk de naslag app-manifest voor het volledige schema.
UI-extensies
Stripe Apps kunnen op React gebaseerde UI-componenten renderen in specifieke viewports van het Dashboard. De UI-toolkit levert kant-en-klare componenten die aansluiten op het designsysteem van het Stripe Dashboard.
Permissies
Apps moeten aangeven tot welke Stripe API-resources ze toegang nodig hebben. Gebruikers keuren die permissies goed tijdens de installatie. Bekijk de naslag permissies.
Signing secret
Elke app krijgt een signing secret om installatiehandtekeningen te verifiëren en de communicatie tussen je backend en Stripe te beveiligen.
Ontwikkelworkflow
- Definieer je manifest met de vereiste permissies en viewports
- Bouw de UI-extensie met de React-componentenbibliotheek van Stripe
- Implementeer backend-endpoints voor gegevenssynchronisatie met Brevo via Tajo
- Test lokaal met
stripe apps start - Upload met
stripe apps upload - Dien de app ter beoordeling in via het Stripe Dashboard
- Publiceer en volg de resultaten via analytics
Caution
Stripe vereist dat apps in het Engels zijn geschreven voor distributie via de marketplace. Je app-vermelding, UI-teksten en documentatie moeten allemaal in het Engels zijn.
Volgende stappen
Begin met de publicatiegids om de volledige vereisten te begrijpen en werk daarna de technische naslagpagina’s door om je app-manifest en permissies in te stellen.