Guide d’intégration Stripe Apps

Les Stripe Apps vous permettent d’intégrer des fonctionnalités personnalisées directement dans le tableau de bord Stripe. Cette section est un guide de développement : elle documente comment une telle app pour l’intégration Tajo-Brevo serait construite, testée et publiée.

Que sont les Stripe Apps ?

Les Stripe Apps étendent le tableau de bord Stripe avec des composants d’interface personnalisés et des intégrations backend. Elles permettent aux développeurs tiers de :

• Ajouter des vues personnalisées aux pages du tableau de bord Stripe (clients, paiements, factures, etc.)
• Accéder aux données Stripe via des permissions ciblées
• Synchroniser les données entre Stripe et des plateformes externes comme Brevo
• Proposer des parcours d’onboarding et de configuration dans le tableau de bord

Objectifs de l’intégration Tajo + Brevo

La Stripe App de Tajo connecte Stripe à Brevo pour offrir :

• Connaissance client : synchronisez les profils clients Stripe, l’historique des paiements et la valeur vie client vers les contacts Brevo
• Suivi des événements : envoyez les événements Stripe (paiements, abonnements, remboursements) comme événements transactionnels Brevo
• Campagnes automatisées : déclenchez des campagnes e-mail, SMS et WhatsApp Brevo à partir de l’activité Stripe
• Programmes de fidélité : construisez des workflows de rétention à partir des données d’achat Stripe synchronisées vers Brevo

Vue d’ensemble de l’architecture

Contenu du guide

Cette documentation couvre le cycle de vie complet de la création et de la publication d’une Stripe App :

Pour commencer

Configuration et référence

Fonctionnalités et intégration

Exploitation et croissance

Prérequis

Avant de créer une Stripe App, assurez-vous de disposer des éléments suivants :

1. Compte Stripe : un compte Stripe activé (non restreint au mode test)
2. Stripe CLI : installez la Stripe CLI pour le développement local et l’envoi des apps
3. Node.js : version 16 ou ultérieure pour l’extension d’interface de l’app
4. Accès à la plateforme Tajo : un compte Tajo actif avec les identifiants de l’API Brevo configurés

Démarrage rapide

# Install Stripe CLI
brew install stripe/stripe-cli/stripe

# Login to your Stripe account
stripe login

# Create a new Stripe App project
stripe apps create tajo-brevo-integration

# Start local development
stripe apps start

Concepts clés

Manifest de l’app

Chaque Stripe App possède un manifest stripe-app.json qui déclare les permissions, les viewports et la configuration. Consultez la Référence du manifest de l’app pour le schéma complet.

Extensions d’interface

Les Stripe Apps peuvent afficher des composants d’interface basés sur React dans des viewports précis du tableau de bord. La boîte à outils d’interface fournit des composants prêts à l’emploi qui respectent le design system du tableau de bord Stripe.

Permissions

Les apps doivent déclarer les ressources précises de l’API Stripe auxquelles elles ont besoin d’accéder. Les utilisateurs approuvent ces permissions lors de l’installation. Consultez la Référence des permissions.

Secret de signature

Chaque app reçoit un secret de signature qui sert à vérifier les signatures d’installation et à sécuriser la communication entre votre backend et Stripe.

Workflow de développement

1. Définissez votre manifest avec les permissions et les viewports requis
2. Créez l’extension d’interface avec la bibliothèque de composants React de Stripe
3. Implémentez les endpoints backend pour la synchronisation des données avec Brevo via Tajo
4. Testez en local avec stripe apps start
5. Envoyez l’app avec stripe apps upload
6. Soumettez l’app à la révision depuis le tableau de bord Stripe
7. Publiez l’app et suivez-la via les analytics

Prochaines étapes

Commencez par le Guide de publication pour comprendre l’ensemble des exigences, puis parcourez les références techniques pour configurer le manifest et les permissions de votre app.