Bank Transfer - Other African Countries

Send money directly to bank accounts in other African countries we currently support

POST {{BASE_URL}}/partner/payout/initiate_transfer/

Parameter	Type	Description	Required
payout_step	string	Some payouts might involve multiple steps but this is a single step, you can set the default value as direct	true
receiver_currency	string	The currency of the person you're sending the money to	true
receiver_amount	string	The amount you're sending to the person. Kindly make use of the conversion endpoint to get this value if the receiver will be taking another currency apart from the sender's currency	true
transfer_method	string	The mode of transfer, and the value will be bank	true
transfer_receiver_type	string	Type of account you're sending the money to. It could either be personal or company	true
receiver_account_num	string	Account number of the receiver	true
receiver_country_code	string	ISO 3166-1 alpha-2 code	true
receiver_account_name	string	The account name of the receiver.	true
receiver_sort_code	string	The bank sort code. This can be fetched using the List Banks endpoint	true
sender_amount	string	The amount you are sending to the second body	true
sender_currency	string	The currency you prefer to send money from	true
transfer_ext_ref	string	Your preferred unique reference	false
transfer_note	string	Any additional note	false

HEADERS

{
     'Authorization': 'Bearer xhscIjHgpm2ZiPjzKos4ivl4GhyZp5',
      'Content-Type': 'application/json',
      'moni-signature': 'wed332eeddrdbdbdbdbvdvdvdvvsbsvsd'
 }

REQUEST

{
  "payout_step":"direct",
  "receiver_currency":"KES",
  "receiver_amount":"1000",
  "transfer_method":"bank",
  "transfer_receiver_type":"personal",
  "receiver_account_num":"0142428721",
  "receiver_country_code":"KE",
  "receiver_sort_code":"0003",
  "receiver_account_name":"Joseph Donga",
  "sender_amount":"1000",
  "sender_currency":"KES",
  "transfer_note":"chocolate bars"
}

RESPONSE

CREATED - 201

  {
        "transfer_ext_ref": "payout-test-01",
        "message": "Payout in progress",
        "payout_ref": "WMPRM_5gkk6rtpgw",
        "status": true,
        "status_code": 201
 }

BAD REQUEST - 400

   {
        "message": "Unable to process the external transfer at this moment. Kindly try again later.",
        "status": false,
        "status_code": 400
    }