Bank Transfer - International

This endpoint can be used to make international transfers

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

COUNTRIES_N_CURRENCIES = {'Australia': 'AUD', 'Canada': 'CAD', 'Singapore': 'SGD', 'Switzerland': 'CHF', 'Japan': 'JPY', 'United States': 'USD', 'Austria': 'EUR', 'Belgium': 'EUR', 'Bulgaria': 'BGN', 'Croatia': 'HRK', 
'Republic of Cyprus': 'EUR', 'Czech Republic': 'CZK', 'Denmark': 'DKK', 
'Estonia': 'EUR', 'Finland': 'EUR', 'France': 'EUR', 'Germany': 'EUR', 'Greece': 'EUR', 'Hungary': 'HUF', 'Iceland': 'ISK', 'Ireland': 'EUR', 'Italy': 'EUR', 'Latvia': 'EUR', 'Liechtenstein': 'CHF', 'Lithuania': 'EUR', 'Luxembourg': 'EUR', 'Malta': 'EUR', 'Netherlands': 'EUR', 'Norway': 'NOK', 'Poland': 'PLN', 'Portugal': 'EUR', 'Romania': 'RON', 'Slovakia': 'EUR', 
'Slovenia': 'EUR', 'Spain': 'EUR', 'Sweden': 'SEK', 'United Kingdom': 'GBP','South Africa':'ZAR',
'Isreal':'ISL','Mexico':'MXN','New Zealand':'NZD','Qatar':'QAR','Saudi Arabia':'SAR','Hong Kong':'HKD',
'Thailand':'THB','Aland Islands':'EUR','American Samoa':'USD','Andorra':'EUR','Heard Island and McDonald Islands':'AUD','Bonaire, Saint Eustatius and Saba':'USD',
'British Virgin Islands':'USD','British Indian Ocean Territory':'USD','Cook Islands':'NZD','French Guiana':'EUR','French Southern Territories':'EUR','Jersey':'GBP','Kiribati':'AUD','Kosovo':'EUR','Nauru':'AUD','Norfolk Island':'AUD','Northern Mariana Islands':'USD', 'Pitcairn':'NZD','Saint Pierre and Miquelon':'EUR','Reunion':'EUR','Saint Barthelemy':'EUR','Saint Martin':'EUR','Saint Pierre and Miquelon':'EUR','San Marino':'EUR','Turks and Caicos Islands':'USD','Tuvalu':'AUD',
'United States Minor Outlying Islands':'USD','Vatican':'EUR'}

Parameter	Type	Description	Required
payout_step	string	Some payouts might involve multiple steps but since this is just a step we just 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 bank	true
transfer_receiver_type	string	Type of account you're sending the money to. It could either be personal or company	true
receiver_country_code	string	ISO 3166-1 alpha-2 code	true
receiver_account_num	string	This could be the bank account number, IBAN, CLABE	true
receiver_sort_code	string	This could be the routing number, bank bic, bank sort code,	true
receiver_account_name	string	This is required if the transfer_receiver_type is company	false
receiver_first_name	string	This is required if the transfer_receiver_type is personal	false
receiver_last_name	string	This is required if the transfer_receiver_type is personal	false
receiver_address	string	Address of the receiver	false
receiver_city	string	City of the receiver	false
receiver_state	string	State of the receiver	false
receiver_post_code	string	Postal Code of the receiver	false
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":"GBP",
  "receiver_amount":"10",
  "transfer_method":"bank",
  "transfer_receiver_type":"personal",
  "receiver_account_num":"34312300",
  "receiver_country_code":"GB",
  "receiver_sort_code":"299344",
  "receiver_first_name":"Santa",
  "receiver_last_name":"Dave",
  "sender_amount":"6800",
  "sender_currency":"NGN"
}

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
    }