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

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

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

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

{
  "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"
}

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
    }

PreviousBank Transfer - Other African Countries NextMobile Money Transfer

Last updated 6 months ago