> ## 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. # Historique d'état d'une opération > Chaque changement d'état, dans l'ordre chronologique. Utile pour comprendre le parcours d'une opération lors d'un litige. ## OpenAPI ````yaml /openapi-guichet.yaml get /operations/{reference}/events openapi: 3.1.0 info: title: Djonanko Guichet API version: 1.0.0 description: > API d'agrégation mobile money de Djonanko. Elle permet à une entreprise partenaire d'**encaisser** (`cash-in`) et de **transférer** (`cash-out`) sur les réseaux mobile money d'Afrique de l'Ouest et du Centre, directement depuis ses propres serveurs. Contrairement à l'API Djonanko Pay, le Guichet ne passe **ni par un lien de paiement ni par une page hébergée** : vous appelez l'API, le client est sollicité sur son téléphone, et vous recevez l'issue par notification signée. ### Ce qu'il faut retenir avant de commencer - **Authentification** : `x-api-key` + `x-api-secret` sur chaque appel. - **Montants entiers** : le XOF, le XAF et le GNF n'ont pas de sous-unité. `5000` vaut 5 000 FCFA. Aucune décimale n'est acceptée. - **Idempotence obligatoire** : l'en-tête `Idempotency-Key` est exigé sur `POST /cashin` et `POST /cashout`. - **Un portefeuille unique** par compte : les encaissements le créditent, les transferts le débitent. - **Notifications signées** : vérifiez l'en-tête `Djonanko-Signature` avant de traiter. Toutes les réponses sont en JSON. Chaque réponse porte un en-tête `x-request-id` à citer dans vos demandes de support. contact: name: Support Djonanko url: https://www.djonanko.ci/#contact servers: - url: https://guichet.apidjonanko.tech/v1 description: Production security: - ApiKey: [] ApiSecret: [] tags: - name: Encaissement description: Débiter un compte mobile money vers votre portefeuille. - name: Transfert description: Créditer un compte mobile money depuis votre portefeuille. - name: Opérations description: Consulter l'état et l'historique de vos opérations. - name: Portefeuille description: Solde et relevé des mouvements. - name: Compte description: Création de compte, profil, clés d'API. - name: Sécurité description: Adresses IP autorisées. - name: Notifications description: Configuration, supervision et rejeu des notifications sortantes. paths: /operations/{reference}/events: get: tags: - Opérations summary: Historique d'état d'une opération description: > Chaque changement d'état, dans l'ordre chronologique. Utile pour comprendre le parcours d'une opération lors d'un litige. operationId: listOperationEvents parameters: - name: reference in: path required: true schema: type: string example: GUI-CI-20261001-7K2M9QX4 responses: '200': description: Historique. content: application/json: schema: type: object properties: items: type: array items: type: object properties: fromStatus: oneOf: - $ref: '#/components/schemas/OperationStatus' - type: 'null' description: '`null` pour l''événement de création.' toStatus: $ref: '#/components/schemas/OperationStatus' reason: type: - string - 'null' occurredAt: type: string format: date-time example: items: - fromStatus: null toStatus: CREATED reason: Opération enregistrée occurredAt: '2026-10-01T10:12:04.000Z' - fromStatus: CREATED toStatus: AWAITING_PAYER reason: Réponse de soumission occurredAt: '2026-10-01T10:12:05.000Z' - fromStatus: AWAITING_PAYER toStatus: SUCCEEDED reason: Confirmation reçue occurredAt: '2026-10-01T10:13:47.000Z' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' components: schemas: OperationStatus: type: string description: > État d'une opération. - `CREATED` — enregistrée, pas encore soumise - `PENDING` — soumise, en attente d'issue - `AWAITING_PAYER` — encaissement : le payeur doit agir - `SUCCEEDED` — aboutie *(définitif)* - `FAILED` — refusée *(définitif)* - `EXPIRED` — aucune issue dans le délai *(définitif)* - `CANCELLED` — annulée avant exécution *(définitif)* - `REVERSED` — contre-passée *(définitif)* Une opération réussie ne repasse jamais en échec. Le seul mouvement possible depuis `SUCCEEDED` est `REVERSED`. enum: - CREATED - PENDING - AWAITING_PAYER - SUCCEEDED - FAILED - EXPIRED - CANCELLED - REVERSED Error: type: object description: Forme de toutes les réponses d'erreur. properties: success: type: boolean enum: - false error: type: object properties: code: type: string description: > Code stable. **Branchez votre logique dessus**, jamais sur `message`, qui peut être reformulé. example: INSUFFICIENT_BALANCE message: type: string example: Le solde disponible de votre portefeuille est insuffisant. details: type: - object - 'null' description: Contexte complémentaire, variable selon le code. additionalProperties: true requestId: type: string description: Également renvoyé dans l'en-tête `x-request-id`. example: 9f1c2b7e-4a5d-4c8f-b0a1-e2d3c4b5a697 timestamp: type: string format: date-time responses: Unauthorized: description: Identifiants absents ou invalides. content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false error: code: INVALID_CREDENTIALS message: Identifiants API invalides. requestId: 9f1c2b7e-4a5d-4c8f-b0a1-e2d3c4b5a697 timestamp: '2026-10-01T10:12:04.000Z' NotFound: description: Ressource introuvable. content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: ApiKey: type: apiKey in: header name: x-api-key description: Votre clé publique, préfixée `gk_live_` (ou `gk_test_`). ApiSecret: type: apiKey in: header name: x-api-secret description: > Votre secret, préfixé `gs_live_` (ou `gs_test_`). Affiché une seule fois, à l'émission de la clé. Il ne doit jamais quitter vos serveurs. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.