Mobile Money Transfer

Make mobile money transfer

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

Parameter	Type	Description	Required
payout_step	string	Some payouts might involve multiple steps but since this is just a step we use 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 mobile_money	true
transfer_receiver_type	string	Type of account you're sending the money to. The valid choice is personal	true
receiver_account_num	string	This should be the valid phone number of the receiver. This is where the money will be sent to.	true
receiver_country_code	string	ISO 3166-1 alpha-2 code. Use this endpoint to get the list of supported countries.	true
receiver_account_name	string	The name of the receiver.	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

HEADERS

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

REQUEST

{
  "payout_step":"direct",
  "receiver_currency":"ZMW",
  "receiver_amount":"10",
  "transfer_method":"mobile_money",
  "transfer_receiver_type":"personal",
  "receiver_account_num":"[phone]",
  "receiver_country_code":"ZM",
  "sender_currency":"ZMW",
  "sender_amount":"10"
}

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
    }

TEST DATA

Currency - ZMW
Country code -  ZM
networks - mtn, airtel
phone_number = [phone] [mtn] , [phone][airtel]