South Korea Beneficiary

Before making a payment to a South Korean bank account, you must add the account as a beneficiary. Note that payments to South Korean beneficiaries are via bank transfer.

Below is a sample request for creating a South Korean beneficiary:

cURL

curl --location '{{sandboxURL}}/beneficiaries' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{APIKEY}}' \
--data '{
    "reference": "<samplereference>",
"country": "KR",
    "currency": "KRW",
    "destination": {
        "type": "BANK",
        "accountName": "Kim Min Su",
        "accountNumber": "110-123-456789",
        "bankCode": 1457,
        "remittancePurpose": "FAMILY_SUPPORT",
        "beneficiary": {
            "type": "INDIVIDUAL",
            "phoneNumber": "82-10-1234-5678"
        },
        "sender": {
            "type": "INDIVIDUAL",
            "accountName": "John Smith",
            "postCode": "12345",
            "dateOfBirth": "1985-03-15",
            "country": "US",
            "phoneNumber": "1-555-123-4567"
        }
    }
}'

The parameters for adding South Korean bank account beneficiaries are:

Parameter	Description	Required
type	The type of destination. Must be "BANK".	✅
accountName	Name of the beneficiary's account. `A space separated first and last name must be provided for individual beneficiaries e.g Marie Dubois`	✅
accountNumber	The beneficiary's Account number.	✅
remittancePurpose	Purpose of the remittance. `See accepted remittance purposes` `here` (opens in a new tab)	✅
bankCode	Code of the receiving bank `See accepted bankCodes` `here` (opens in a new tab)	✅
sender	Sender information varies depending on type. Sender type can either be `BUSINESS` or `INDIVIDUAL`.	✅
beneficiary	Beneficiary information.	✅

Sender Parameters (Business)

Parameter	Description	Required
sender[type]	Type of sender. Must be "BUSINESS".	✅
sender[accountName]	Sender's accountName	✅
sender[country]	Sender's country	✅
sender[postCode]	Sender's address post code	✅
sender[businessRegistrationNumber]	Sender's business registration number	✅

Sender Parameters (Individual)

Parameter	Description	Required
sender[type]	Type of sender. Must be "INDIVIDUAL"	✅
sender[phoneNumber]	Sender's phoneNumber address	✅
sender[accountName]	Sender's accountName	✅
sender[postCode]	Sender's address post code	✅
sender[dateOfBirth]	Sender's date of birth	✅
sender[country]	Sender's country	✅

Beneficiary Parameters

Parameter	Description	Required
beneficiary[type]	Type of beneficiary, either "BUSINESS" or "INDIVIDUAL"	✅
beneficiary[phoneNumber]	Beneficiary's phoneNumber	✅

South Africa Beneficiary Tanzania Beneficiary