Cette documentation détaille la procédure complète pour créer et configurer un environnement Stripe en mode production.
Si vous souhaitez effectuer des tests, un environnement de test dédié est disponible. Nous vous recommandons fortement de créer et utiliser un environnement de test au préalable afin de valider votre configuration.
Vous trouverez ici la procédure pour créer cet environnement ainsi que le lien associé : https://docs.stripe.com/sandboxes/dashboard/manage#create-a-sandbox
Le contenu de cette aide est basé sur un environnement en mode production. Notez toutefois que les interfaces entre production et test sont très similaires, et que les étapes restent quasiment identiques.
Configurer le connecteur Stripe (mode production)
Recommandation
Nous vous conseillons de réaliser un paiement de test avant toute mise en production afin de valider l'ensemble de la configuration.
Prérequis
Avant de commencer, assurez-vous :
- de disposer d'un compte Stripe actif ;
- d'avoir accès au tableau de bord Stripe avec les droits d'administration ;
- d'avoir accès au back-office de votre événement inwink.
Étape 1 : Récupérer vos clés API Stripe
Connectez-vous à votre tableau de bord Stripe : https://dashboard.stripe.com
Vous aurez besoin des informations suivantes :
- Clé publique (Publishable Key)
- Clé secrète (Secret Key)
Ces clés sont disponibles :
- sur la page d'accueil du tableau de bord Stripe ;
- dans Développeurs > Clés API.
Attention
Vérifiez que vous utilisez les clés correspondant à votre environnement :
- Clés Test pour les tests.
- Clés Production (Live) pour l'environnement réel.
Étape 2 : Créer le webhook Stripe
Le webhook permet à Stripe de notifier automatiquement inwink lorsqu'un paiement a été finalisé.
Accéder à la configuration
Dans Stripe : Développeurs > Webhooks
Puis cliquez sur : Ajouter une destination.
Sélectionner les événements
Lors de la création :
- Sélectionnez Votre compte.
- Conservez la version d'API proposée par Stripe.
- Cliquez sur Tous les événements.
- Recherchez puis sélectionnez :
checkout.session.completed
- Cliquez sur Continuer.
Configurer la destination
Sélectionnez : Endpoint de webhook
Puis renseignez :
-
Nom : inwink
-
URL de destination : https://api-front.inwink.com/callback/stripe/notify
- Description (facultatif)
- Webhook de synchronisation inwink
Cliquez ensuite sur : Créer une destination.
Vérifiez que le webhook apparaît bien dans la liste des endpoints avec le statut : Actif
Étape 3 : Configurer le connecteur Stripe dans inwink
Dans votre back-office inwink :
Mon événement > Configuration > Intégrations outils tiers
Activez le connecteur Stripe.
Renseignez ensuite :
- la clé publique Stripe (commençant par PK)
- la clé secrète Stripe (commençant par SK)
- le mode Live si vous utilisez des clés de production.
Cliquez sur : Valider
puis sur : Enregistrer (en haut à droite de la page)
Validation de la configuration
Une configuration est considérée comme correcte lorsque :
✅ le connecteur Stripe est activé dans inwink ;
✅ les clés API Stripe sont enregistrées ;
✅ le webhook est actif dans Stripe ;
✅ un paiement de test remonte correctement dans inwink.
Erreur 107
Cette erreur correspond généralement à :
- Une erreur de clé ou d’identifiant → Vérifiez votre saisie dans Stripe
- Un prix de billet trop faible → Le montant doit être supérieur à 0,50 €