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

# Glossaire

> Définitions des termes techniques et métier utilisés dans la documentation LigdiCash.

Ce glossaire regroupe les termes que vous rencontrerez dans la documentation LigdiCash. Chaque définition est reliée aux pages où le concept est développé en détail.

## A–C

<AccordionGroup>
  <Accordion title="Apikey">
    Clé d'identification de votre projet API. Elle est transmise dans le header `Apikey` de chaque requête. Elle identifie le projet, pas l'utilisateur. À ne pas confondre avec le `Auth Token`.

    Voir [Authentification](/concepts/authentification).
  </Accordion>

  <Accordion title="Auth Token (Bearer)">
    Jeton d'authentification du compte marchand. Il est transmis dans le header `Authorization: Bearer {AUTH_TOKEN}`. Associé à l'`Apikey`, il forme la paire d'identification requise sur tous les endpoints.

    Voir [Authentification](/concepts/authentification).
  </Accordion>

  <Accordion title="Callback (webhook)">
    Requête HTTP POST envoyée automatiquement par LigdiCash vers votre serveur lorsqu'une transaction change de statut. LigdiCash envoie **deux requêtes** à chaque événement : une en `application/x-www-form-urlencoded` et une en `application/json`. Pensez à dédupliquer.

    Voir [Introduction au callback](/api-paiement/callback/introduction).
  </Accordion>

  <Accordion title="Checkout invoice">
    Facture de paiement créée côté LigdiCash lors de l'initiation d'un payin. Elle est identifiée par un `token` unique et contient les détails de la transaction (montant, opérateur, store, custom\_data). Le terme apparaît dans les endpoints (`/checkout-invoice/create`, `/checkout-invoice/confirm`).
  </Accordion>

  <Accordion title="custom_data">
    Tableau de métadonnées libres que vous attachez à une transaction lors de sa création. Il est retourné tel quel dans le callback, ce qui vous permet de retrouver votre propre identifiant de commande. LigdiCash y ajoute ses propres champs (`logfile`, `id_invoice`). Peut prendre trois formes dans le callback : tableau peuplé, `[]` (vide), ou `""` (chaîne vide).

    Voir [Parser custom\_data](/api-paiement/callback/parser-custom-data).
  </Accordion>
</AccordionGroup>

## D–L

<AccordionGroup>
  <Accordion title="external_id">
    Champ présent dans les requêtes payin sans redirection. Dans la plupart des cas, il doit rester vide (`""`). Ne pas confondre avec `transaction_id` que vous définissez dans `custom_data`.
  </Accordion>

  <Accordion title="Invoice">
    Voir **Checkout invoice**.
  </Accordion>

  <Accordion title="keyof_customdata / valueof_customdata">
    Structure d'un élément du tableau `custom_data`. Chaque entrée est un objet `{ keyof_customdata: "clé", valueof_customdata: "valeur" }`. Pour retrouver votre identifiant de commande, filtrez sur `keyof_customdata === "transaction_id"`.

    Voir [Parser custom\_data](/api-paiement/callback/parser-custom-data).
  </Accordion>
</AccordionGroup>

## M–O

<AccordionGroup>
  <Accordion title="Marchand">
    Entreprise ou développeur intégrant l'API LigdiCash pour accepter ou émettre des paiements. Votre compte marchand est géré depuis le [Dashboard LigdiCash](https://client.ligdicash.com).
  </Accordion>

  <Accordion title="Mobile money">
    Service de paiement mobile proposé par les opérateurs téléphoniques (Orange Money, Moov Africa, MTN, Wave, etc.). LigdiCash est un agrégateur : il abstrait tous ces opérateurs derrière une API unique.
  </Accordion>

  <Accordion title="operator_id">
    Identifiant numérique retourné par l'API dans les réponses et callbacks pour désigner l'opérateur utilisé (ex : `11` pour Orange Burkina). Utile pour le logging et la réconciliation. Ne s'envoie pas dans les requêtes.

    Voir [Opérateurs supportés](/reference/operateurs-supportes).
  </Accordion>

  <Accordion title="operator_name">
    Nom lisible de l'opérateur retourné par l'API (ex : `"ORANGE BURKINA"`). Toujours en majuscules dans les réponses LigdiCash.

    Voir [Opérateurs supportés](/reference/operateurs-supportes).
  </Accordion>

  <Accordion title="OTP (One-Time Password)">
    Code à usage unique servant à autoriser une transaction de payin sans redirection. Selon l'opérateur, il est généré par le client via menu USSD, envoyé par SMS, ou remplacé par une approbation directe sur l'app mobile money.

    Voir [Modes de validation](/api-paiement/payin-sans-redirect/modes-validation).
  </Accordion>
</AccordionGroup>

## P–R

<AccordionGroup>
  <Accordion title="Payin">
    Opération de collecte : le client paie le marchand. LigdiCash propose deux modes — avec redirection (le client est renvoyé vers une page de paiement hébergée) et sans redirection (le paiement est initié programmatiquement via OTP ou approbation).

    Voir [Vue d'ensemble de l'API de paiement](/api-paiement/vue-ensemble).
  </Accordion>

  <Accordion title="Payin avec redirection">
    Mode de payin où le client est redirigé vers une page de paiement hébergée par LigdiCash. L'intégration est simple mais impose des contraintes : pas d'iframe, `customer` vide, gestion des popups.

    Voir [Payin avec redirection — Introduction](/api-paiement/payin-redirect/introduction).
  </Accordion>

  <Accordion title="Payin sans redirection">
    Mode de payin où le marchand gère l'interface et soumet l'OTP via API. Plus de contrôle sur l'UX, mais une intégration plus complexe et spécifique à chaque opérateur.

    Voir [Payin sans redirection — Introduction](/api-paiement/payin-sans-redirect/introduction).
  </Accordion>

  <Accordion title="Payout">
    Opération de décaissement : le marchand envoie de l'argent à un client ou partenaire. Deux variantes : vers le wallet LigdiCash du destinataire (`/withdrawal/create`) ou directement vers son mobile money (`/straight/payout`).

    Voir [Payout — Introduction](/api-paiement/payout/introduction).
  </Accordion>

  <Accordion title="Projet API">
    Entité créée dans le Dashboard LigdiCash qui regroupe une `Apikey` et un `Auth Token`. Un compte marchand peut avoir plusieurs projets API (un par application, par pays, etc.).

    Voir [Créer un projet API](/concepts/projet-api).
  </Accordion>

  <Accordion title="response_code">
    Code de retour présent dans toutes les réponses API LigdiCash. `"00"` = succès, `"01"` = échec. En cas d'échec, le champ `wiki` contient une URL vers la description détaillée.

    Voir [Codes de réponse et statuts](/concepts/codes-reponse-statuts).
  </Accordion>
</AccordionGroup>

## S–T

<AccordionGroup>
  <Accordion title="Statut de transaction">
    État courant d'une transaction. Valeurs possibles : `Completed` (confirmée), `Pending` (en attente), `Cancelled` (annulée). À récupérer via l'endpoint `confirm` ou via le callback.

    Voir [Cycle de vie d'une transaction](/concepts/cycle-vie-transaction).
  </Accordion>

  <Accordion title="Store">
    Objet représentant votre boutique dans une requête LigdiCash. Contient `name`, `website_url`, `logo_url`, et `return_url`. Apparaît dans le body des requêtes de création de facture.
  </Accordion>

  <Accordion title="token (création)">
    Identifiant de transaction retourné par LigdiCash à la création d'une facture. Sert à appeler l'endpoint `confirm` pour vérifier le statut. **Ce token est différent du token présent dans le callback** — ne pas les confondre.

    Voir [Tokens et identifiants](/concepts/tokens-et-identifiants).
  </Accordion>

  <Accordion title="token (callback)">
    Valeur du champ `token` reçue dans le payload callback. Elle est différente du token de création et ne doit pas être utilisée pour identifier la transaction. Utilisez toujours votre `transaction_id` stocké en base, ou re-vérifiez avec le token de création.

    Voir [Sécurisation du callback](/api-paiement/callback/securisation).
  </Accordion>

  <Accordion title="top_up_wallet">
    Paramètre de l'endpoint `/withdrawal/create`. Détermine si l'argent reste dans le wallet LigdiCash du client (`1`) ou est automatiquement viré vers son mobile money lié (`0`).

    Voir [Payout vers wallet LigdiCash](/api-paiement/payout/vers-wallet-ligdicash).
  </Accordion>

  <Accordion title="transaction_id">
    Identifiant de commande que **vous** générez côté marchand et que vous injectez dans `custom_data` à la création. C'est la méthode recommandée pour corréler une transaction LigdiCash avec votre système de commandes — fiable dans tous les flux, y compris en cas de retry callback.

    Voir [Le pattern transaction\_id](/concepts/transaction-id-pattern).
  </Accordion>
</AccordionGroup>

## U–Z

<AccordionGroup>
  <Accordion title="USSD">
    Protocole de messagerie courte utilisé par les opérateurs mobile money pour déclencher des actions depuis le téléphone (ex : `#144*82#` pour Orange Burkina). En mode payin sans redirection OTP-USSD, le client compose le code USSD sur son téléphone pour obtenir son OTP avant que vous ne soumettiez la transaction.
  </Accordion>

  <Accordion title="Wallet LigdiCash">
    Portefeuille électronique interne à LigdiCash, distinct des wallets des opérateurs mobile money. Le wallet LigdiCash peut recevoir des payouts via `/withdrawal/create` et est lié à un compte client LigdiCash.

    Voir [Payout vers wallet LigdiCash](/api-paiement/payout/vers-wallet-ligdicash).
  </Accordion>

  <Accordion title="wiki (champ)">
    Champ présent dans les réponses d'erreur de l'API LigdiCash. Contient une URL vers une page listant les sous-codes d'erreur spécifiques à l'endpoint appelé. À fetcher programmatiquement pour obtenir une description lisible de l'erreur.

    Voir [Le champ wiki](/erreurs/champ-wiki).
  </Accordion>

  <Accordion title="XOF (Franc CFA BCEAO)">
    Devise utilisée par LigdiCash pour les transactions en Afrique de l'Ouest (Burkina Faso, Mali, Niger, Bénin, Togo, Côte d'Ivoire, Sénégal, Guinée-Bissau). Le XOF n'a pas de décimales — les montants sont toujours des entiers.

    Voir [Devises et montants](/concepts/devises-montants).
  </Accordion>
</AccordionGroup>