> ## 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.

# Expirer une transaction de paiement

> Expirer un lien de paiement pour empêcher tout paiement ultérieur.

## Endpoint

`POST /expire-pay`

Expire un lien de paiement pour empêcher tout paiement ultérieur.

<Note>Seules les transactions créées avec l'endpoint [initiate-pay](/fr/api-reference/endpoint/initiate-pay) peuvent être expirées.</Note>

## Paramètres

| Nom     | Obligatoire | Type   | Description                    |
| :------ | :---------- | :----- | :----------------------------- |
| transId | Oui         | chaîne | ID de la transaction à expirer |

## Réponse

* Retourne les détails de la transaction expirée si l’opération réussit.
* Retourne un `400 Bad Request` avec le message `"Link already expired"` si la transaction était déjà expirée.


## OpenAPI

````yaml /fr/api-reference/openapi.json POST /expire-pay
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:
  /expire-pay:
    post:
      summary: Expirer une Transaction de Paiement
      description: >-
        Invalider un lien de paiement pour empêcher d'autres paiements. Seules
        les transactions créées avec l'endpoint
        [initiate-pay](/fr/api-reference/endpoint/initiate-pay) peuvent être
        expirées.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                transId:
                  type: string
                  description: Identifiant de la transaction à expirer.
              required:
                - transId
      responses:
        '200':
          description: Lien de paiement expiré avec succès
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transaction'
        '400':
          description: Lien déjà expiré ou requête invalide
          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

````