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

# Récupérer le statut d'une transaction

> Obtenir le status d'une transaction (NB: si vous en abuser vous serez bloqué par le système)

Cette page documente l'opération pour obtenir le statut d'une transaction.

Description:

* Endpoint: POST `/status` (base URL défini dans la collection Postman)
* Utilisation: récupère le statut actuel d'une transaction via son ID.

Exemple de requête (JSON):

```json theme={null}
{
  "api_key": "xxxxxxxxxxxxxxxx",
  "transaction_id": "EFB.001158"
}
```

Notes:

* `transaction_id` est retourné lors de l'initiation de la transaction.
* ⚠️ **Attention:** À utiliser avec parcimonie. Un abus de ces requêtes peut entraîner un blocage par le système.
* La confirmation finale des transactions arrive normalement via l'IPN (webhook), il n'est pas nécessaire d'interroger le statut en continu.

Vous trouverez plus de détails sur les webhooks dans la [documentation des webhooks](/guides/webhooks/introduction)


## OpenAPI

````yaml POST /status
openapi: 3.1.0
info:
  title: API MARCHAND KAYBIC AFRICA
  description: |-
    Collection pour l'API KAYBIC AFRICA  API V1

    Documentation: https://documenter.getpostman.com/view/23936159/2s84DoT3w1

    BASE_URL: https://proxy-airtime.easytransfert.app/api_v1/transaction

    **Prérequis:**
    - Clé API valide
    - Pour Cashout: au moins un wallet opérateur configuré
    - Pour Cashin: suffisamment de fonds sur le compte partenaire
  version: 1.0.0
servers:
  - url: https://proxy-airtime.easytransfert.app/api_v1/transaction
security: []
paths:
  /status:
    post:
      description: >-
        Obtenir le status d'une transaction (NB: si vous en abuser vous serez
        bloqué par le système)
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                api_key:
                  type: string
                  description: Votre clé d'API
                  examples:
                    - xxxxxxxxxxxxxxxxxxx
                transaction_ids:
                  type: string
                  description: Identifiant de la transaction (transaction_id)
                  examples:
                    - EFB.001158
              required:
                - transaction_ids
                - api_key
      responses:
        '200':
          description: Transaction initiated successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      transaction_id:
                        type: string
                        example: EFB.001158
                      amount:
                        type: number
                        example: 3005
                      benefice:
                        type: number
                        example: 3005
                      commission:
                        type: number
                        example: 0
                      destination:
                        type: string
                        example: '0777321219'
                      fee:
                        type: number
                        example: 0
                      error:
                        type: string
                        example: ''
                      service_id:
                        type: number
                        example: 10
                      customer_name:
                        type: string
                        example: KAYBIC AFRICA
                      state:
                        type: string
                        example: FAILED
                      custom_data:
                        type: string
                        example: custom_data
                      ipn_url:
                        type: string
                        example: ''
                      provider_id:
                        type: 'null'
                        example: null
                      created_at:
                        type: string
                        example: '2022-09-27T07:07:47.000+00:00'
                      updated_at:
                        type: string
                        example: '2022-09-27T07:07:47.000+00:00'
                      p_last_wallet_amount:
                        type: number
                        example: null
                      p_new_wallet_amount:
                        type: 'null'
                        example: null
                      p_id:
                        type: number
                        example: 1
                      hash:
                        type: string
                        example: null
                  message:
                    type: string
                    example: ''
                  statut_code:
                    type: number
                    example: 200

````