· 6 min · TextMeFlow Team

Confirmation de paiement WhatsApp via webhooks PayPal

PayPal reste le bouton de paiement par défaut de nombreuses boutiques en ligne et de la facturation freelance, mais son e-mail de confirmation passe facilement inaperçu dans une boîte de réception surchargée. L'API Webhooks de PayPal vous signale déjà à l'instant où un paiement aboutit, échoue ou est remboursé : il manque simplement l'étape qui transforme cet événement en un message que le client voit réellement. Voici comment relier PayPal directement à l'API TextMeFlow, sans outil d'automatisation tiers entre les deux.

Pourquoi passer directement de PayPal à l'API

PayPal prend en charge les webhooks depuis des années, mais la plupart des montages « WhatsApp pour PayPal » passent par une plateforme d'automatisation générique, qui ajoute son propre délai, son propre tableau de bord et un intermédiaire détenant vos données de paiement. La charge utile du webhook PayPal contient déjà le nom du payeur, le montant, la devise et l'identifiant de transaction : de quoi construire un message de confirmation avec un petit script récepteur. Ce script envoie ses requêtes à l'API de messages de TextMeFlow, de sorte que le seul coût récurrent est le quota de messages de votre offre actuelle.

Étape 1 : abonnez-vous aux bons types d'événements

Dans le PayPal Developer Dashboard, sous les paramètres Webhooks de votre application, ajoutez une URL de point de terminaison et sélectionnez uniquement les événements qui méritent un message au client :

  • PAYMENT.CAPTURE.COMPLETED : confirmation de paiement
  • PAYMENT.CAPTURE.DENIED : alerte de paiement refusé
  • PAYMENT.CAPTURE.REFUNDED : confirmation de remboursement
  • CUSTOMER.DISPUTE.CREATED : alerte interne, pas destinée au client ; dirigez-la plutôt vers le numéro de votre propre équipe

S'abonner à tous les types d'événements disponibles revient simplement à devoir filtrer le bruit par la suite. Choisissez la poignée d'événements qui correspondent à un message que vous voulez réellement envoyer.

Étape 2 : vérifiez le webhook avant de lui faire confiance

PayPal signe chaque webhook avec un certificat et une signature de transmission (PAYPAL-TRANSMISSION-SIG, PAYPAL-CERT-URL, PAYPAL-TRANSMISSION-ID), à vérifier auprès du point de terminaison /v1/notifications/verify-webhook-signature de PayPal. Ne sautez jamais cette étape : une URL de webhook non vérifiée est un point de terminaison public sur lequel n'importe qui peut envoyer une requête POST. La même rigueur s'applique dans l'autre sens : vérifiez toujours la signature HMAC des webhooks de TextMeFlow avant d'agir sur un événement entrant.

app.post('/webhooks/paypal', express.json(), async (req, res) => {
  const verified = await verifyPaypalSignature(req.headers, req.body);
  if (!verified) return res.status(400).send('signature verification failed');

  const event = req.body;
  if (event.event_type === 'PAYMENT.CAPTURE.COMPLETED') {
    const capture = event.resource;
    const phone = capture.custom_id; // see step 3 on where this comes from
    if (phone) await sendPaymentConfirmation(phone, capture);
  }

  res.status(200).send('ok');
});

Étape 3 : faire entrer un numéro de téléphone dans la charge utile

L'objet capture de PayPal ne contient pas de numéro de téléphone par défaut. Le moyen fiable d'en intégrer un au webhook consiste à le renseigner dans custom_id (ou dans purchase_units[].custom_id) lors de la création de la commande, avant de rediriger l'acheteur vers PayPal, à partir de votre formulaire de paiement ou de votre propre fiche client. Sans cette étape, le webhook se déclenche mais votre récepteur n'a aucun numéro auquel envoyer un message : le problème doit donc être réglé au moment du paiement, pas dans le gestionnaire du webhook.

Étape 4 : 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 PayPal de 49,00 € pour la commande #ORD-3312. Merci pour votre confiance !"
  }'

Pour un paiement refusé, gardez une formulation pratique plutôt qu'alarmante : « votre paiement PayPal n'a pas pu aboutir, veuillez réessayer ou utiliser une autre carte » passe mieux que tout ce qui ressemble à un avertissement. Si vous joignez un reçu PDF au texte, le même point de terminaison accepte des pièces jointes jusqu'à 100 Mo en un seul appel.

Étape 5 : gérer correctement les nouvelles tentatives et les désinscriptions

Deux points comptent tout particulièrement pour une intégration PayPal :

  1. Dédoublonnez sur l'identifiant du webhook. PayPal renvoie les webhooks non délivrés selon son propre calendrier. Si votre récepteur a aussi sa propre logique de nouvelle tentative, vous risquez d'envoyer deux fois la même confirmation : conservez le champ id du webhook et ignorez tout ce qui a déjà été traité.
  2. Respectez STOP. Un paiement n'annule pas une désinscription antérieure. TextMeFlow bloque les envois vers un numéro qui s'est désinscrit, quel que soit l'événement à l'origine de l'envoi ; voyez comment la gestion de STOP s'intègre dans le pipeline anti-spam global.

Une confirmation de paiement est un message transactionnel individuel déclenché par l'action du client lui-même ; il échappe donc aux contrôles de type diffusion qui s'appliquent aux envois en masse. En revanche, STOP et le dédoublonnage s'appliquent à chaque message, quel que soit le déclencheur.

Au-delà de l'e-mail de confirmation

PayPal envoie déjà un reçu par e-mail dès qu'une capture aboutit : ce n'est donc pas un remplacement, mais le message que votre client lit réellement dans les premières minutes suivant le paiement. Les accusés de livraison et de lecture reviennent via le webhook propre à TextMeFlow, ce qui vous permet de savoir si une confirmation a été vue et pas seulement envoyée. Le même schéma de récepteur s'étend aux événements de facturation d'abonnement si vous utilisez PayPal pour des paiements récurrents, ou à un message « remboursement effectué » lorsqu'un retour est traité de votre côté.

Commencer gratuitement avec TextMeFlow : 50 messages par mois, sans limite de durée, de quoi construire et tester un flux complet de confirmation PayPal avant de vous engager sur une offre payante.

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