> ## 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'une facture payin

> Vérifie le statut d'une facture payin (redirect ou sans redirect) à partir du token de 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>

<ParamField header="Accept" type="string" required>
  `application/json`
</ParamField>

## Paramètre de requête

<ParamField query="token" type="string" required>
  Token retourné par l'endpoint `create` à la création de la facture. **Ne pas utiliser le token du callback** — ils sont différents.
</ParamField>

## Réponse

<ResponseField name="response_code" type="string">`"00"` = appel réussi, `"01"` = erreur technique.</ResponseField>
<ResponseField name="status" type="string">Statut du paiement : `completed`, `pending` ou `notcompleted`.</ResponseField>
<ResponseField name="token" type="string">Vide dans la réponse `confirm`.</ResponseField>
<ResponseField name="response_text" type="string">Sous-code d'erreur si `response_code = "01"`, vide sinon.</ResponseField>
<ResponseField name="description" type="string">Description libre. Peut être vide.</ResponseField>
<ResponseField name="operator_id" type="string">Identifiant de l'opérateur utilisé. Vide si `status = pending`.</ResponseField>
<ResponseField name="operator_name" type="string">Nom de l'opérateur. Vide si `status = pending`.</ResponseField>
<ResponseField name="customer" type="string">Numéro du payeur. `null` si `status = pending`.</ResponseField>
<ResponseField name="montant" type="integer">Montant en XOF.</ResponseField>
<ResponseField name="amount" type="integer">Identique à `montant`.</ResponseField>
<ResponseField name="date" type="string">Date de la transaction. Format : `YYYY-MM-DD HH:MM:SS+TZ`.</ResponseField>
<ResponseField name="external_id" type="string">Concaténation des `valueof_customdata` dont la clé contient `"id"`. Correspond au `transaction_id` si le pattern est respecté.</ResponseField>
<ResponseField name="oreference" type="string">Référence opérateur. Peut être vide.</ResponseField>
<ResponseField name="request_id" type="string">Identifiant unique LigdiCash. Utile pour le support.</ResponseField>

<ResponseField name="custom_data" type="array">
  Métadonnées enrichies par LigdiCash.

  <Expandable title="Champs d'une entrée">
    <ResponseField name="keyof_customdata" type="string">Clé. LigdiCash ajoute ses propres entrées (`logfile`).</ResponseField>
    <ResponseField name="valueof_customdata" type="string">Valeur.</ResponseField>
    <ResponseField name="datecreation_customdata" type="string">Date de création de l'entrée.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="customer_details" type="object">
  <Expandable title="Champs">
    <ResponseField name="firstname" type="string">Prénom.</ResponseField>
    <ResponseField name="lastname" type="string">Nom.</ResponseField>
    <ResponseField name="email" type="string">Email.</ResponseField>
    <ResponseField name="phone" type="string">Téléphone.</ResponseField>
    <ResponseField name="details" type="string">Informations complémentaires.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="wiki" type="string">URL de la documentation des sous-codes.</ResponseField>

| `status`       | Signification                      |
| -------------- | ---------------------------------- |
| `completed`    | Paiement confirmé                  |
| `pending`      | En attente de traitement opérateur |
| `notcompleted` | Paiement non abouti                |

<CodeGroup>
  ```json completed theme={null}
  {
    "response_code": "00",
    "status": "completed",
    "operator_id": "14",
    "operator_name": "MOOV CI",
    "customer": "2250171584035",
    "montant": 5000,
    "amount": 5000,
    "date": "2026-04-15 11:19:28+00",
    "external_id": "ORD-2025-00042",
    "oreference": "",
    "request_id": "P2771491712026",
    "token": "",
    "response_text": "",
    "description": "",
    "custom_data": [
      { "keyof_customdata": "transaction_id", "valueof_customdata": "ORD-2025-00042", "datecreation_customdata": "2026-04-15 11:19:28.977757" },
      { "keyof_customdata": "logfile", "valueof_customdata": "2026041511192869df7440ed917", "datecreation_customdata": "2026-04-15 11:19:28.977757" }
    ],
    "customer_details": { "firstname": "Amadou", "lastname": "Diallo", "email": "amadou@exemple.com", "phone": "2250171584035", "details": "" },
    "wiki": "https://client.ligdicash.com/wiki/confirmInvoice"
  }
  ```

  ```json pending theme={null}
  {
    "response_code": "00",
    "status": "pending",
    "operator_id": "",
    "operator_name": "",
    "customer": null,
    "montant": 5000,
    "amount": 5000,
    "date": "2026-04-22 16:51:02+00",
    "external_id": "ORD-2025-00042",
    "token": "",
    "response_text": "",
    "wiki": "https://client.ligdicash.com/wiki/confirmInvoice"
  }
  ```

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

## Codes d'erreur

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

## Guides associés

* [Vérifier le statut — payin redirect](/api-paiement/payin-redirect/verifier-statut)
* [Vérifier le statut — payin sans redirect](/api-paiement/payin-sans-redirect/verifier-statut)
* [Sécurisation du callback](/api-paiement/callback/securisation)