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

# Vérifier le statut d'un payout

> Interroge le statut d'un payout (wallet ou mobile money) à partir du token retourné à la création.

## En-têtes

<ParamField header="Apikey" type="string" required>
  Clé API du projet LigdiCash.
</ParamField>

<ParamField header="Authorization" type="string" required>
  `Bearer {API_TOKEN}`
</ParamField>

## Paramètre de requête

<ParamField query="withdrawalToken" type="string" required>
  Token retourné par l'endpoint de création du payout (`/withdrawal/create` ou `/straight/payout`).
</ParamField>

## Réponse

<ResponseField name="response_code" type="string">`"00"` = appel réussi, autre valeur = erreur.</ResponseField>
<ResponseField name="token" type="string">Token JWT du payout — identique à celui passé en paramètre.</ResponseField>
<ResponseField name="response_text" type="string">Libellé du code de résultat. Peut être vide.</ResponseField>
<ResponseField name="description" type="string">Description complémentaire. Peut être vide.</ResponseField>
<ResponseField name="custom_data" type="array">Toujours `[]`.</ResponseField>
<ResponseField name="status" type="string">Statut du payout : `completed`, `pending` ou `notcompleted`.</ResponseField>
<ResponseField name="operator_id" type="string">Identifiant de l'opérateur. Exemple : `"11"` pour Orange Burkina.</ResponseField>
<ResponseField name="operator_name" type="string">Nom de l'opérateur. Exemple : `"ORANGE BURKINA"`.</ResponseField>
<ResponseField name="wiki" type="string">URL de la documentation des sous-codes.</ResponseField>

| `status`       | Signification               |
| -------------- | --------------------------- |
| `completed`    | Payout finalisé avec succès |
| `pending`      | Traitement en cours         |
| `notcompleted` | Payout échoué               |

<CodeGroup>
  ```json completed theme={null}
  {
    "response_code": "00",
    "token": "{PAYOUT_TOKEN}",
    "response_text": "",
    "description": "",
    "custom_data": [],
    "status": "completed",
    "operator_id": "11",
    "operator_name": "ORANGE BURKINA",
    "wiki": "https://client.ligdicash.com/wiki/createStraightWithdrawal"
  }
  ```

  ```json pending theme={null}
  {
    "response_code": "00",
    "token": "{PAYOUT_TOKEN}",
    "status": "pending",
    "operator_id": "",
    "operator_name": "",
    "wiki": "https://client.ligdicash.com/wiki/createStraightWithdrawal"
  }
  ```

  ```json Erreur API theme={null}
  {
    "response_code": "01",
    "response_text": "Echec (Code01)",
    "wiki": "https://client.ligdicash.com/wiki/createStraightWithdrawal"
  }
  ```
</CodeGroup>

## Codes d'erreur

Wiki : `https://client.ligdicash.com/wiki/createStraightWithdrawal` — voir [Sous-codes par endpoint](/erreurs/sous-codes#createstraightwithdrawal).

## Guide associé

[Vérifier le statut d'un payout](/api-paiement/payout/verifier-statut) — stratégie polling vs callback.