> ## 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. # Lister vos opérations > Encaissements et transferts confondus, les plus récents d'abord. ## OpenAPI ````yaml /openapi-guichet.yaml get /operations 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: get: tags: - Opérations summary: Lister vos opérations description: Encaissements et transferts confondus, les plus récents d'abord. operationId: listOperations parameters: - name: type in: query schema: $ref: '#/components/schemas/OperationType' - name: status in: query schema: $ref: '#/components/schemas/OperationStatus' - name: country in: query schema: $ref: '#/components/schemas/Country' - name: operator in: query schema: $ref: '#/components/schemas/Operator' - name: externalReference in: query description: Votre propre référence d'opération. schema: type: string maxLength: 120 - name: from in: query description: Borne basse de création, au format ISO 8601. schema: type: string format: date-time - name: to in: query description: Borne haute de création, au format ISO 8601. schema: type: string format: date-time - $ref: '#/components/parameters/Limit' - $ref: '#/components/parameters/Offset' responses: '200': description: Page d'opérations. content: application/json: schema: type: object properties: total: type: integer example: 184 limit: type: integer example: 50 offset: type: integer example: 0 items: type: array items: $ref: '#/components/schemas/Operation' '401': $ref: '#/components/responses/Unauthorized' components: schemas: OperationType: type: string enum: - CASHIN - CASHOUT 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 Country: type: string description: Pays, en ISO 3166-1 alpha-2. enum: - CI - BF - ML - SN - TG - BJ - NE - CM - GN example: CI Operator: type: string description: > Opérateur mobile money. Tous ne sont pas disponibles dans tous les pays — voir le guide « Pays et opérateurs ». enum: - ORANGE - MTN - MOOV - WAVE - DJAMO example: ORANGE Operation: type: object description: > Représentation d'une opération. C'est la forme renvoyée par les endpoints de création, de consultation, et dans le corps des notifications. properties: reference: type: string description: > Référence Djonanko de l'opération. C'est l'identifiant à conserver et à citer. Préfixée `GUI-CI-` pour un encaissement, `GUI-CO-` pour un transfert. example: GUI-CI-20261001-7K2M9QX4 type: $ref: '#/components/schemas/OperationType' status: $ref: '#/components/schemas/OperationStatus' amount: type: integer description: Montant demandé, en unités entières. example: 5000 fees: type: integer description: Commission Djonanko, figée à la création de l'opération. example: 100 netAmount: type: integer description: > Impact sur votre portefeuille. Sur un encaissement, ce qui vous est crédité (`amount − fees`). Sur un transfert, ce qui vous est prélevé (`amount + fees`). example: 4900 currency: $ref: '#/components/schemas/Currency' country: $ref: '#/components/schemas/Country' operator: $ref: '#/components/schemas/Operator' counterparty: $ref: '#/components/schemas/Counterparty' externalReference: type: - string - 'null' description: Votre propre référence, telle que vous l'avez transmise. example: CMD-2026-00184 description: type: - string - 'null' example: Commande 184 payerActionUrl: type: - string - 'null' description: > URL sur laquelle envoyer le payeur. Renseignée uniquement quand l'opérateur exige une redirection. `null` sur un transfert. example: https://pay.example.com/s/abc123 requiresPayerAction: type: boolean description: > `true` si l'encaissement attend une action du payeur sur `payerActionUrl`. example: true failure: type: - object - 'null' description: Renseigné uniquement si l'opération a échoué. properties: code: $ref: '#/components/schemas/OperationFailureCode' message: type: string example: Le solde du compte mobile money du payeur est insuffisant. metadata: type: - object - 'null' description: Vos données libres, restituées telles quelles. additionalProperties: true createdAt: type: string format: date-time updatedAt: type: string format: date-time completedAt: type: - string - 'null' format: date-time description: Horodatage du passage à un état définitif. expiresAt: type: - string - 'null' format: date-time description: > Au-delà, une opération sans issue passe en `EXPIRED`. 30 minutes pour un encaissement, 6 heures pour un transfert. Currency: type: string description: > Devise. Aucune n'a de sous-unité : les montants sont toujours des entiers. enum: - XOF - XAF - GNF example: XOF Counterparty: type: object description: Le payeur sur un encaissement, le bénéficiaire sur un transfert. properties: phoneNumber: type: string description: Numéro normalisé au format E.164. example: '+2250701020304' name: type: - string - 'null' example: Aya Koné OperationFailureCode: type: string description: > Cause de l'échec d'une opération. - `OPERATOR_INSUFFICIENT_FUNDS` — solde mobile money insuffisant - `OPERATOR_ACCOUNT_UNKNOWN` — compte inconnu ou inactif - `OPERATOR_ACCOUNT_LIMIT_REACHED` — plafond du compte atteint - `PAYER_CANCELLED` — le payeur a refusé - `OPERATOR_TIMEOUT` — l'opérateur n'a pas répondu - `OPERATOR_REFUSED` — refus sans motif précis - `UPSTREAM_UNAVAILABLE` — indisponibilité temporaire - `SETTLEMENT_ACCOUNT_UNAVAILABLE` — indisponibilité temporaire côté Djonanko - `INTERNAL_ERROR` — erreur interne enum: - OPERATOR_INSUFFICIENT_FUNDS - OPERATOR_ACCOUNT_UNKNOWN - OPERATOR_ACCOUNT_LIMIT_REACHED - PAYER_CANCELLED - OPERATOR_TIMEOUT - OPERATOR_REFUSED - UPSTREAM_UNAVAILABLE - SETTLEMENT_ACCOUNT_UNAVAILABLE - INTERNAL_ERROR 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 parameters: Limit: name: limit in: query required: false description: Nombre maximum d'éléments renvoyés. schema: type: integer minimum: 1 maximum: 200 default: 50 Offset: name: offset in: query required: false description: Nombre d'éléments à ignorer avant de commencer la page. schema: type: integer minimum: 0 default: 0 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' 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.