Amounts And Currency

Kyshi accepts currency codes using ISO-style uppercase values.

Common public collection and payout currencies in the backend include:

NGN, KES, ZAR, GHS, XOF, USD

Amount Format

Send API request amounts as numbers in major currency units.

CurrencyExample FieldMeaning
NGN"amount": 10001000 NGN
USD"amount": 25.525.50 USD where decimals are accepted by the flow
XOF"amount": 10001000 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.

ValueMeaning
localThe amount is already in the customer's local payment currency.
settlementThe 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:

FieldValues
feeBearerMERCHANT, CUSTOMER
taxChargeableINCLUSIVE, 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.