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

# Obtenir le statut d’une transaction de paiement

> Récupérez le statut d’une transaction de paiement en utilisant son identifiant de transaction.

## Endpoint

`GET /payment-status/:transId`

Vérifiez le statut d’un paiement via son identifiant de transaction.

## Valeurs du statut

| Statut     | Signification                                                                                                                                                                                                                                                        |
| :--------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| CREATED    | Paiement pas encore tenté.                                                                                                                                                                                                                                           |
| PENDING    | L’utilisateur est en cours de paiement.                                                                                                                                                                                                                              |
| SUCCESSFUL | Paiement complété avec succès.                                                                                                                                                                                                                                       |
| FAILED     | Paiement échoué.                                                                                                                                                                                                                                                     |
| EXPIRED    | Cela signifie que 24 heures se sont écoulées depuis la génération du lien de paiement sans qu’aucune tentative de paiement réussie n’ait été effectuée, OU que le lien a été [expiré manuellement](/fr/api-reference/endpoint/expire-pay) pour empêcher le paiement. |

<Note>Aucun paiement ne peut être effectué une fois le statut SUCCESSFUL ou EXPIRED.</Note>

<Note>
  Pour un identifiant de transaction donné, vous pouvez effectuer au maximum **6 requêtes par minute**. Au-delà de cette limite, l’API renvoie une réponse **429**.

  Il est généralement préférable de s’appuyer sur les [notifications webhook](/fr/api-reference/endpoint/webhook) pour savoir quand le statut d’un paiement change, plutôt que d’interroger cet endpoint en boucle.
</Note>


## OpenAPI

````yaml /fr/api-reference/openapi.json GET /payment-status/{transId}
openapi: 3.1.0
info:
  title: API de Paiement Fapshi
  description: >-
    API pour générer des liens de paiement, des paiements directs, la
    surveillance des transactions, les retraits, et plus encore.
  version: 1.0.0
servers:
  - url: https://sandbox.fapshi.com
security:
  - apiAuth: []
    apiKey: []
paths:
  /payment-status/{transId}:
    get:
      summary: Obtenir le Statut d'une Transaction de Paiement
      description: >-
        Récupérer le statut d'une transaction de paiement par son identifiant de
        transaction.
      parameters:
        - name: transId
          in: path
          required: true
          schema:
            type: string
          description: Identifiant de la transaction du paiement.
      responses:
        '200':
          description: Statut du paiement récupéré avec succès
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transaction'
        4XX:
          description: Identifiant de transaction invalide ou erreur
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Transaction:
      type: object
      properties:
        transId:
          type: string
          description: Identifiant de la transaction du paiement.
        status:
          type: string
          enum:
            - CREATED
            - PENDING
            - SUCCESSFUL
            - FAILED
            - EXPIRED
          description: Statut de la transaction
        medium:
          type: string
          enum:
            - mobile money
            - orange money
          description: Méthode de paiement
        serviceName:
          type: string
          description: Nom du service utilisé
        transType:
          type: string
          enum:
            - Collection
            - Payout
          description: Type de transaction
        amount:
          type: integer
          description: Montant de la transaction
        revenue:
          type: integer
          description: Montant reçu après déduction des frais Fapshi
        payerName:
          type: string
          description: Nom du client
        email:
          type: string
          format: email
          description: Email du client
        redirectUrl:
          type: string
          format: uri
          description: URL de redirection après le paiement
        externalId:
          type: string
          description: Identifiant de la transaction sur votre application
        userId:
          type: string
          description: Identifiant du client sur votre application
        webhook:
          type: string
          format: uri
          description: Le webhook que vous avez défini pour votre service
        reason:
          type: string
          description: Apparaît généralement lorsqu'un retrait via fapshi échoue.
        financialTransId:
          type: string
          description: Identifiant de la transaction avec l'opérateur de paiement
        dateInitiated:
          type: string
          format: date
          description: Date à laquelle le paiement a été initié
        dateConfirmed:
          type: string
          format: date
          description: Date à laquelle le paiement a été effectué
    Error:
      type: object
      properties:
        message:
          type: string
          description: Message d'erreur.
  securitySchemes:
    apiAuth:
      type: apiKey
      in: header
      name: apiuser
    apiKey:
      type: apiKey
      in: header
      name: apikey

````