Payouts to Korea
Payout parameters
Name | Type | Mandatory | Description |
---|---|---|---|
payment_method | PaymentMethod | + | Payout data |
type | string | + | Value: bank_account |
bank_account | BankAccount | + | Bank account |
system_type | string | + | Value: global |
global | BankAccountGlobal | + | Bank account details |
description | string | + | Purpose of remittance for the payout. This description should match the classification given in How to specify the remittance purpose |
bank_account_number | string | + | Bank account number for the payout |
participant_details | ParticipantDetails | + | Information on the payout participants |
recipient | Participant | + | Recipient details |
bank_name | string | + | Important: the bank name must be chosen from the List of supported banks, otherwise the payout will fail |
currency | string | + | Recipient's currency in ISO 4217 format. Case insensitive. |
country_iso3 | string | + | Recipient's country code (ISO-3166-1 alpha-3) |
first_name | string | + | Recipient's first name. Important: if the name is passed incorrectly, the recipient bank may not accept the payout |
last_name | string | + | Recipient's last name. Important: if the name is passed incorrectly, the recipient bank may not accept the payout |
sender | Participant | + | Sender details |
company_name | string | + | Sender company name. Limited to 100 characters, cannot contain digits only |
registration_number | string | + | Sender company registration number |
country_iso3 | string | + | Sender’s country code (ISO-3166-1 alpha-3) |
code | string | + | Sender company registration number |
amount_details | AmountDetails | + | Payout amount details |
amount | int | + | Payout amount in decimal format. The value must be greater than zero. If you are sending 100 USD, write 10000 |
currency | string | + | 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
Country | Currency | Bank |
---|---|---|
Republic of Korea | KRW | Kakao Bank |
Republic of Korea | KRW | Shinhan Investment |
Republic of Korea | KRW | Korea federation of Community Credit cooperative |
Republic of Korea | KRW | National Credit Union Federation of Korea |
Republic of Korea | KRW | EUGENE Investment & Securities |
Republic of Korea | KRW | Meritz Securities |
Republic of Korea | KRW | Saving Bank |
Republic of Korea | KRW | Korea Post Office |
Republic of Korea | KRW | National Forestry Cooperative Federation |
Republic of Korea | KRW | KB Securities |
Republic of Korea | KRW | Mirae Asset Securities |
Republic of Korea | KRW | Hana Bank |
Republic of Korea | KRW | Daegu Bank |
Republic of Korea | KRW | Korea Development Bank |
Republic of Korea | KRW | Busan Bank |
Republic of Korea | KRW | Industrial Bank of Korea |
Republic of Korea | KRW | Kookmin Bank |
Republic of Korea | KRW | Jeju Bank |
Republic of Korea | KRW | Suhyup Bank |
Republic of Korea | KRW | Kyongnam Bank |
Republic of Korea | KRW | National Agricultural Cooperative Federation (NH Bank) |
Republic of Korea | KRW | Woori Bank |
Republic of Korea | KRW | Standard Chartered First Bank Korea |
Republic of Korea | KRW | KwangJu Bank |
Republic of Korea | KRW | Hanwha Investment & Securities |
Republic of Korea | KRW | Samsung Securities |
Republic of Korea | KRW | Korea Investment & Securities |
Republic of Korea | KRW | Citi Bank |
Republic of Korea | KRW | K Bank |
Republic of Korea | KRW | Shinhan Bank |
Republic of Korea | KRW | NH Investment & Securities |
Republic of Korea | KRW | JeonBuk Bank |
Republic of Korea | KRW | Daishin Securities |
Republic of Korea | KRW | SK Securities |
Republic of Korea | KRW | eBEST Investment & Securities |
Republic of Korea | KRW | KIWOOM Securities |
Republic of Korea | KRW | Hyundai Motor Securities |
Republic of Korea | KRW | HI Investment & Securities |
Republic of Korea | KRW | Kyobo Securities |
Republic of Korea | KRW | KEB Hana Bank |