Payouts to Korea

Payout parameters

Name	Mandatory	Type	Description
payment_method/payout_details	+	object	Payout data
type	+	string	Value: bank_account
bank_account	+	object	Bank account
system_type	+	string	Value: global
global	+	object	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	+	object	Information on the payout participants
recipient	+	object	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	+	object	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	+	object	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	Busan Bank
Republic of Korea	KRW	Citi Bank
Republic of Korea	KRW	Daegu Bank
Republic of Korea	KRW	Daishin Securities
Republic of Korea	KRW	eBEST Investment & Securities
Republic of Korea	KRW	EUGENE Investment & Securities
Republic of Korea	KRW	Hanwha Investment & Securities
Republic of Korea	KRW	HI Investment & Securities
Republic of Korea	KRW	Hyundai Motor Securities
Republic of Korea	KRW	Industrial Bank of Korea
Republic of Korea	KRW	Jeju Bank
Republic of Korea	KRW	JeonBuk Bank
Republic of Korea	KRW	K Bank
Republic of Korea	KRW	Kakao Bank
Republic of Korea	KRW	KB Securities
Republic of Korea	KRW	KEB Hana Bank
Republic of Korea	KRW	KIWOOM Securities
Republic of Korea	KRW	Kookmin Bank
Republic of Korea	KRW	Korea Development Bank
Republic of Korea	KRW	Korea federation of Community Credit cooperative
Republic of Korea	KRW	Korea Investment & Securities
Republic of Korea	KRW	Korea Post Office
Republic of Korea	KRW	Kwangju Bank
Republic of Korea	KRW	Kyobo Securities
Republic of Korea	KRW	Kyongnam Bank
Republic of Korea	KRW	Meritz Securities
Republic of Korea	KRW	Mirae Asset Securities
Republic of Korea	KRW	National Credit Union Federation of Korea
Republic of Korea	KRW	National Forestry Cooperative Federation
Republic of Korea	KRW	NH Bank - Nonghyup Bank
Republic of Korea	KRW	NH Investment & Securities
Republic of Korea	KRW	Samsung Securities
Republic of Korea	KRW	Saving Bank
Republic of Korea	KRW	Shinhan Bank
Republic of Korea	KRW	Shinhan Investment
Republic of Korea	KRW	SK Securities
Republic of Korea	KRW	Standard Chartered First Bank Korea
Republic of Korea	KRW	Suhyup Bank
Republic of Korea	KRW	Woori Bank