Le callback (webhook) — Introduction

LigdiCash envoie un POST sur votre URL de callback à chaque événement de paiement. Le mécanisme central pour la fiabilité de votre intégration.

Le callback est une notification HTTP que LigdiCash envoie à votre serveur lorsqu’une transaction change de statut — paiement complété, paiement échoué, payout finalisé. C’est le mécanisme principal pour connaître le résultat d’une transaction en temps réel, sans interroger l’API en boucle.

​

Comment ça fonctionne

Vous fournissez une callback_url lors de chaque requête de création de transaction. Quand LigdiCash dispose d’un résultat, il envoie un POST à cette URL avec les détails de la transaction.

​

Les deux requêtes envoyées

LigdiCash envoie deux requêtes POST pour chaque événement : une en application/x-www-form-urlencoded et une en application/json. Les deux contiennent les mêmes informations. Votre serveur recevra donc deux appels par événement — prévoyez une logique de déduplication.

​

Ce que le callback ne garantit pas

• Le payload reçu ne doit jamais être considéré comme source de vérité. N’importe qui connaissant votre URL de callback peut envoyer un faux payload. Toujours re-vérifier via l’endpoint confirm avec le token stocké à la création avant d’agir.

​

Dans cette section

Configuration

Définir une URL de callback fiable et accessible publiquement.

Payload Payin

Anatomie complète du payload reçu lors d’un paiement entrant.

Payload Payout

Différences du payload pour un payout.

Sécurisation

Le pattern de re-vérification avant tout traitement.

Parser custom_data

Extraire votre transaction_id selon le type de flux.

Idempotence

Dédupliquer les deux requêtes reçues par événement.

Exemples par framework

Implémentations complètes en PHP, Laravel, Node.js, Python.