Initiate Transfer

This page shows you how to initiate a transfer

MPesa Transfer

For Mpesa transfers always pass the account_bank value as MPS, the account_number value is the recipients Mpesa number, it should always come with the prefix 254

Sample Mpesa Callback

JSON

{
  "event.type": "Transfer",
  "transfer": {
    "id": 3455,
    "account_number": "25472509382427",
    "bank_code": "MPS",
    "fullname": "FA",
    "date_created": "2018-10-03T14:20:25.000Z",
    "currency": "KES",
    "debit_currency": null,
    "amount": 49.99,
    "fee": 250,
    "status": "SUCCESSFUL",
    "reference": "rave-transfer-15028609",
    "meta": null,
    "narration": "Rave Mpesa transfer",
    "approver": null,
    "complete_message": "Approved Or Completed Successfully",
    "requires_approval": 0,
    "is_approved": 1,
    "bank_name": "FA-BANK"
  }
}

📘

Testing Mpesa Successfully

To run a successful Mpesa disbursement test you would need to be on the live environment.

Your Mpesa wallet balance also needs to be funded, see how to fund your wallet balance here.

Ghana Mobile Money Transfers

When performing a Ghana mobile money transfer, you would need to pass the account_bank value as any of these options MTN, TIGO, VODAFONE, AIRTEL.

The account_number value is the recipients mobile money number, it should always come with the prefix 233

Sample MoMo Callback

JSON

{
  "event.type": "Transfer",
  "transfer": {
    "id": 3455,
    "account_number": "233509382427",
    "bank_code": "MTN",
    "fullname": "Kwame Abe",
    "date_created": "2018-10-03T14:20:25.000Z",
    "currency": "GHS",
    "debit_currency": null,
    "amount": 49.99,
    "fee": 250,
    "status": "SUCCESSFUL",
    "reference": "rave-transfer-15028609",
    "meta": null,
    "narration": "Rave Mpesa transfer",
    "approver": null,
    "complete_message": "Approved Or Completed Successfully",
    "requires_approval": 0,
    "is_approved": 1,
    "bank_name": "FA-BANK"
  }
}

Ugandan Mobile Money

When completing a Ugandan mobile money transfer, always pass the account_bank value as MPS.

The account_number value is the recipient's mobile money number, it should always come with the prefix 256.

South African Bank Transfer

Here are some things to note when making South African bank transfers:

• The meta-object is required in the API request payload.

• Address and either MobileNumber or EmailAddress is required for the transaction to be successful.

• Other fields with the meta like FirstName and LastName are optional.