Kyshi accepts currency codes using ISO-style uppercase values.
Common public collection and payout currencies in the backend include:
NGN, KES, ZAR, GHS, XOF, USDAmount Format
Send API request amounts as numbers in major currency units.
| Currency | Example Field | Meaning |
|---|---|---|
NGN | "amount": 1000 | 1000 NGN |
USD | "amount": 25.5 | 25.50 USD where decimals are accepted by the flow |
XOF | "amount": 1000 | 1000 XOF |
The backend stores and normalizes money internally. Integrators should send the request format shown in the API Reference and use returned values for reconciliation.
Local vs Settlement Amounts
Some payment and plan endpoints support amountCurrency.
| Value | Meaning |
|---|---|
local | The amount is already in the customer's local payment currency. |
settlement | The amount is in your settlement currency and Kyshi should calculate the local amount. |
For a straightforward local checkout, use:
{
"amount": 1000,
"localCurrency": "NGN",
"amountCurrency": "local"
}Fees And Tax Options
Where supported, fee and tax behavior uses these enums:
| Field | Values |
|---|---|
feeBearer | MERCHANT, CUSTOMER |
taxChargeable | INCLUSIVE, EXCLUSIVE |
Transfer Amounts
Transfers and VA transfers use major currency units. Your balance must cover the transfer amount and applicable fees before the backend initiates the payout.
