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

# Plugin WordPress / WooCommerce

> Installez et configurez le plugin LigdiCash pour accepter les paiements mobile money sur votre boutique WooCommerce, sans écrire de code.

Le plugin LigdiCash pour WooCommerce s'installe manuellement depuis un fichier ZIP. Une fois activé, il ajoute une passerelle de paiement dans votre interface WooCommerce — aucun code à écrire.

<a href="/downloads/plugin-wordpress.zip" download>**Télécharger le plugin (ZIP)**</a>

**Ce que fait le plugin :**

* Ajoute une méthode de paiement LigdiCash à la page de commande WooCommerce
* Redirige le client vers la page de paiement LigdiCash lors du passage en caisse
* Reçoit le callback de confirmation et met à jour automatiquement le statut de la commande
* Ajoute le support de la devise FCFA (XOF) dans WooCommerce

## Prérequis

* WordPress ≥ 4.x
* WooCommerce installé et activé
* Un projet API LigdiCash avec une `api_key` et un `auth_token` — voir [Créer un projet API](/concepts/projet-api)
* Devise de la boutique configurée sur **XOF** ou **FCFA**

***

## Installation

Le plugin s'installe en téléchargeant le dossier sous forme de fichier ZIP et en l'important dans WordPress.

<Steps>
  <Step title="Télécharger le plugin">
    Téléchargez le fichier ZIP via le lien en haut de cette page ou directement : [plugin-wordpress.zip](/downloads/plugin-wordpress.zip).
  </Step>

  <Step title="Importer dans WordPress">
    Dans votre tableau de bord WordPress, allez dans **Extensions → Ajouter une extension → Téléverser une extension**, sélectionnez le fichier `.zip`, puis cliquez sur **Installer maintenant**.
  </Step>

  <Step title="Activer le plugin">
    Une fois l'installation terminée, cliquez sur **Activer l'extension**.
  </Step>

  <Step title="Accéder aux paramètres">
    Allez dans **WooCommerce → Réglages → Paiements**, puis cliquez sur **LigdiCash** pour ouvrir la page de configuration.
  </Step>
</Steps>

***

## Configuration

Depuis **WooCommerce → Réglages → Paiements → LigdiCash** :

| Champ                  | Description                                                                      |
| ---------------------- | -------------------------------------------------------------------------------- |
| **Activer/Désactiver** | Cochez pour afficher LigdiCash comme méthode de paiement à la caisse             |
| **Titre**              | Texte affiché au client sur la page de commande (ex. : `Paiement mobile, VISA…`) |
| **Description**        | Description affichée sous le titre sur la page de commande                       |
| **Clé Principale**     | Votre `api_key` générée dans le dashboard LigdiCash                              |
| **Token**              | Votre `auth_token` généré dans le dashboard LigdiCash                            |

<Warning>
  Ne partagez jamais votre **Clé Principale** ni votre **Token** — ils donnent accès à votre compte marchand. Ne les commitez pas dans votre dépôt Git.
</Warning>

***

## Flux de paiement

Une fois le plugin configuré, voici ce qui se passe lors d'une commande :

<Steps>
  <Step title="Le client passe commande">
    Sur la page de commande WooCommerce, le client sélectionne **LigdiCash** comme mode de paiement et valide.
  </Step>

  <Step title="Redirection vers LigdiCash">
    Le plugin crée une facture via `POST /pay/v01/redirect/checkout-invoice/create` et redirige le client vers la page de paiement LigdiCash.
  </Step>

  <Step title="Paiement du client">
    Le client choisit son opérateur mobile money et effectue le paiement sur la page LigdiCash.
  </Step>

  <Step title="Retour sur la boutique">
    Après paiement, le client est redirigé vers la page de confirmation WooCommerce. Le plugin vérifie le statut via `GET /pay/v01/redirect/checkout-invoice/confirm/` et met à jour la commande.
  </Step>

  <Step title="Confirmation par callback">
    LigdiCash envoie également un callback POST à l'URL `{votre-site}/wc-api/wc_ligdicash/`. Le plugin traite ce callback et marque la commande comme **Terminée** si le statut est `completed`.
  </Step>
</Steps>

<Note>
  L'URL de callback est générée automatiquement par le plugin : `{votre-site}/wc-api/wc_ligdicash/`. Vous n'avez pas à la configurer manuellement — elle est enregistrée dans WooCommerce à l'activation du plugin.
</Note>

***

## Devise

Le plugin ajoute automatiquement la devise **FCFA (XOF)** dans WooCommerce. Configurez la devise de votre boutique sur **XOF** ou **FCFA** dans **WooCommerce → Réglages → Général**.

***

## Liens utiles

* [Créer un projet API](/concepts/projet-api)
* [Authentification — api\_key et auth\_token](/concepts/authentification)
* [Payin avec redirection — Introduction](/api-paiement/payin-redirect/introduction)
* [Callback — Introduction](/api-paiement/callback/introduction)