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

# Skill LigdiCash pour agent IA

> Installez le skill LigdiCash pour que Claude Code connaisse l'API dès le départ — endpoints, patterns de sécurité et pièges documentés.

Le skill LigdiCash encode toutes les conventions de l'API dans Claude Code : endpoints, format des données, pattern `transaction_id`, gestion du callback et pièges connus. Une fois installé, Claude Code l'active automatiquement dès que vous mentionnez LigdiCash dans vos prompts.

## Contenu du skill

| Fichier                           | Contenu                                                                                                   |
| --------------------------------- | --------------------------------------------------------------------------------------------------------- |
| `SKILL.md`                        | Point d'entrée — authentification, payin redirect, payin sans redirect, payout, callback, codes de statut |
| `references/api-reference.md`     | Référence complète de tous les endpoints avec exemples de requête et de réponse réels                     |
| `references/payin-no-redirect.md` | Détail des quatre modes de validation OTP par opérateur                                                   |
| `references/security-patterns.md` | Pattern de re-vérification du callback, déduplication, cycle de vie complet                               |

## Installation

<Steps>
  <Step title="Récupérer le skill">
    Installez avec le CLI `skills` (recommandé) ou consultez les sources sur GitHub :

    <CardGroup cols={1}>
      <Card title="Installer via npx" icon="terminal" color="#e11d48">
        ```bash theme={null}
        npx skills add ligdicash/skills --skill ligdicash-integration
        ```
      </Card>

      <Card title="Voir sur GitHub" icon="github" color="#e11d48" href="https://github.com/ligdicash/skills">
        Parcourir le code source, signaler un bug ou contribuer
      </Card>
    </CardGroup>
  </Step>

  <Step title="Lancer Claude Code">
    ```bash theme={null}
    claude
    ```

    Claude Code détecte automatiquement le skill au démarrage.
  </Step>

  <Step title="Vérifier l'activation">
    Tapez dans Claude Code :

    ```
    Quel skill LigdiCash as-tu chargé ?
    ```

    Claude Code doit lister le skill `ligdicash-integration` et décrire son contenu.
  </Step>
</Steps>

## Utiliser le skill

Une fois installé, utilisez des prompts directs — le skill fournit le contexte automatiquement.

<AccordionGroup>
  <Accordion title="Payin avec redirection">
    ```
    Implémente un payin LigdiCash avec redirection en [langage].
    Montant variable, inclure transaction_id dans custom_data.
    Ouvrir l'URL dans un nouvel onglet. Gérer les erreurs.
    ```
  </Accordion>

  <Accordion title="Handler de callback sécurisé">
    ```
    Écris un handler de callback LigdiCash en [langage/framework].
    Re-vérifier via confirm, dédupliquer par token, extraire
    transaction_id depuis custom_data.
    ```
  </Accordion>

  <Accordion title="Payout vers mobile money">
    ```
    Implémente un payout LigdiCash direct vers mobile money en [langage].
    Inclure transaction_id dans custom_data. Logger la wiki URL en cas d'erreur.
    ```
  </Accordion>

  <Accordion title="Payin sans redirection (OTP USSD)">
    ```
    Implémente un payin LigdiCash sans redirection, mode OTP USSD, en [langage].
    external_id vide, transaction_id dans custom_data, confirmation par callback.
    ```
  </Accordion>
</AccordionGroup>

## Cursor et Windsurf

Le skill est conçu pour Claude Code. Pour Cursor et Windsurf, les fichiers `references/` servent de contexte de session :

* **Cursor** — glissez `api-reference.md` et `security-patterns.md` dans le chat
* **Windsurf** — ajoutez-les via **Add Context** dans Cascade

Consultez les pages [Claude Code](/ai-tools/claude-code), [Cursor](/ai-tools/cursor) et [Windsurf](/ai-tools/windsurf) pour les fichiers de règles spécifiques à chaque éditeur.