curl --request POST \
--url https://api.tandapay.io/api/b2b/fiat/deposit/momo \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"amount": 1500,
"currency": "KES",
"phoneNumber": "254712345678",
"externalReference": "order_10045"
}
'{
"success": true,
"message": "Initiated request.",
"transactionId": "aB3dE5fG7hJ9kL1mN2pQ"
}{
"success": false,
"message": "Unauthorized"
}{
"success": false,
"message": "Method not enabled for this currency",
"errorCode": "METHOD_NOT_ENABLED"
}{
"success": false,
"message": "Duplicate external reference",
"errorCode": "DUPLICATE_EXTERNAL_REFERENCE"
}Collections
Mobile money charge
Send an M-PESA or Airtel Money payment prompt to a customer’s phone.
POST
/
api
/
b2b
/
fiat
/
deposit
/
momo
curl --request POST \
--url https://api.tandapay.io/api/b2b/fiat/deposit/momo \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"amount": 1500,
"currency": "KES",
"phoneNumber": "254712345678",
"externalReference": "order_10045"
}
'{
"success": true,
"message": "Initiated request.",
"transactionId": "aB3dE5fG7hJ9kL1mN2pQ"
}{
"success": false,
"message": "Unauthorized"
}{
"success": false,
"message": "Method not enabled for this currency",
"errorCode": "METHOD_NOT_ENABLED"
}{
"success": false,
"message": "Duplicate external reference",
"errorCode": "DUPLICATE_EXTERNAL_REFERENCE"
}Walkthrough: M-PESA and Airtel Money guide.
Authorizations
Token from Generate bearer token.
Body
application/json
Amount in KES.
Example:
1500
ISO 4217 currency code. Tanda supports KES.
Available options:
KES Example:
"KES"
Kenyan mobile number in international format without the +, e.g. 254712345678.
Example:
"254712345678"
Your unique ID for this transaction. Must be unique per attempt; reuse returns 409 DUPLICATE_EXTERNAL_REFERENCE.
Example:
"order_10045"
Network to charge. Optional for KES: if omitted, it's resolved from the phone number.
Available options:
mpesa, airtel ID of a saved deposit beneficiary (see Beneficiaries).