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

# Notification de paiement

> Envoyée en `POST` sur votre URL de webhook dès qu'un paiement aboutit (`SUCCESS`) ou échoue (`FAILED`).

- En-têtes : `Content-Type: application/json`, `User-Agent: Djonanko-Webhook/1.0`.
- Timeout : 15 s. Répondez `2xx` le plus vite possible et traitez en asynchrone.
- Rejeu automatique : 3 tentatives immédiates (2 s, 4 s, 8 s) puis 5 min → 15 min → 1 h → 6 h → 24 h.
- Les réponses `400`, `401`, `404` et `422` **ne sont pas rejouées**.


<Warning>
  Ce webhook n'est pas signé. Confirmez toujours le statut avec [`GET /web-merchant/payment/status`](/api-reference/paiements/payment-status) avant toute action irréversible. Guide complet : [Webhooks](/guides/webhooks).
</Warning>


## OpenAPI

````yaml webhook paymentNotification
openapi: 3.1.0
info:
  title: Djonanko Pay API
  version: 1.0.0
  description: >
    API de la passerelle de paiement mobile money **Djonanko Pay**.


    Deux modes d'authentification coexistent :


    - **Clé API** (`x-api-key` + `x-api-secret`) — pour l'intégration serveur à
    serveur :
      création de liens de paiement et de QR codes.
    - **Jeton marchand** (`authenticationtoken`) — un JWT obtenu via `POST
    /user/login-merchant`,
      utilisé par le dashboard marchand pour tout le reste (statut, solde, reversements, rapports…).

    Toutes les réponses sont en JSON. Les montants sont exprimés en **FCFA (XOF
    / XAF)** sans décimales.
  contact:
    name: Support Djonanko
    url: https://www.djonanko.ci/#contact
servers:
  - url: https://apidjonanko.tech
    description: Production
security: []
tags:
  - name: Authentification
  - name: Paiements
  - name: Solde & statistiques
  - name: Webhooks
  - name: Reversements
  - name: Sécurité
  - name: Rapports
  - name: Compte marchand
paths: {}

````