Général

Webhooks de paiement : ce que c’est et comment automatiser la confirmation des commandes

Découvrez ce que sont les webhooks de paiement, comment ils fonctionnent et comment confirmer automatiquement dans votre système ou ERP les commandes payées par Pix, carte et boleto au Brésil.

Par Equipe Sila Pay4 min de lecture
Développeuse souriante dans un espace de coworking, travaillant sur son ordinateur portable vue de profil

Quand un client paie, il faut prévenir votre système : valider la commande, préparer le stock, émettre la facture et envoyer la confirmation. Le faire en vérifiant vos relevés fonctionne au début, mais ralentit tout dès que les ventes augmentent. C’est précisément le rôle des webhooks de paiement.

Qu’est-ce qu’un webhook de paiement

C’est une notification automatique que la plateforme de paiement envoie à une adresse (URL) de votre système chaque fois qu’il se passe quelque chose sur un encaissement : un Pix a été payé, un boleto a été réglé, un achat par carte a été accepté ou remboursé. Au lieu d’interroger régulièrement la plateforme pour savoir si le client a payé, votre système est averti dès que le statut change.

Comment ça marche, étape par étape

  1. Vous indiquez l’URL : l’adresse de votre système qui recevra les notifications, configurée dans le tableau de bord ou envoyée dans le champ postbackUrl d’un encaissement créé via l’API.
  2. Le client paie : par Pix, carte de crédit ou boleto.
  3. La plateforme envoie la notification : une requête HTTP POST contenant les données de l’événement en JSON.
  4. Votre système confirme la commande : il vérifie la notification, met à jour le statut et répond par un HTTP 200 pour en accuser réception.

Ce que contient un webhook

Chaque notification comporte un identifiant unique d’événement, le statut du paiement et les données de la transaction. Exemple simplifié : {"id": "evt_...", "status": "LIQUIDATED", "data": {"value": "16.5", "txId": "...", "method": "pix"}}.

Avec Sila Pay, vous choisissez aussi dans le tableau de bord les événements à recevoir, par exemple achat accepté (purchase_approved), Pix payé (pix_paid), boleto payé (boleto_paid), Pix expiré et achat remboursé.

Où les webhooks vous simplifient la vie

  • Validation automatique des commandes : la commande passe à « payée » dans votre système ou votre ERP sans vérification des relevés.
  • Stock et expédition : la préparation démarre dès que le paiement est confirmé.
  • Produits numériques et services : donnez accès à un contenu, un billet ou un rendez-vous juste après le paiement.
  • Encaissements expirés : sachez quand un Pix ou un boleto a expiré sans paiement et relancez le client.

Envie d’automatiser la confirmation de vos commandes ? Ouvrez votre compte Sila Pay

Bonnes pratiques pour recevoir des webhooks

  • Vérifiez la signature : chaque notification Sila Pay contient l’en-tête X-Silapay-Signature, un HMAC-SHA256 calculé avec votre secret. Contrôlez-le avant tout traitement.
  • Répondez vite : renvoyez un HTTP 200 en 5 secondes maximum et reportez les tâches longues, comme l’émission de la facture.
  • Gérez les doublons : si votre système ne répond pas, la plateforme réessaie ; utilisez l’id de l’événement pour ne jamais traiter deux fois la même notification.
  • Utilisez HTTPS et protégez le secret : conservez-le sur votre serveur, jamais sur votre site ni dans votre application.

Questions fréquentes

Faut-il être développeur pour utiliser les webhooks ?

Quelqu’un doit préparer l’adresse qui reçoit les notifications. De nombreux ERP et plateformes e-commerce proposent déjà cette fonction ; si vous utilisez WooCommerce ou Shopify, Sila Pay propose des plugins pour connecter votre boutique.

Quelle différence entre un webhook et une API ?

Avec l’API, c’est votre système qui appelle la plateforme, par exemple pour créer un encaissement. Avec le webhook, c’est la plateforme qui appelle votre système pour lui signaler un changement. Les deux fonctionnent généralement ensemble.

Et si mon système est indisponible ?

Sila Pay effectue automatiquement de nouvelles tentatives lorsqu’elle ne reçoit pas de réponse HTTP 200. Il reste prudent de prévoir un rapprochement régulier pour les indisponibilités prolongées.

Où trouver la documentation ?

Sur doc.silapay.pro, avec la liste des événements, le format du payload et un exemple de vérification de la signature.

Confirmez vos commandes automatiquement, sans vérifier vos relevés. Inscrivez-vous sur Sila Pay

#pagamentos#vendas online
PartagerWhatsAppLinkedInX

Prêt à passer à l'action ?

Créez votre compte Sila Pay en quelques minutes et commencez à encaisser par Pix, carte et lien de paiement.

  • ✓ Inscription gratuite
  • ✓ Sans abonnement
  • ✓ Réception à J+1
Créer un compte gratuit →

Recevez les prochains articles

Du contenu pratique sur les paiements et la vente en ligne, directement dans votre boîte mail.

Pas de spam. Désabonnement à tout moment.

À lire aussi

Sila Pay

Tout ce qu'il vous faut pour vendre, au même endroit.

Commencer →