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

# Créer un retrait manuel

> Les retraits en même devise (NGN) et mobile money s'exécutent automatiquement. Les retraits bancaires en USD/EUR/GBP et tous les retraits transfrontaliers (source USD, destination locale) sont créés
en attente d'approbation administrative. Pour les opérations transfrontalières, `amount` est le montant à destination.
Transmettez un en-tête `Idempotency-Key` unique ou un champ `clientReference` dans le corps. Répéter la même clé renvoie le retrait d'origine sans l'exécuter à nouveau.




## OpenAPI

````yaml openapi.fr.json post /v1/payouts
openapi: 3.0.0
info:
  title: Inflow API
  version: 1.0.0
  description: Service d'API pour la gestion des cartes clients
  contact:
    name: API Support
servers:
  - url: https://sandbox.inflowafrica.com/api
    description: Bac à sable
  - url: https://app.inflowpay.net/api
    description: Production
  - url: http://localhost:3000/api
    description: Local
security:
  - bearerAuthFr: []
tags: []
paths:
  /v1/payouts:
    post:
      tags:
        - External API - Payouts
      summary: Créer un retrait manuel
      description: >
        Les retraits en même devise (NGN) et mobile money s'exécutent
        automatiquement. Les retraits bancaires en USD/EUR/GBP et tous les
        retraits transfrontaliers (source USD, destination locale) sont créés

        en attente d'approbation administrative. Pour les opérations
        transfrontalières, `amount` est le montant à destination.

        Transmettez un en-tête `Idempotency-Key` unique ou un champ
        `clientReference` dans le corps. Répéter la même clé renvoie le retrait
        d'origine sans l'exécuter à nouveau.
      parameters:
        - in: header
          name: Idempotency-Key
          required: false
          schema:
            type: string
            maxLength: 128
          description: >-
            Requis sauf si clientReference est fourni dans le corps de la
            demande. Unique par organisation.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - payoutAccountId
                - amount
              properties:
                payoutAccountId:
                  type: string
                  format: uuid
                amount:
                  type: number
                  description: >-
                    Montant cible pour le multi-devises ; sinon
                    source==destination
                sourceCurrency:
                  type: string
                  example: USD
                  description: Portefeuille à débiter ; omettre pour la même devise
                clientReference:
                  type: string
                  maxLength: 128
                  description: >-
                    Requis sauf si Idempotency-Key est fourni. Doit correspondre
                    à l'en-tête lorsque les deux sont envoyés.
                metadata:
                  type: object
      responses:
        '200':
          description: >-
            Retrait existant renvoyé pour un rejeu idempotent ;
            Idempotency-Replayed est vrai
        '201':
          description: >-
            Retrait créé (en cours de traitement si auto-exécuté, sinon en
            attente)
        '400':
          description: Validation / solde insuffisant / corridor non pris en charge
        '404':
          description: Compte de retrait introuvable
        '409':
          description: >-
            La clé d'idempotence a déjà été utilisée avec des détails de retrait
            différents
      security:
        - apiKeyAuthFr: []
components:
  securitySchemes:
    bearerAuthFr:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Saisissez le jeton JWT
    apiKeyAuthFr:
      type: http
      scheme: bearer
      description: Saisissez votre clé API commençant par gtw_sk_

````