Confirmations de paiement WhatsApp via webhooks Mollie
Mollie est le prestataire de paiement de la plupart des boutiques en ligne belges et néerlandaises, et il envoie un webhook à votre serveur à chaque changement de statut d'un paiement. La plupart des boutiques laissent ce signal s'arrêter à un statut de commande dans la base de données ou à une notification Slack interne. Transmettre ce même signal directement à WhatsApp affiche une confirmation de paiement — ou un avertissement clair en cas d'échec — sur l'écran du client en quelques secondes, dans le canal qu'il a déjà ouvert.
Pourquoi directement depuis le webhook
Vous n'avez pas besoin d'une application ou d'un plugin « WhatsApp pour Mollie » distinct. Le webhook Mollie ne vous donne qu'un identifiant de paiement ; le reste, vous le récupérez avec un appel d'API auprès de Mollie lui-même. Un petit récepteur qui transmet ce résultat à l'API de messages de TextMeFlow ne coûte rien de plus que votre quota de messages existant, et vous gardez la maîtrise du texte, des déclencheurs et des statuts qui méritent réellement un message.
Étape 1 : définir l'URL du webhook chez Mollie
Lorsque vous créez un paiement (via la Payments API ou un plugin comme WooCommerce/Mollie), vous transmettez une webhookUrl. Mollie envoie ensuite un POST à cette URL chaque fois que le statut du paiement change — pas seulement en cas de succès, mais à chaque changement (ouvert, payé, échoué, expiré, annulé).
curl -X POST https://api.mollie.com/v2/payments \
-H "Authorization: Bearer live_xxx" \
-H "Content-Type: application/json" \
-d '{
"amount": {"currency": "EUR", "value": "49.00"},
"description": "Commande #4821",
"redirectUrl": "https://jouwshop.be/bedankt",
"webhookUrl": "https://jouwshop.be/webhooks/mollie",
"metadata": {"customer_phone": "+32470123456"}
}'
Placez le numéro de téléphone du client dans metadata au moment où vous créez le paiement. La charge utile du webhook de Mollie ne contient pas elle-même de numéro de téléphone — si vous ne le transmettez pas ici, vous n'aurez rien à qui envoyer la confirmation.
Étape 2 : recevoir le webhook et interroger le statut
Le corps du webhook de Mollie ne contient qu'un id — ni montant, ni statut, ni données client. Ce n'est pas une lacune mais tout l'intérêt : vous récupérez toujours le paiement vous-même auprès de Mollie, de sorte que vous ne vous fiez jamais à quelque chose qui aurait pu être manipulé dans l'appel POST lui-même.
app.post('/webhooks/mollie', express.urlencoded({ extended: false }), async (req, res) => {
const paymentId = req.body.id;
res.status(200).send('ok'); // accuser réception immédiatement, traiter ensuite
const payment = await mollieClient.payments.get(paymentId);
const phone = payment.metadata?.customer_phone;
if (!phone) return;
if (payment.status === 'paid') {
await sendPaymentConfirmation(phone, payment);
} else if (payment.status === 'failed' || payment.status === 'expired') {
await sendPaymentFailed(phone, payment);
}
});
Accusez toujours réception de l'appel webhook immédiatement avec un 200, et effectuez le traitement proprement dit — l'appel à Mollie, l'envoi WhatsApp — ensuite. Mollie ne vous laisse que quelques secondes et relance sinon agressivement, ce qui, sans déduplication, entraîne des messages en double.
Étape 3 : envoyer la confirmation WhatsApp
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 EUR pour la commande #4821. Merci pour votre achat !"
}'
En cas de paiement échoué ou expiré, gardez un ton pratique plutôt qu'alarmiste : « votre paiement n'a pas abouti, cliquez ici pour payer à nouveau » fonctionne mieux qu'un message qui ressemble à un avertissement. Une facture ou une confirmation de paiement en PDF doit être jointe ? Le même endpoint accepte des pièces jointes jusqu'à 100 Mo, elles peuvent donc partir dans le même appel.
Étape 4 : respecter les règles anti-spam
Une confirmation de paiement est transactionnelle — un seul message personnalisé, déclenché par l'action du client lui-même — et échappe donc aux déclencheurs de type diffusion du score de risque anti-spam de TextMeFlow. Deux points restent toutefois importants, spécifiquement pour une intégration Mollie :
- Dédupliquez sur l'identifiant de paiement. Mollie peut livrer le même webhook plusieurs fois (en cas de réponse lente ou d'erreur réseau temporaire). Conservez un court cache des
iddéjà traités pour ne jamais envoyer deux fois la même confirmation. - Respectez STOP. Un client qui s'est désinscrit de WhatsApp auparavant reste désinscrit, même s'il effectue maintenant un paiement — TextMeFlow refuse les messages vers les numéros désinscrits, quel que soit le déclencheur.
Plus que la simple confirmation
Ce schéma ne se limite pas au premier paiement. Les mêmes statuts de webhook peuvent aussi servir à un rappel après l'échec du premier paiement d'un abonnement, ou à un message de remerciement lors d'un remboursement. Comme vous passez directement de Mollie à l'API de messages, sans couche intermédiaire d'un tiers, les données de vos clients restent dans les systèmes que vous utilisez déjà — et dans l'hébergement européen de TextMeFlow à Paris.
Démarrez gratuitement avec TextMeFlow — 50 messages par mois, valables à vie, de quoi tester cette intégration avant de passer à un plan payant.
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