Currencies and amounts

LigdiCash operates exclusively in CFA francs (XOF). All amounts sent to the API, regardless of the display currency in your interface, must be expressed in XOF.

Currency

The devise field in the body of all your requests must always be "XOF":

{
  "invoice": {
    "total_amount": 5000,
    "devise": "XOF",
    ...
  }
}

If your application handles several currencies internally, the conversion to XOF is your responsibility before calling the LigdiCash API. The API does not perform any conversion — it interprets the received amount as XOF.

Amount format

XOF has no decimals. All amounts are integers:

✅ Correct	❌ Incorrect
`5000`	`5000.00`
`100`	`100.5`
`25000`	`"25000"` (string)

Amounts must be passed as integers (type integer), never as strings or with decimals.

Limits per operator

Each operator enforces its own amount limits per transaction. These limits generally cover:

Minimum amount per transaction
Maximum amount per transaction
Daily cap (depending on the operator)

The exact limits are documented on each operator’s page. See the Operators section for the operator you are interested in.

If an amount exceeds the operator’s limit, the transaction will return an error. See Sub-codes per endpoint — notably Echec (Code02) on createInvoice — for details.

Response codes and statuses — interpreting API errors
Common errors — including out-of-range amount errors

Getting started

Core concepts

Payment API

Guides

Error handling

SDKs & Plugins

Other products

AI tools

Resources

Currencies and amounts

Currency

Amount format

Limits per operator

​Currency

​Amount format

​Limits per operator

​Related pages

Currency

Amount format

Limits per operator

Related pages