> ## Documentation Index
> Fetch the complete documentation index at: https://developers.ligdicash.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

<Warning>
  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.
</Warning>

## 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

<CardGroup cols={2}>
  <Card title="Configuration" icon="gear" href="/api-paiement/callback/configuration">
    Définir une URL de callback fiable et accessible publiquement.
  </Card>

  <Card title="Payload Payin" icon="arrow-down-to-line" href="/api-paiement/callback/payload-payin">
    Anatomie complète du payload reçu lors d'un paiement entrant.
  </Card>

  <Card title="Payload Payout" icon="arrow-up-from-line" href="/api-paiement/callback/payload-payout">
    Différences du payload pour un payout.
  </Card>

  <Card title="Sécurisation" icon="shield-check" href="/api-paiement/callback/securisation">
    Le pattern de re-vérification avant tout traitement.
  </Card>

  <Card title="Parser custom_data" icon="code" href="/api-paiement/callback/parser-custom-data">
    Extraire votre transaction\_id selon le type de flux.
  </Card>

  <Card title="Idempotence" icon="arrows-rotate" href="/api-paiement/callback/idempotence">
    Dédupliquer les deux requêtes reçues par événement.
  </Card>

  <Card title="Exemples par framework" icon="laptop-code" href="/api-paiement/callback/exemples-frameworks">
    Implémentations complètes en PHP, Laravel, Node.js, Python.
  </Card>
</CardGroup>
