Publication sur le Stripe App Marketplace

Publier votre Stripe App sur le marketplace la rend accessible à tous les utilisateurs de Stripe. Ce guide couvre les exigences, les étapes de préparation et le processus de soumission.

Prérequis

Avant de pouvoir publier une app sur le Stripe App Marketplace, vous devez remplir les conditions suivantes :

• Compte Stripe activé : votre compte ne doit pas être restreint au seul mode test
• Une app par compte : chaque compte Stripe ne peut publier qu’une seule app publique sur le marketplace
• Anglais uniquement : tout le contenu de l’app, les textes de l’interface et les informations de la fiche doivent être en anglais
• App terminée : votre app doit être entièrement fonctionnelle et testée

Étapes de publication

Étape 1 : mettre à jour votre manifest

Définissez distribution_type sur public dans votre stripe-app.json :

{
  "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"
    }
  ]
}

Étape 2 : préparer votre app

Vérifiez que votre app respecte toutes les exigences de révision avant de la soumettre :

1. Testez-la en profondeur en mode live et en mode sandbox
2. Vérifiez que toutes les permissions sont nécessaires et documentées
3. Confirmez que la gestion des erreurs et les états de chargement sont implémentés
4. Contrôlez que tous les textes de l’interface sont en anglais

Étape 3 : envoyer votre app

Utilisez la Stripe CLI pour envoyer votre app :

# Upload your app to Stripe
stripe apps upload

# Verify the upload
stripe apps versions list

Étape 4 : rédiger votre fiche

Rendez-vous dans le tableau de bord Stripe pour compléter la fiche de votre app. Tous les champs de la fiche sont obligatoires pour la soumission au marketplace.

Étape 5 : soumettre à la révision

Une fois votre fiche complétée, soumettez l’app à la révision depuis le tableau de bord Stripe. L’équipe Stripe évaluera votre app au regard des exigences de qualité.

Étape 6 : publier

Une fois l’app approuvée, vous pouvez la publier pour la rendre disponible sur le marketplace.

Configuration du manifest pour une distribution publique

Le manifest doit contenir distribution_type: "public" et déclarer toutes les permissions requises avec des descriptions de finalité claires :

{
  "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"
  }
}

Envoyez l’app ainsi configurée avec :

stripe apps upload

Exigences de la fiche

La fiche de votre app doit renseigner tous les champs suivants :

Règles pour le nom

• Il doit être unique sur le marketplace
• Il doit identifier clairement la vocation de votre app
• Évitez les termes génériques qui pourraient prêter à confusion
• Exemple : “Tajo for Brevo” (15 caractères)

Règles pour l’icône

• Dimensions : exactement 300x300 pixels
• Format : PNG ou SVG
• N’ajoutez pas de coins arrondis, Stripe les applique automatiquement
• Utilisez un logo ou un symbole clair et reconnaissable
• Assurez-vous qu’elle reste lisible en petite taille

Section À propos

Rédigez une description convaincante qui couvre :

• Le problème que votre app résout
• Les principales capacités de l’intégration
• Le public auquel l’app s’adresse
• Les prérequis ou exigences éventuels

Exemple :

Tajo for Brevo relie vos données de paiement Stripe à la plateforme d’automation marketing de Brevo. Synchronisez automatiquement vos clients, suivez les événements de paiement et déclenchez des campagnes e-mail, SMS et WhatsApp personnalisées à partir du comportement d’achat en temps réel. Conçue pour les entreprises e-commerce qui veulent maximiser la valeur vie client grâce à un marketing de rétention piloté par les données.

Fonctionnalités clés

Chaque fonctionnalité clé comprend :

• Titre : nom court de la fonctionnalité
• Description : une à deux phrases expliquant la fonctionnalité
• Image : capture d’écran ou schéma (1600x900 pixels recommandés)

Fonctionnalités recommandées pour l’intégration Tajo Brevo :

1. Synchronisation client en temps réel, synchronise automatiquement les profils clients Stripe vers les contacts Brevo avec l’historique d’achat complet
2. Automation pilotée par les événements, déclenche des workflows Brevo à partir d’événements Stripe comme les paiements réussis, les changements d’abonnement et les remboursements
3. Synchronisation du catalogue produits, garde votre catalogue produits Brevo synchronisé avec Stripe pour personnaliser le contenu des campagnes
4. Campagnes multicanal, utilise les données synchronisées pour alimenter des campagnes e-mail, SMS et WhatsApp ciblées
5. Informations dans le tableau de bord, affiche les métriques d’engagement Brevo directement dans la vue client du tableau de bord Stripe

Informations tarifaires

Communiquez clairement votre modèle tarifaire :

• Gratuit : aucun coût d’installation ni d’utilisation
• Payant : indiquez le prix et la fréquence de facturation
• Freemium : décrivez ce qui est inclus gratuitement et ce qui est payant
• À l’usage : expliquez les paliers tarifaires ou le coût unitaire

Tester votre app

Avant la soumission, testez votre app en profondeur :

Tester en mode sandbox

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

# Verify sandbox compatibility
stripe apps validate

Format des identifiants de test

Lorsque vous fournissez des identifiants de test à l’équipe de révision, utilisez ce format :

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

Liste de contrôle avant révision

Avant de soumettre, vérifiez les points suivants :

• L’app fonctionne en mode live comme en mode test
• Toutes les permissions ont une description de finalité claire
• Les états d’erreur sont gérés proprement
• Les états de chargement s’affichent pour les opérations asynchrones
• Aucune donnée de test codée en dur dans le build de production
• L’URL de la politique de confidentialité est accessible et exacte
• Les coordonnées de support sont valides
• Toutes les images de la fiche respectent les dimensions requises
• La description de l’app reflète fidèlement ses fonctionnalités

Après la soumission

L’équipe de révision de Stripe répond généralement sous 5 à 10 jours ouvrés. Elle peut :

• Approuver votre app pour publication
• Demander des modifications avec des retours précis
• Rejeter l’app si elle ne respecte pas les exigences

Si des modifications sont demandées, traitez l’ensemble des retours et soumettez à nouveau. Chaque nouvelle soumission repasse par le cycle de révision complet.

Mettre à jour une app publiée

Pour mettre à jour une app déjà publiée :

1. Incrémentez la version dans stripe-app.json
2. Envoyez la nouvelle version : stripe apps upload
3. Soumettez la mise à jour à la révision
4. Une fois approuvée, la mise à jour est déployée automatiquement chez tous les utilisateurs