Configuration du webhook Stripe

Dans cet article, nous vous guiderons pas à pas dans la configuration des webhooks Stripe. MEC effectue les réservations de manière fiable, même si le client ne revient jamais sur votre site web.

Pourquoi les webhooks ?

Par défaut, MEC Stripe confirme la réservation lorsque le client est redirigé vers votre site web après le paiement. Si le client ferme l'onglet du navigateur, perd sa connexion ou si la redirection est bloquée, le paiement est bien enregistré dans Stripe, mais la réservation n'est jamais finalisée.

Grâce aux webhooks, Stripe notifie directement votre site web des paiements réussis. MEC Le système confirme ensuite la réservation automatiquement, indépendamment du comportement du navigateur du client. Cela réduit considérablement les demandes d'assistance concernant les billets « payés mais non réservés ».

Les webhooks fonctionnent à la fois pour les passerelles Stripe et Stripe Connect.

À noter: Les webhooks sont facultatifs mais fortement recommandés. Sans webhook, MEC bascule vers un comportement de redirection uniquement.

Étape 1 – Copiez l'URL de votre webhook

Allez dans MEC Paramètres > Réservation > Passerelles de paiement > Stripe et localiser le Secret du webhook Le texte d'aide situé sous ce champ affiche l'URL du webhook de votre site :

https://yourdomain.com/wp-json/mec/v1/stripe/webhook

Copiez cette URL, vous la collerez dans votre tableau de bord Stripe à l'étape suivante.

Étape 2 – Ajouter le point de terminaison dans Stripe

1. Connectez-vous à votre Tableau de bord à rayures.
2. Accédez à Développeurs > Webhooks.
3. Cliquez à nouveau Ajouter un point de terminaison.
4. Collez l'URL du webhook que vous avez copiée à l'étape 1.
5. Sous Événements sélectionnés, choisissez uniquement l'événement suivant :
   • payment_intent.succeeded
6. Cliquez à nouveau Ajouter un point de terminaison.

Étape 3 – Copier le code secret de signature

Une fois le point de terminaison créé, Stripe affiche son Signature secrète (cela commence par whsec_). Cliquez sur Révéler et copiez-le.

Étape 4 – Collez le secret dans MEC

De retour à MEC Paramètres > Réservation > Passerelles de paiement > Stripe, collez le secret de signature dans le Secret du webhook Sélectionnez le champ et enregistrez les paramètres.

C'est tout. MEC Désormais, chaque message webhook est vérifié à l'aide de ce secret ; les requêtes ne provenant pas de votre compte Stripe sont rejetées.

Stripe Connect

Si vous utilisez la passerelle Stripe Connect , configurez le webhook pour votre compte de plateforme de la même manière :

1. Le modèle d'URL du webhook est identique (/wp-json/mec/v1/stripe/webhook sur votre site web).
2. souscrivez a notre newsletter payment_intent.succeeded.
3. Collez le code secret de signature dans le Secret du webhook champ des paramètres Stripe Connect.

Lorsque le module de paiement de l'organisateur est activé et que les organisateurs connectent leurs propres comptes Stripe, les paramètres par organisateur incluent le même champ secret Webhook pour leur point de terminaison de compte connecté.

Tester votre webhook

1. Permettre Mode bac à sable/test dans les paramètres de la passerelle Stripe (ou utilisez les clés de test de Stripe).
2. Réservez un événement avec Stripe carte d'essai (par exemple 4242 4242 4242 4242).
3. Fermez l'onglet du navigateur immédiatement après le paiement, avant que la redirection ne se produise.
4. Après quelques secondes, vérifiez MEC > Réservations: la réservation devrait apparaître comme confirmée, transmise par le webhook, et non par la redirection.

Vous pouvez également inspecter les livraisons sous Développeurs > Webhooks > votre point de terminaison dans le tableau de bord Stripe pour voir chaque événement MEC reçu.

Dépannage

« Signature webhook Stripe invalide »
Le secret de signature ne correspond pas. Veuillez afficher le secret du point de terminaison exact que vous avez créé et le coller à nouveau. MECSi vous avez recréé le point de terminaison, n'oubliez pas que le nouveau point de terminaison reçoit un nouveau secret.

« La clé secrète du webhook Stripe n'est pas configurée. »
Le champ secret Webhook dans MEC est vide. Passez à l'étape 4.

Les événements apparaissent dans Stripe, mais les réservations ne sont pas confirmées.
Assurez-vous que le point de terminaison est abonné à payment_intent.succeeded (Vous n'êtes pas checkout.session.completed ou d'autres événements), et que l'URL du webhook pointe vers le même site Web qui contient la réservation.