South Korea

Domestic Payment (real-time)

Overview

AvailableYes
targetCurrencyKorean Won (KRW)
countryCodeKR
Earliest Beneficiary Creditreal-time
Cut-Off Time (UK Time)N/A
Decimal Places0
Minimum targetAmount1
Maximum targetAmount5000000

Submission data

API field nameRequired?Field lengthDescription
purposeOfPaymentNarrativeMax 35Description for purpose of payment.
bankDetails.beneficiaryAccountNumber11-16Account number of the beneficiary (bank).
bankDetails.swiftBic8 or 11The SWIFT BIC is the Bank Identification Code of the beneficiary bank.
bankDetails.bankNameMax 35Name of the beneficiary bank.
parties.personalDetails.partyTypeCode4Type of the party.
Must be:
  • PT03 (Beneficiary)
parties.personalDetails.typeCode4Entity description code for the party.
Available values:
  • PD01 (Company)
  • PD02 (Individual)
  • PD03 (Institution)
  • PD04 (Government)
  • PD99 (Other)
parties.personalDetails.titleCodeConditional4Title 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.firstNameConditionalMax 50Beneficiary first name. Full name should be provided (no initials).
Condition
Mandatory if parties.personalDetails.typeCode is:
  • PD02 (Individual)
parties.personalDetails.middleNameMax 50Beneficiary middle name.
parties.personalDetails.lastNameConditionalMax 50Beneficiary last name. Full name should be provided (no initials).
Condition
Mandatory if parties.personalDetails.typeCode is:
  • PD02 (Individual)
parties.personalDetails.companyNameConditionalMax 140Full 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.dateOfBirth10Beneficiary's date of birth in YYYY-MM-DD format.
parties.telephony.phoneNumber5-34Beneficiary's phone number.
parties.telephony.prefix1-3Beneficiary's phone number prefix.
parties.address.streetMax 35Beneficiary'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.additionalAddressLineMax 35Beneficiary's residential (if payee is an individual) or registered (if payee is a company) address e.g. apartment no., unit, studio.
parties.address.cityMax 35Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address.
parties.address.postcodeOrZipCodeMax 16Beneficiary's postal code or zip code of their residential (if payee is an individual) or registered (if payee is a company) address.
parties.address.countryCode2Beneficiary's country of their residential (if payee is an individual) or registered (if payee is a company) address.
Enter the 2 digit 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

AvailableYes
targetCurrencyAvailable WIRE currencies
countryCodeKR
Earliest Beneficiary CreditThe estimated delivery time will vary by country and currency.
Cut-Off Time (UK Time)Currency specific
Decimal Places0
Minimum targetAmount1
Maximum targetAmount9999999

Submission data

API field nameRequired?Field lengthDescription
bankDetails.beneficiaryAccountNumberMax 20Account number of the beneficiary.
bankDetails.bankCodeMax 35Bank code of the beneficiary (bank).
bankDetails.branchCodeMax 35Branch code of the beneficiary (bank).
bankDetails.swiftBic8 or 11The SWIFT BIC is the Bank Identification Code of the beneficiary bank.
bankDetails.bankNameMax 35Name of the beneficiary bank.
parties.personalDetails.partyTypeCode4Type of the party.
Must be:
  • PT03 (Beneficiary)
parties.personalDetails.typeCode4Entity description code for the party.
Available values:
  • PD01 (Company)
  • PD02 (Individual)
  • PD03 (Institution)
  • PD04 (Government)
  • PD99 (Other)
parties.personalDetails.titleCodeConditional4Title 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.firstNameConditionalMax 50Beneficiary first name. Full name should be provided (no initials).
Condition
Mandatory if parties.personalDetails.typeCode is:
  • PD02
parties.personalDetails.middleNameMax 50Beneficiary middle name.
parties.personalDetails.lastNameConditionalMax 50Beneficiary last name. Full name should be provided (no initials).
Condition
Mandatory if parties.personalDetails.typeCode is:
  • PD02 (Individual)
parties.personalDetails.companyNameConditionalMax 140Full 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.dateOfBirth10Beneficiary's date of birth in YYYY-MM-DD format.
parties.address.streetMax 35Beneficiary'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.additionalAddressLineMax 35Beneficiary's residential (if payee is an individual) or registered (if payee is a company) address e.g. apartment no., unit, studio.
parties.address.cityMax 35Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address.
parties.address.postcodeOrZipCodeMax 10Beneficiary's postal code or zip code of their residential (if payee is an individual) or registered (if payee is a company) address.
parties.address.countryCodeConditional2Beneficiary'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 digit 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).