South Korea

Domestic Payment (real-time)

Overview

Available	Yes
`targetCurrency`	Korean Won (KRW)
`countryCode`	KR
Earliest Beneficiary Credit	real-time
Cut-Off Time (UK Time)	N/A
Decimal Places	0
Minimum `targetAmount`	1
Maximum `targetAmount`	5000000

Submission data

API field name	Required?	Field length	Description
`purposeOfPaymentNarrative`	✅	Max 35	Description for purpose of payment.
`bankDetails.beneficiaryAccountNumber`	✅	11-16	Account number of the beneficiary (bank).
`bankDetails.swiftBic`	✅	8 or 11	The SWIFT BIC is the Bank Identification Code of the beneficiary bank.
`bankDetails.bankName`	✅	Max 35	Name of the beneficiary bank.
`parties.personalDetails.partyTypeCode`	✅	4	Type of the party. Must be: `PT03 (Beneficiary)`
`parties.personalDetails.typeCode`	✅	4	Entity description code for the party. Available values: `PD01 (Company)` `PD02 (Individual)`
`parties.personalDetails.titleCode`	Conditional	4	Title code for the Individual. Available values: `TO01 (Ms)` `TO02 (Miss)` `TO03 (Mr)` `TO04 (Mrs)` `TO05 (Dr)` `TO06 (Mx)` `TO99 (Misc)` Condition Mandatory if `parties.personalDetails.typeCode` is: `PD02 (Individual)`
`parties.personalDetails.firstName`	Conditional	Max 50	Beneficiary first name. Full name should be provided (no initials). Condition Mandatory if `parties.personalDetails.typeCode` is: `PD02 (Individual)`
`parties.personalDetails.middleName`	❌	Max 50	Beneficiary middle name.
`parties.personalDetails.lastName`	Conditional	Max 50	Beneficiary last name. Full name should be provided (no initials). Condition Mandatory if `parties.personalDetails.typeCode` is: `PD02 (Individual)`
`parties.personalDetails.companyName`	Conditional	Max 140	Full name of the organization. Important Failure to provide the full name could result in delays and potential rejection of your payment. This must consist of 2 words, separated by a space. To whitelist any other naming format please contact your Relationship Manager Condition Mandatory if `parties.personalDetails.typeCode` is: `PD01 (Company)` `PD03 (Institution)` `PD04 (Government)` `PD99 (Other)`
`parties.personalDetails.dateOfBirth`	❌	10	Beneficiary's date of birth in YYYY-MM-DD format.
`parties.telephony.phoneNumber`	✅	5-34	Beneficiary's phone number.
`parties.telephony.prefix`	✅	1-3	Beneficiary's phone number prefix.
`parties.address.street`	✅	Max 35	Beneficiary's residential (if payee is an individual) or registered (if payee is a company) house number/name and street e.g. 1 Main Street.
`parties.address.additionalAddressLine`	❌	Max 35	Beneficiary's residential (if payee is an individual) or registered (if payee is a company) address e.g. apartment no., unit, studio.
`parties.address.city`	✅	Max 35	Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address.
`parties.address.postCodeOrZipCode`	✅	Max 16	Beneficiary's postal code or zip code of their residential (if payee is an individual) or registered (if payee is a company) address.
`parties.address.countryCode`	✅	2	Beneficiary's country of their residential (if payee is an individual) or registered (if payee is a company) address. Enter the 2 character ISO 3166-1 standard country code in your API request.

Important

Additional data is required if the requestor of the payout is a Payment Service Provider (PSP) or Money Service Business (MSB).

Important

If the amount is between USD 5,000 and USD 50,000 then the beneficiary will be contacted by the partner bank branch in South Korea to provide his/her national ID (for first payment).

Important

For payments above USD 50,000, the partner bank branch in South Korea will directly contact the beneficiary to obtain required documentation to evidence the purpose of payments and the payment will be processed only after receipt of this documentation.

Important

KRW payment instructions to a beneficiary account with Kakao Bank (beneficiary bank) will be returned and will not be processed.

International WIRE

Overview

Available	Yes
`targetCurrency`	Available WIRE currencies
`countryCode`	KR
Earliest Beneficiary Credit	The estimated delivery time will vary by country and currency.
Cut-Off Time (UK Time)	Currency specific
Decimal Places	0
Minimum `targetAmount`	1
Maximum `targetAmount`	9999999

Submission data

API field name	Required?	Field length	Description
`bankDetails.beneficiaryAccountNumber`	✅	Max 20	Account number of the beneficiary.
`bankDetails.bankCode`	❌	Max 35	Bank code of the beneficiary (bank).
`bankDetails.branchCode`	❌	Max 35	Branch code of the beneficiary (bank).
`bankDetails.swiftBic`	✅	8 or 11	The SWIFT BIC is the Bank Identification Code of the beneficiary bank.
`bankDetails.bankName`	✅	Max 35	Name of the beneficiary bank.
`parties.personalDetails.partyTypeCode`	✅	4	Type of the party. Must be: `PT03 (Beneficiary)`
`parties.personalDetails.typeCode`	✅	4	Entity description code for the party. Available values: `PD01 (Company)` `PD02 (Individual)`
`parties.personalDetails.titleCode`	Conditional	4	Title code for the Individual. Available values: `TO01 (Ms)` `TO02 (Miss)` `TO03 (Mr)` `TO04 (Mrs)` `TO05 (Dr)` `TO06 (Mx)` `TO99 (Misc)` Condition Mandatory if `parties.personalDetails.typeCode` is: `PD02 (Individual)`
`parties.personalDetails.firstName`	Conditional	Max 50	Beneficiary first name. Full name should be provided (no initials). Condition Mandatory if `parties.personalDetails.typeCode` is: `PD02`
`parties.personalDetails.middleName`	❌	Max 50	Beneficiary middle name.
`parties.personalDetails.lastName`	Conditional	Max 50	Beneficiary last name. Full name should be provided (no initials). Condition Mandatory if `parties.personalDetails.typeCode` is: `PD02 (Individual)`
`parties.personalDetails.companyName`	Conditional	Max 140	Full name of the organization. Important Failure to provide the full name could result in delays and potential rejection of your payment. This must consist of 2 words, separated by a space. To whitelist any other naming format please contact your Relationship Manager Condition Mandatory if `parties.personalDetails.typeCode` is: `PD01 (Company)` `PD03 (Institution)` `PD04 (Government)` `PD99 (Other)`
`parties.personalDetails.dateOfBirth`	❌	10	Beneficiary's date of birth in YYYY-MM-DD format.
`parties.address.street`	❌	Max 35	Beneficiary's residential (if payee is an individual) or registered (if payee is a company) house number/name and street e.g. 1 Main Street.
`parties.address.additionalAddressLine`	❌	Max 35	Beneficiary's residential (if payee is an individual) or registered (if payee is a company) address e.g. apartment no., unit, studio.
`parties.address.city`	❌	Max 35	Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address.
`parties.address.postCodeOrZipCode`	❌	Max 10	Beneficiary's postal code or zip code of their residential (if payee is an individual) or registered (if payee is a company) address.
`parties.address.countryCode`	Conditional	2	Beneficiary's country of their residential (if payee is an individual) or registered (if payee is a company) address. Condition Mandatory if any of the optional Beneficiary address details are provided. Enter the 2 character ISO 3166-1 standard country code in your API request.

Important

Additional data is required if the requestor of the payout is a Payment Service Provider (PSP) or Money Service Business (MSB).

South Korea

Domestic Payment (real-time)

Overview

Submission data

International WIRE

Overview

Submission data

Do you like our page?