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

# LigdiCash skill for AI agents

> Install the LigdiCash skill so Claude Code knows the API out of the box — endpoints, security patterns, and documented pitfalls.

The LigdiCash skill encodes every API convention into Claude Code: endpoints, data formats, the `transaction_id` pattern, callback handling, and known pitfalls. Once installed, Claude Code activates it automatically as soon as you mention LigdiCash in your prompts.

## Skill contents

| File                              | Contents                                                                                 |
| --------------------------------- | ---------------------------------------------------------------------------------------- |
| `SKILL.md`                        | Entry point — authentication, hosted payin, direct payin, payout, callback, status codes |
| `references/api-reference.md`     | Full reference of every endpoint with real request and response examples                 |
| `references/payin-no-redirect.md` | Details of the four OTP validation modes by operator                                     |
| `references/security-patterns.md` | Callback re-verification pattern, deduplication, full lifecycle                          |

## Installation

<Steps>
  <Step title="Get the skill">
    Install with the `skills` CLI (recommended) or browse the source on GitHub:

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

      <Card title="View on GitHub" icon="github" color="#e11d48" href="https://github.com/ligdicash/skills">
        Browse the source, report a bug, or contribute
      </Card>
    </CardGroup>
  </Step>

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

    Claude Code picks up the skill automatically at startup.
  </Step>

  <Step title="Confirm it loaded">
    In Claude Code, type:

    ```
    Which LigdiCash skill have you loaded?
    ```

    Claude Code should list the `ligdicash-integration` skill and describe its contents.
  </Step>
</Steps>

## Using the skill

Once installed, use direct prompts — the skill provides the context automatically.

<AccordionGroup>
  <Accordion title="Hosted payin">
    ```
    Implement a LigdiCash hosted payin in [language].
    Variable amount, include transaction_id in custom_data.
    Open the URL in a new tab. Handle errors.
    ```
  </Accordion>

  <Accordion title="Secure callback handler">
    ```
    Write a LigdiCash callback handler in [language/framework].
    Re-verify via confirm, deduplicate by token, extract
    transaction_id from custom_data.
    ```
  </Accordion>

  <Accordion title="Payout to mobile money">
    ```
    Implement a direct LigdiCash payout to mobile money in [language].
    Include transaction_id in custom_data. Log the wiki URL on error.
    ```
  </Accordion>

  <Accordion title="Direct payin (USSD OTP)">
    ```
    Implement a LigdiCash direct payin in USSD OTP mode, in [language].
    Empty external_id, transaction_id in custom_data, confirmation via callback.
    ```
  </Accordion>
</AccordionGroup>

## Cursor and Windsurf

The skill is built for Claude Code. For Cursor and Windsurf, the `references/` files work as session context:

* **Cursor** — drag `api-reference.md` and `security-patterns.md` into the chat
* **Windsurf** — add them via **Add Context** in Cascade

See the [Claude Code](/en/ai-tools/claude-code), [Cursor](/en/ai-tools/cursor), and [Windsurf](/en/ai-tools/windsurf) pages for the rule files specific to each editor.