Publiceren in de Stripe App Marketplace

Als je je Stripe App in de marketplace publiceert, is die beschikbaar voor alle Stripe-gebruikers. Deze handleiding behandelt de vereisten, de voorbereiding en het indienen.

Vereisten

Voordat je een app in de Stripe App Marketplace kunt publiceren, moet je aan deze eisen voldoen:

• Geactiveerd Stripe-account: je account mag niet beperkt zijn tot alleen de testmodus
• Eén app per account: elk Stripe-account kan maar één openbare app in de marketplace publiceren
• Alleen Engels: alle inhoud van de app, UI-teksten en gegevens in de listing moeten in het Engels zijn
• Afgeronde app: je app moet volledig werken en getest zijn

Stappen om te publiceren

Stap 1: werk je manifest bij

Stel distribution_type in je stripe-app.json in op public:

{
  "id": "com.tajo.brevo-integration",
  "version": "1.0.0",
  "name": "Tajo Brevo Integration",
  "icon": "./icon.png",
  "distribution_type": "public",
  "permissions": [
    {
      "permission": "customer_read",
      "purpose": "Sync customer data to Brevo contacts"
    },
    {
      "permission": "customer_write",
      "purpose": "Update customer metadata with Brevo sync status"
    },
    {
      "permission": "event_read",
      "purpose": "Track payment and subscription events for Brevo automation"
    }
  ]
}

Stap 2: bereid je app voor

Zorg dat je app aan alle reviewvereisten voldoet voordat je hem indient:

1. Test grondig in zowel de live- als de sandboxmodus
2. Controleer of alle permissies nodig zijn en gedocumenteerd staan
3. Bevestig dat foutafhandeling en laadstatussen zijn geïmplementeerd
4. Controleer of alle UI-teksten in het Engels zijn

Stap 3: upload je app

Gebruik de Stripe CLI om je app te uploaden:

# Upload your app to Stripe
stripe apps upload

# Verify the upload
stripe apps versions list

Stap 4: schrijf je listing

Ga naar het Stripe Dashboard om de listing van je app af te ronden. Alle velden van de listing zijn verplicht om in te dienen bij de marketplace.

Stap 5: dien in voor review

Nadat je de listing hebt afgerond, dien je de app via het Stripe Dashboard in voor review. Het team van Stripe beoordeelt je app aan de hand van de kwaliteitseisen.

Stap 6: publiceren

Zodra je app is goedgekeurd, kun je hem publiceren en is hij beschikbaar in de marketplace.

Manifest instellen voor openbare distributie

Het manifest moet distribution_type: "public" bevatten en alle vereiste permissies declareren met een duidelijke omschrijving van het doel:

{
  "id": "com.tajo.brevo-integration",
  "version": "1.2.0",
  "name": "Tajo for Brevo",
  "icon": "./assets/icon.png",
  "distribution_type": "public",
  "stripe_api_access_type": "oauth",
  "allowed_redirect_uris": [
    "https://tajo.io/stripe/callback"
  ],
  "permissions": [
    {
      "permission": "customer_read",
      "purpose": "Read customer profiles to sync with Brevo contacts"
    },
    {
      "permission": "customer_write",
      "purpose": "Write sync metadata to customer records"
    },
    {
      "permission": "charge_read",
      "purpose": "Access payment data for Brevo event tracking"
    },
    {
      "permission": "event_read",
      "purpose": "Subscribe to Stripe events for real-time Brevo sync"
    },
    {
      "permission": "product_read",
      "purpose": "Sync product catalog to Brevo for campaign personalization"
    },
    {
      "permission": "invoice_read",
      "purpose": "Track invoice events for Brevo transactional emails"
    }
  ],
  "ui_extension": {
    "views": [
      {
        "viewport": "stripe.dashboard.customer.detail",
        "component": "CustomerDetailView"
      },
      {
        "viewport": "stripe.dashboard.home.overview",
        "component": "OverviewView"
      }
    ]
  },
  "post_install_action": {
    "type": "onboarding"
  }
}

Upload de geconfigureerde app met:

stripe apps upload

Vereisten voor de listing

De listing van je app moet al deze velden bevatten:

Richtlijnen voor de naam

• Moet uniek zijn in de marketplace
• Moet duidelijk maken waar je app voor dient
• Vermijd algemene termen die gebruikers kunnen verwarren
• Voorbeeld: “Tajo for Brevo” (15 tekens)

Richtlijnen voor het icoon

• Afmetingen: precies 300x300 pixels
• Formaat: PNG of SVG
• Voeg geen afgeronde hoeken toe, Stripe past die automatisch toe
• Gebruik een helder, herkenbaar logo of symbool
• Zorg dat het ook op klein formaat leesbaar blijft

De sectie Over

Schrijf een overtuigende omschrijving die dit behandelt:

• Welk probleem je app oplost
• De belangrijkste mogelijkheden van de integratie
• Voor wie de app bedoeld is
• Eventuele voorwaarden of vereisten

Voorbeeld:

Tajo for Brevo verbindt je Stripe-betaalgegevens met het platform voor marketingautomatisering van Brevo. Synchroniseer klanten automatisch, volg betaalevents en start gepersonaliseerde campagnes via e-mail, SMS en WhatsApp op basis van realtime aankoopgedrag. Gebouwd voor e-commercebedrijven die de klantwaarde op lange termijn willen maximaliseren met retentiemarketing op basis van data.

Belangrijkste functies

Elke vermelding van een belangrijke functie bevat:

• Titel: korte naam van de functie
• Omschrijving: één tot twee zinnen die de functie uitleggen
• Afbeelding: screenshot of diagram (aanbevolen 1600x900 pixels)

Aanbevolen functies voor de Tajo Brevo-integratie:

1. Realtime klantsynchronisatie, synchroniseer Stripe-klantprofielen automatisch naar Brevo-contacten, inclusief de volledige aankoopgeschiedenis
2. Automatisering op basis van events, start Brevo-workflows vanuit Stripe-events zoals geslaagde betalingen, wijzigingen in abonnementen en terugbetalingen
3. Synchronisatie van de productcatalogus, houd je Brevo-productcatalogus synchroon met Stripe voor gepersonaliseerde campagne-inhoud
4. Campagnes over meerdere kanalen, gebruik gesynchroniseerde gegevens voor gerichte campagnes via e-mail, SMS en WhatsApp
5. Inzichten in het dashboard, bekijk Brevo-engagementstatistieken rechtstreeks in de klantweergave van het Stripe Dashboard

Prijsinformatie

Communiceer je prijsmodel duidelijk:

• Gratis: geen kosten voor installatie of gebruik
• Betaald: vermeld de prijs en hoe vaak er gefactureerd wordt
• Freemium: beschrijf wat gratis is en waarvoor betaald moet worden
• Op basis van gebruik: leg de prijsniveaus of de kosten per eenheid uit

Je app testen

Test je app grondig voordat je hem indient:

Testen in de sandboxmodus

# Start your app in test mode
stripe apps start --mode test

# Verify sandbox compatibility
stripe apps validate

Format van de testgegevens

Gebruik dit format wanneer je testgegevens aanlevert voor het reviewteam:

Test Account Credentials
========================
Platform: Tajo
URL: https://app.tajo.io/test
Email: [email protected]
Password: [secure test password]

Brevo Test API Key: xkeysib-test-xxxxxxxxxxxx

Required Setup Steps:
1. Log in to the Tajo test account
2. Navigate to Settings > Integrations > Brevo
3. The Brevo API key is pre-configured
4. Install the Stripe App from the test link provided

Expected Behavior:
- Customer sync should begin within 60 seconds of installation
- Navigate to any Stripe customer to see Brevo contact data
- Create a test payment to verify event sync to Brevo

Checklist voor de review

Controleer dit voordat je indient:

• De app werkt in zowel de live- als de testmodus
• Alle permissies hebben een duidelijke omschrijving van het doel
• Foutsituaties worden netjes afgehandeld
• Laadstatussen worden getoond bij asynchrone bewerkingen
• Geen hardgecodeerde testgegevens in de productiebuild
• De URL van het privacybeleid is bereikbaar en klopt
• De contactgegevens voor ondersteuning zijn geldig
• Alle afbeeldingen in de listing voldoen aan de eisen voor afmetingen
• De omschrijving van de app geeft de functionaliteit correct weer

Na het indienen

Het reviewteam van Stripe reageert doorgaans binnen 5 tot 10 werkdagen. Ze kunnen:

• Je app goedkeuren voor publicatie
• Wijzigingen vragen met concrete feedback
• De app afwijzen als die niet aan de eisen voldoet

Als er wijzigingen worden gevraagd, verwerk dan alle feedback en dien de app opnieuw in. Elke nieuwe inzending doorloopt de volledige reviewcyclus.

Een gepubliceerde app bijwerken

Zo werk je een al gepubliceerde app bij:

1. Verhoog de versie in stripe-app.json
2. Upload de nieuwe versie: stripe apps upload
3. Dien de update in voor review
4. Zodra de update is goedgekeurd, wordt die automatisch bij alle gebruikers uitgerold