> ## 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 une demande de paiement

> Crée une demande de paiement open banking. Renvoie un jeton de lien
que l'organisation doit intégrer dans son interface.
Le client autorise le paiement auprès de sa banque.




## OpenAPI

````yaml openapi.fr.json post /v1/payments
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/payments:
    post:
      tags:
        - External API - Payments
      summary: Créer une demande de paiement
      description: |
        Crée une demande de paiement open banking. Renvoie un jeton de lien
        que l'organisation doit intégrer dans son interface.
        Le client autorise le paiement auprès de sa banque.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - targetAmount
                - sourceCurrency
                - targetCurrency
                - reference
                - customerId
              properties:
                targetAmount:
                  type: number
                  description: Montant cible du paiement
                  example: 35000
                sourceCurrency:
                  type: string
                  description: Code de devise source ISO 4217
                  example: EUR
                targetCurrency:
                  type: string
                  description: >-
                    Code de devise cible ISO 4217 (devise de retrait prise en
                    charge)
                  example: NGN
                description:
                  type: string
                  example: Monthly subscription
                reference:
                  type: string
                  description: Référence de paiement unique (obligatoire).
                customerId:
                  type: string
                  format: uuid
                  description: >-
                    Identifiant du client pour associer le paiement à un client
                    spécifique (obligatoire).
                payerName:
                  type: string
                payerEmail:
                  type: string
                redirectUrl:
                  type: string
                  description: URL de redirection après l'autorisation du paiement
                provider:
                  type: string
                  description: >
                    Fournisseur d'open banking. Par défaut l'environnement
                    PAYMENT_PROVIDER.
                paymentType:
                  type: string
                  description: >-
                    Indication facultative du type de paiement (DOMESTIC_PAYMENT
                    par défaut).
                metadata:
                  type: object
      responses:
        '201':
          description: >
            Paiement créé. Renvoie un linkToken, une checkoutUrl ou un
            paymentLink hébergé à partager avec le payeur pour autoriser le
            paiement.
        '400':
          description: Erreur de validation
        '409':
          description: Référence en doublon
      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_

````