Kenya

Send KES directly to Kenyan mobile money accounts. This guide walks you through the steps required to initiate and verify a transfer.

Prerequisites

Complete KYC and ensure your account is approved for transactions.
Whitelist your server IP addresses. See this guide for more information.
Enable Transfers via API. See this guide for more information.
Ensure you have sufficient funds in the KES wallet. For cross-currency transfers, the transfer amount is debited from the debit_currency wallet, while the transfer fee is debited from the KES wallet. See the supported currencies and transfer fees page for more information.

Payout Flow

Follow these steps to send money to a mobile money account in Kenya.

Collect the beneficiary details
Gather the beneficiary's name, mobile money network, and number.

See the table below for the required and optional parameters.

Parameter	Description	Format	Example	Isrequired
`account_bank`	The beneficiary's mobile money network. Supported values are `SAFARICOM`,`MPS`, `T-Kash`, `Airtel`.	String	"MPS"	Yes
`account_number`	The beneficiary's mobile money number.	String	"254724003076"	Yes
`beneficiary_name`	The beneficiary's full name.	String	"Saruni Sarun"	Yes
`amount`	The amount to send.	Integer	350	Yes
`currency`	The transfer currency. Must be `KES`.	String	"KES"	Yes
`debit_currency`	The wallet currency to debit for the transfer.	String	"XOF"	No
`narration`	A description for the transfer.	String	"Kenya Withdrawal"	No
`reference`	A unique reference to identify the transfer.	String	"Your-Unique-Reference"	No

Initiate the transfer
Send a POST request to the transfer endpoint with the beneficiary and transfer details.

curl --request POST \
  --url https://api.flutterwave.com/v3/transfers \
  --header 'Authorization: Bearer {{YOUR_SECRET_KEY}}' \
  --header 'Content-Type: application/json' \
  --data '{
        "amount": 1000,
        "account_bank": "MPS",
        "account_number": "254724003076",
        "currency": "KES",
        "beneficiary_name": "Saruni Saruni",
        "debit_currency": "XAF",
        "narration": "MoMo withdrawal",   
        "reference": "STkfKM_kk5dkdHY3_PMCKDU_1"
  }'

{
    "status": "success",
    "message": "Transfer Queued Successfully",
    "data": {
        "id": 2246430,
        "account_number": "254724003076",
        "bank_code": "MPS",
        "full_name": "Saruni Saruni",
        "created_at": "2026-10-14T14:40:15.000Z",
        "currency": "KES",
        "debit_currency": "XAF",
        "amount": 1000,
        "fee": 45,
        "status": "NEW",
        "reference": "STkfKM_kk5dkdHY3_PMCKDU_1",
        "meta": [
            {
                "MobileNumber": "254724003076"
            }
        ],
        "narration": "MoMo withdrawal",
        "complete_message": "",
        "requires_approval": 0,
        "is_approved": 1,
        "bank_name": "FA-BANK"
    }
}

Verify the transfer status
There are two ways to verify the transfer status:

Call the transfer status endpoint using the transfer ID (data.id) returned in the transfer response.

curl --request GET \
  --location 'https://api.flutterwave.com/v3/transfers/2246430' \
  --header 'Authorization: Bearer {{YOUR_SECRET_KEY}}'

{
    "status": "success",
    "message": "Transfer fetched",
    "data": {
        "id": 2246430,
        "account_number": "254724003076",
        "bank_code": "MPS",
        "full_name": "Saruni Saruni",
        "created_at": "2026-10-14T14:40:15.000Z",
        "currency": "KES",
        "debit_currency": "XAF",
        "amount": 1000,
        "fee": 45,
        "status": "SUCCESSFUL",
        "reference": "STkfKM_kk5dkdHY3_PMCKDU_1",
        "meta": [
            {
                "mobile_number": "254724003076"
            }
        ],
        "narration": "MoMo withdrawal",
        "approver": null,
        "complete_message": "Successful",
        "requires_approval": 0,
        "is_approved": 1,
        "bank_name": "FA-BANK"
    }
}

Listen for webhooks. Configure your webhook URL on the Flutterwave Dashboard to receive real-time transfer updates. See the webhooks guide for more information.

{
  "event": "transfer.completed",
  "event.type": "Transfer",
  "data": {
    "id": 2246430,
    "account_number": "254724003076",
    "bank_name": "FA-BANK",
    "bank_code": "MPS",
    "fullname": "Saruni Saruni",
    "created_at": "2026-10-14T14:40:15.000Z",
    "currency": "KES",
    "debit_currency": "XAF",
    "amount": 1000,
    "fee": 45,
    "status": "SUCCESSFUL",
    "reference": "STkfKM_kk5dkdHY3_PMCKDU_1",
    "meta": [
      {
        "MobileNumber": "254724003076"
      }
    ],
    "narration": "MoMo withdrawal",
    "approver": null,
    "complete_message": "Successful",
    "requires_approval": 0,
    "is_approved": 1
  }
}

Testing Transfers

Check the testing guide for mocking transfers in the test environment.