Skip to main content

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.

Windsurf and its Cascade assistant can generate LigdiCash integration code. By adding a rules file to your project, Cascade knows the API conventions from the start.

​
LigdiCash skill

LigdiCash skill — download and install

Download the ZIP or install via npx skills. The references/ files can be added via Add Context inside Cascade to enrich each session.

​
Requirements

  • Windsurf installed
  • Access to the project you want to integrate

​
Rules file to create

Create .windsurf/rules.md at the root of your project: 
# LigdiCash integration

## Context

LigdiCash is a mobile money payment aggregator in West Africa.
API base URL: https://app.ligdicash.com

## Mandatory headers on every request

```
Apikey: {API_KEY}
Authorization: Bearer {AUTH_TOKEN}
Accept: application/json
Content-Type: application/json
```

## Data format

- Phone numbers: E.164 format without `+` or spaces — e.g. `22670000000`
- Amounts: integers (CFA francs have no sub-unit) — e.g. `5000`
- Currency: `XOF` exclusively
- API keys in examples: always `{API_KEY}` and `{AUTH_TOKEN}`, never real values

## Golden rule — transaction identification

The `token` returned at creation is different from the `token` received in the callback.
Never use that token to identify a transaction.

Always pass a merchant identifier in `custom_data` at creation:
```json
"custom_data": { "transaction_id": "ORD-2025-00042" }
```

In the callback, `custom_data` comes back as an array of objects. LigdiCash adds its own fields (`hash`, `logfile`). Extract with:
```javascript
const entry = custom_data.find(e => e.keyof_customdata === "transaction_id");
const transactionId = entry?.valueof_customdata;
```

## Hosted payin — pitfalls

- `customer` must stay `""` — otherwise LigdiCash filters the visible operators
- Never open the payment URL in an `<iframe>` — use the same tab, a new tab, a popup, or a native WebView

## Callback

- LigdiCash sends two POSTs: one `application/x-www-form-urlencoded` + one `application/json`. Deduplicate.
- Re-verify each callback by calling the `confirm` endpoint with the token stored at creation. Never trust the received payload.

​
Ready-to-use prompts

Use these prompts in the Cascade chat (Cmd+L or Ctrl+L). 
Implement a LigdiCash hosted payin in [language].

- Endpoint: POST https://app.ligdicash.com/pay/v01/redirect/checkout-invoice/create
- Amount: variable (function parameter)
- customer must stay "" (empty)
- Pass transaction_id in custom_data (object): { "transaction_id": "..." }
- Open the returned URL in a new tab (no iframe)
- Handle HTTP errors and response_code != "00"

Return the payment URL or throw an exception.

Write a LigdiCash callback handler in [language/framework].

Required behavior:
1. Accept POST in application/json AND application/x-www-form-urlencoded
2. Deduplicate by token (idempotency)
3. Re-verify the status by calling the confirm endpoint with the token stored in the database
4. custom_data in the callback is an array of objects — extract via keyof_customdata === "transaction_id"
5. Update the order in the database only if the confirm status is "00"

Implement a direct LigdiCash payout to mobile money in [language].

- Endpoint: POST https://app.ligdicash.com/pay/v01/straight/payout
- Parameters: amount, phone number (22670XXXXXXX format), description
- Pass transaction_id in custom_data (object): { "transaction_id": "..." }
- Handle errors and log the wiki URL on failure
Cascade picks up the context of your open files. Open the file where you’re integrating LigdiCash before running a prompt — the response will be tailored to your existing code.