Confirmations de paiement WhatsApp depuis Stripe via webhooks
Stripe déclenche un événement webhook pour chaque résultat de paiement qui compte — réussi, échoué, remboursé, contesté. L'essentiel de ce signal n'arrive que dans une boîte e-mail ou un canal Slack que votre client ne voit jamais. Acheminer ces mêmes événements directement vers WhatsApp place une confirmation sous les yeux de la personne qui a payé, dans le canal qu'elle a déjà ouvert, quelques secondes après la validation du paiement. Voici comment relier Stripe directement à TextMeFlow, sans application connecteur tierce.
Pourquoi aller directement de Stripe à l'API
Une intégration générique « WhatsApp pour Stripe » signifie généralement un abonnement de plus, un tableau de bord de plus et un fournisseur de plus qui détient vos données de paiement. Les webhooks de Stripe contiennent déjà tout ce dont vous avez besoin — montant, devise, client, moyen de paiement — de sorte qu'un petit récepteur qui transmet les champs pertinents à l'API de messages de TextMeFlow ne coûte rien de plus que le quota de messages de votre plan actuel. Vous gardez le contrôle total du texte, de la logique de déclenchement et du choix des événements qui méritent réellement un message.
Étape 1 : abonnez-vous aux événements qui comptent
Dans le Dashboard Stripe, sous Developers → Webhooks, ajoutez un endpoint et sélectionnez uniquement les événements qui nécessitent un message destiné au client :
payment_intent.succeeded→ confirmation de paiementpayment_intent.payment_failed→ alerte de paiement échoué (carte refusée, fonds insuffisants)charge.refunded→ confirmation de remboursement
Résistez à la tentation de vous abonner à tous les types d'événements proposés par Stripe. Chaque événement dont vous ne faites rien est un poids mort que votre récepteur doit filtrer, et une liste d'événements gonflée complique le débogage quand quelque chose ne va pas.
Étape 2 : vérifier et analyser le webhook
Stripe signe chaque charge utile avec un en-tête Stripe-Signature. Vérifiez-le avant de faire confiance au corps — avec la même rigueur que celle que vous devriez déjà appliquer aux signatures des webhooks de TextMeFlow sur le chemin de retour vers votre application.
app.post('/webhooks/stripe', express.raw({ type: 'application/json' }), (req, res) => {
let event;
try {
event = stripe.webhooks.constructEvent(
req.body,
req.headers['stripe-signature'],
process.env.STRIPE_WEBHOOK_SECRET
);
} catch (err) {
return res.status(400).send(`signature verification failed: ${err.message}`);
}
if (event.type === 'payment_intent.succeeded') {
const pi = event.data.object;
const phone = pi.metadata?.customer_phone;
if (phone) sendPaymentConfirmation(phone, pi);
}
res.status(200).send('ok');
});
L'objet payment_intent ne contient pas de numéro de téléphone par défaut — vous devez l'y placer vous-même, généralement en l'ajoutant comme métadonnée lors de la création du PaymentIntent au moment du paiement. Si votre formulaire de paiement ne recueille pas de numéro de téléphone, ce schéma n'aura tout simplement personne à qui écrire ; anticipez-le au moment du paiement, pas dans le gestionnaire de webhook.
Étape 3 : envoyer la confirmation
curl -X POST https://api.textmeflow.eu/v1/messages \
-H "Authorization: Bearer $TEXTMEFLOW_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to": "+32470123456",
"text": "Bonjour Sarah, nous avons bien reçu votre paiement de 49,00 € pour la facture #INV-2091. Merci de votre confiance !"
}'
Pour un paiement échoué, gardez un ton pratique plutôt qu'alarmant — « votre paiement n'a pas pu être traité, veuillez vérifier les informations de votre carte et réessayer » obtient une meilleure réponse que tout ce qui ressemble à un avertissement. Si vous facturez séparément, le même endpoint accepte des pièces jointes jusqu'à 100 Mo : un reçu PDF peut donc partir dans le même appel que le texte.
Étape 4 : rester dans les règles anti-spam
Une confirmation de paiement est transactionnelle — un message personnalisé déclenché par l'action d'un client — et ne touche donc pas aux déclencheurs de type diffusion du score de risque anti-spam de TextMeFlow. Deux points restent importants pour une intégration Stripe :
- Ne réessayez pas à l'aveugle. Stripe réessaie lui-même les livraisons de webhook échouées selon son propre calendrier ; si votre récepteur réessaie en plus, vous risquez d'envoyer deux fois la même confirmation. Utilisez l'
idde l'événement pour dédoublonner avant d'appeler l'API de messages. - Respectez le STOP. Si un client s'est précédemment désinscrit de WhatsApp, un nouveau paiement n'y change rien — TextMeFlow rejette les envois vers des numéros désinscrits, quelle que soit la façon dont le déclencheur est arrivé.
Ce que cela apporte par rapport aux reçus par e-mail
Stripe envoie déjà un reçu par e-mail automatiquement : le message WhatsApp ne le remplace donc pas — c'est celui que le client lit réellement dans les premières minutes. Les accusés de livraison et de lecture reviennent sur le webhook propre de TextMeFlow, vous savez donc si la confirmation a été vue, pas seulement envoyée. Ce même schéma s'étend à tout événement de facturation pour lequel Stripe peut déclencher un webhook : renouvellements d'abonnement, rappels de fin de période d'essai ou message de relance avant l'expiration d'une carte.
Commencez gratuitement avec TextMeFlow — 50 messages par mois, sans limite de durée, de quoi mettre en place et tester un flux complet de confirmation de paiement avant de choisir un plan.
Envie d'envoyer des messages WhatsApp via API ?
Gratuit pour toujours jusqu'à 50 messages/mois. Scannez un QR et envoyez votre premier message en 5 minutes.
Gratuit pour toujours