API Explorer
Send Money
Mobile Wallets

To Mobile Wallets

Test URL

POSThttps://uat.finserve.africa/v3-apis/transaction-api/v3.0/remittance/sendmobile

Live URL

POSThttps://api.finserve.africa/v3-apis/transaction-api/v3.0/remittance/sendmobile

This enables your application to send money to telco :iphone: wallets across Kenya, Uganda, Tanzania & Rwanda. Kindly note in order to get a response you will need to test this in production.

200 Success Response Schema

Field NameField TypeField Description
transactionIdstringunique transaction id
statusstringtransaction status

Example Request

⚠️

In the example below, please remember to replace the variables enclosed within curly brackets {{ }} with the actual values.

Signature Formula
transfer.amount+transfer.currencyCode+transfer.reference+source.accountNumber
Example Request
curl -X POST \
	-d '{
            "source": {
                "countryCode": "KE",
                "name": "Security Test",
                "accountNumber": "1450160649886"
            },
            "destination": {
                "type": "mobile",
                "countryCode": "KE",
                "name": "John Doe",
                "mobileNumber": "254722000000",
                "walletName": "Mpesa"
            },
            "transfer": {
                "type": "MobileWallet",
                "amount": "200",
                "currencyCode": "KES",
                "reference": "S001946981113",
                "date": "2019-05-01",
                "description": "Some remarks here",
                "callbackUrl": "https://webhook.site/46fdc0c2-98fa-4ac5-a7ca-91b7fcabbac7"
            }
        }'  \
	-H 'Authorization: Bearer {{access_token}}'  \
	-H 'Content-Type: application/json'  \
	-H 'signature: {{signature}}'  \
	-L 'https://uat.finserve.africa/v3-apis/transaction-api/v3.0/remittance/sendmobile'

Example Response

Example Response
{
    "status": true,
    "code": -1,
    "message": "Transaction has been successfully acknowledged, await final transaction status on callback",
    "reference": "S001946909393",
    "transactionId": "S001946909393"
}

On completion of the transaction, you will receive a callback on the callbackUrl provided in the request. The callback will have the following payload:

Callback Payload
{
    "status": true,
    "code": "0",
    "message": "success",
    "transactionReference": "S001946909393",
    "data": {
    "ResponseCode": "0",
    "ReceiverMsisdn": "254708028398",
    "Reference": "S001946909393",
    "ResponseDescription": "254708028398 Jonh Wick",
    "ThirdPartyTranID": "S001946909393",
    "ReceiverName": "Jonh Wick"
}
Within Equity BankRTGS