> ## 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. # Consulter votre portefeuille > Portefeuille unique : les encaissements le créditent, les transferts le débitent. `available = balance − reserved`, où `reserved` est la part immobilisée par vos transferts en cours. **C'est `available` qui détermine ce que vous pouvez engager**, pas `balance`. ## OpenAPI ````yaml /openapi-guichet.yaml get /merchants/me/wallet 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: /merchants/me/wallet: get: tags: - Portefeuille summary: Consulter votre portefeuille description: > Portefeuille unique : les encaissements le créditent, les transferts le débitent. `available = balance − reserved`, où `reserved` est la part immobilisée par vos transferts en cours. **C'est `available` qui détermine ce que vous pouvez engager**, pas `balance`. operationId: getWallet responses: '200': description: Votre portefeuille. content: application/json: schema: type: object properties: wallet: $ref: '#/components/schemas/Wallet' '401': $ref: '#/components/responses/Unauthorized' components: schemas: Wallet: type: object properties: walletId: type: string format: uuid merchantId: type: string format: uuid currency: $ref: '#/components/schemas/Currency' balance: type: integer description: Solde total détenu. example: 500000 reserved: type: integer description: Part immobilisée par les transferts en cours. example: 20000 available: type: integer description: > `balance − reserved` : ce que vous pouvez réellement engager dans un nouveau transfert. example: 480000 status: type: string enum: - ACTIVE - FROZEN - CLOSED totalCollected: type: integer description: Cumul encaissé depuis l'ouverture du compte. totalDisbursed: type: integer description: Cumul transféré depuis l'ouverture du compte. totalFees: type: integer description: Cumul des commissions prélevées. updatedAt: type: string format: date-time Currency: type: string description: > Devise. Aucune n'a de sous-unité : les montants sont toujours des entiers. enum: - XOF - XAF - GNF example: XOF 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' 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.