Skip to main content
Tanda works in Kenya, in Kenyan shillings. Send "currency": "KES" and, where asked, "country": "KE".

​
What’s supported

Checkout offers M-PESA, Airtel Money and bank transfer on one hosted page. Get checkout methods shows which are switched on for your account.

​
Phone numbers

Use the international format without the +: 254 followed by the nine-digit number.
Get phone number operator is the exception: it takes E.164 with the +, for example +254712345678.

​
Mobile money operator codes

For KES collections, momoOperatorId is optional: Tanda works out the network from the phone number. Pass it if you already know the network. For payouts, always send code. Get mobile money providers returns the live list for your account.

​
Payout destinations

​
Bank codes

Bank payouts need the bank’s code from Get banks:
Codes can change, so fetch the list and cache it for a day rather than hard-coding values.

​
Amounts

Amounts are in shillings, not cents: 1500 means KES 1,500. Mobile money amounts must be whole shillings. Limits depend on the method and your account; contact support if you need yours raised.