Skip to main content

Payouts to Korea

Payout parameters​

NameTypeMandatoryDescription
payment_methodPaymentMethod+Payout data
 typestring+Value: bank_account
 bank_accountBankAccount+Bank account
  system_typestring+Value: global
  globalBankAccountGlobal+Bank account details
   descriptionstring+Purpose of remittance for the payout. This description should match the classification given in How to specify the remittance purpose
   bank_account_numberstring+Bank account number for the payout
participant_detailsParticipantDetails+Information on the payout participants
 recipientParticipant+Recipient details
  bank_namestring+Important: the bank name must be chosen from the List of supported banks, otherwise the payout will fail
  currencystring+Recipient's currency in ISO 4217 format. Case insensitive.
  country_iso3string+Recipient's country code (ISO-3166-1 alpha-3)
  first_namestring+Recipient's first name. Important: if the name is passed incorrectly, the recipient bank may not accept the payout
  last_namestring+Recipient's last name. Important: if the name is passed incorrectly, the recipient bank may not accept the payout
 senderParticipant+Sender details
  company_namestring+Sender company name. Limited to 100 characters, cannot contain digits only
  registration_numberstring+Sender company registration number
  country_iso3string+Sender’s country code (ISO-3166-1 alpha-3)
  codestring+Sender company registration number
amount_detailsAmountDetails+Payout amount details
 amountint+Payout amount in decimal format. The value must be greater than zero. If you are sending 100 USD, write 10000
 currencystring+ISO 4217 currency code. Case insensitive

Example​

curl -X POST \
  https://demo.smart-glocal.com/api/v1/session/start/payout \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-PROJECT: your_project_name' \
  -H 'X-PARTNER-SIGN: signature' \
  -d'{
    "session_id": "ps_1053680",
    "payment_method": {
        "type": "bank_account",
        "bank_account": {
            "system_type": "global",
            "global": {
                "bank_account_number": "NUMBER_VALUE",
                "description": "purpose of remittance"
            }
        }
    },
    "participant_details": {
        "recipient": {
           "bank_name": "Bank name from the list below",
           "currency": "krw",
            "country_iso3": "KOR",
            "first_name": "John",
            "last_name": "Johnson"
        },
        "sender": {
            "company_name": "Company name",
            "registration_number": "1234567890",
            "country_iso3": "USA",
            "code": "1234567890"
        }
    },
    "amount_details": {
        "amount": 1000,
        "currency": "usd"
    }
}'

List of supported banks​

CountryCurrencyBank
Republic of KoreaKRWKakao Bank
Republic of KoreaKRWShinhan Investment
Republic of KoreaKRWKorea federation of Community Credit cooperative
Republic of KoreaKRWNational Credit Union Federation of Korea
Republic of KoreaKRWEUGENE Investment & Securities
Republic of KoreaKRWMeritz Securities
Republic of KoreaKRWSaving Bank
Republic of KoreaKRWKorea Post Office
Republic of KoreaKRWNational Forestry Cooperative Federation
Republic of KoreaKRWKB Securities
Republic of KoreaKRWMirae Asset Securities
Republic of KoreaKRWHana Bank
Republic of KoreaKRWDaegu Bank
Republic of KoreaKRWKorea Development Bank
Republic of KoreaKRWBusan Bank
Republic of KoreaKRWIndustrial Bank of Korea
Republic of KoreaKRWKookmin Bank
Republic of KoreaKRWJeju Bank
Republic of KoreaKRWSuhyup Bank
Republic of KoreaKRWKyongnam Bank
Republic of KoreaKRWNational Agricultural Cooperative Federation (NH Bank)
Republic of KoreaKRWWoori Bank
Republic of KoreaKRWStandard Chartered First Bank Korea
Republic of KoreaKRWKwangJu Bank
Republic of KoreaKRWHanwha Investment & Securities
Republic of KoreaKRWSamsung Securities
Republic of KoreaKRWKorea Investment & Securities
Republic of KoreaKRWCiti Bank
Republic of KoreaKRWK Bank
Republic of KoreaKRWShinhan Bank
Republic of KoreaKRWNH Investment & Securities
Republic of KoreaKRWJeonBuk Bank
Republic of KoreaKRWDaishin Securities
Republic of KoreaKRWSK Securities
Republic of KoreaKRWeBEST Investment & Securities
Republic of KoreaKRWKIWOOM Securities
Republic of KoreaKRWHyundai Motor Securities
Republic of KoreaKRWHI Investment & Securities
Republic of KoreaKRWKyobo Securities
Republic of KoreaKRWKEB Hana Bank