Comment configurer une configuration avancée de webhook Stripe

Ce document contient des options de configuration avancées qui ne sont pas nécessaires pour la plupart des sites.
_{Consultez notre documentation sur les webhooks standard pour la configuration de base.}

Les webhooks permettent à Stripe de renvoyer des messages à votre site WordPress. La configuration des webhooks est nécessaire pour certaines fonctionnalités de WP Simple Pay, telles que l’envoi d’e-mails, la création de plans de paiement échelonné, l’autorisation des clients à mettre à jour les détails de paiement de leur abonnement, et l’utilisation de son intégration avec AffiliateWP.

Ajout de l’URL de rappel

Pour ajouter les points de terminaison de webhook appropriés, accédez à Développeurs → Webhooks dans votre tableau de bord Stripe.

Cliquez sur Ajouter un point de terminaison, puis ajoutez l’URL trouvée dans WP Simple Pay → Paramètres → Stripe → Webhooks.

Vous devrez maintenant ajouter les événements spécifiques à écouter en cliquant sur le bouton +Sélectionner des événements. Après cela, vous pouvez copier et coller chaque événement listé ci-dessous dans la boîte de recherche Sélectionner les événements à envoyer → Rechercher des événements.

Après avoir recherché chaque terme, cochez la case pour l’ajouter, puis recherchez d’autres termes. Ne cliquez pas sur Ajouter des événements avant d’avoir coché tous les événements listés ci-dessous :

• charge.failed
• charge.remboursé
• charge.succeeded
• checkout.session.completed
• invoice.payment_succeeded
• invoice.upcoming
• paiement_intent.processing
• payment_intent.succeeded
• customer.subscription.deleted
• customer.subscription.updated

Les détails sur la fonctionnalité de chacun de ces événements sont présentés en bas de ce document.

Une fois que vous avez terminé d’ajouter des événements, cliquez sur Ajouter un point de terminaison pour terminer le processus. Après avoir ajouté le point de terminaison, vous devriez voir la nouvelle URL listée dans les paramètres des webhooks.

Configuration du secret de signature des webhooks

Stripe peut signer les événements webhook qu'il envoie à vos points de terminaison pour une sécurité accrue, et nous vous recommandons vivement de le configurer.

Pour ce faire, récupérez le secret de votre URL de rappel depuis les paramètres des webhooks de votre Tableau de bord. Sélectionnez une URL de rappel pour laquelle vous souhaitez obtenir le secret, puis cliquez sur le bouton Révéler.

Copiez ensuite le secret de signature depuis le Tableau de bord Stripe, retournez à l’onglet Configuration Stripe de votre administration WP, puis collez-le dans la zone de texte Secret de l’URL de rappel pour le mode de paiement actuel.

Vos webhooks sont maintenant configurés et sécurisés.

Actuellement, WP Simple Pay utilise les événements suivants :

Descriptions des types d'événements

invoice.payment_succeeded

• Utilisé pour incrémenter les plans de paiement échelonné et envoyer les e-mails « Confirmation de paiement » et « Notification de paiement » e-mails pour les abonnements.
• Expose l’action simpay_webhook_subscription_created pour un traitement ultérieur après un abonnement réussi.

payment_intent.succeeded

• Envoie les e-mails « Confirmation de paiement » et « Notification de paiement » e-mails pour les paiements uniques.
• Expose l’action simpay_webhook_payment_intent_succeeded pour un traitement ultérieur après un paiement réussi

charge.succeeded

• Envoie les e-mails « Confirmation de paiement » et « Notification de paiement » e-mails pour les paiements uniques par débit ACH.
• Expose l’action simpay_webhook_charge_succeeded pour un traitement ultérieur après un paiement réussi

invoice.upcoming

• Envoie le rappel par e-mail « Facture à venir » e-mail pour la mise à jour d'un mode de paiement. En savoir plus

checkout.session.completed

• Utilisé pour supprimer les enregistrements de paiement abandonnés générés par Stripe Checkout.
• Expose l’action simpay_webhook_checkout_session_completed pour un traitement ultérieur si nécessaire.

plan.updated

• Utilisé pour garantir que la liste des plans d’abonnement est à jour lors de la configuration des options d’abonnement.

charge.failed

• Expose l’action simpay_webhook_charge_failed pour un traitement ultérieur après l’échec d’un paiement.