Skip to main content

Amounts are integers in cents

150000 is KES 1,500.00. Never send decimals or floats. M-Pesa and SasaPay move whole shillings only, so their amounts must be multiples of 100. Anything else returns 400 invalid_amount.

Fees

You can see the fee before any money moves:
GET /v1/merchants/{id}/fees lists every fee your business pays. These are the fee types: On a collection, fee_borne_by says who pays the fee:
  • merchant: the payer is charged amount and your till receives net.
  • payer: the payer is charged amount plus the fee.
On a payout from your Cloudpay balance, the amount and the fee are both held when you create it. Cloudpay keeps them if the rail confirms the payout and releases them if it fails.

Custody

Each payment shows where the money sits, in custody:

Final means final

Once the rail confirms a payout or settlement, it can’t be reversed through Cloudpay. Check the recipient before you send.