Payouts to Hong Kong
Payout parameters (HKD)
Name | Mandatory | Type | Description |
---|---|---|---|
payment_method | + | object | Payout data |
type | + | string | Value: bank_account |
bank_account | + | object | Bank account |
system_type | + | string | Value: global |
global | + | object | Bank account details |
bank_account_number | + | string | Bank account number for the payout |
description | + | string | Purpose of remittance for the payout. This description should match the classification given in How to specify the remittance purpose |
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 not be processed |
currency | + | string | Recipient's currency in ISO 4217 format. Case insensitive |
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 |
country_iso3 | + | string | Recipient's country code (ISO-3166-1 alpha-3) |
address_line | + | string | Recipient's address |
msisdn | - | string | Recipient's mobile wallet address |
- | string | Recipient's email | |
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",
"currency": "hkd",
"country_iso3": "HKG",
"address_line": "Wall street",
"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"
}
}'
Payout parameters (CNY)
Name | Mandatory | Type | Description |
---|---|---|---|
payment_method | + | 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 |
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 |
address_line | + | string | Recipient's address |
msisdn | - | string | Recipient's mobile wallet address |
- | string | Recipient's email | |
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",
"currency": "cny",
"address_line": "Wall street",
"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"
}
}'
Payout parameters (USD)
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 |
bank_account_number | string | + | Bank account number for the payout |
swift_bic_code | string | - | Recipient's bank’s SWIFT or BIC code |
description | string | + | Purpose of remittance for the payout. This description should match the classification given in How to specify the remittance purpose |
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 |
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 |
address_line | string | + | Sender's address |
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",
"swift_bic_code": "AXISINBB250",
"description": "purpose of remittance"
}
}
},
"participant_details": {
"recipient": {
"bank_name": "Bank name",
"currency": "usd",
"first_name": "John",
"last_name": "Johnson"
},
"sender": {
"company_name": "Company name",
"registration_number": "1234567890",
"country_iso3": "USA",
"address_line": "Wall street",
"code": "1234567890"
}
},
"amount_details": {
"amount": 1000,
"currency": "usd"
}
}'
List of supported banks
Country | Currency | Bank |
---|---|---|
Hong Kong | HKD | ABN AMRO BANK N.V. |
Hong Kong | HKD | Agricultural Bank of China Limited |
Hong Kong | CNY | Agricultural Bank of China Limited |
Hong Kong | HKD | Airstar Bank Limited |
Hong Kong | CNY | Airstar Bank Limited |
Hong Kong | USD | All Banks Hong Kong USD |
Hong Kong | HKD | Ant Bank (Hong Kong) Limited |
Hong Kong | HKD | Australia and New Zealand Banking Corporation Limited |
Hong Kong | CNY | Australia and New Zealand Banking Corporation Limited |
Hong Kong | HKD | Banco Bilbao Vizcaya Argentaria S.A., Hong Kong Branch |
Hong Kong | HKD | BANCO SANTANDER S.A. |
Hong Kong | HKD | BANGKOK BANK PUBLIC COMPANY LIMITED |
Hong Kong | HKD | BANK J. SAFRA SARASIN LTD, HONG KONG BRANCH |
Hong Kong | HKD | BANK JULIUS BAER AND CO LTD HONG KONG |
Hong Kong | HKD | Bank of America N.A. |
Hong Kong | CNY | Bank of America N.A. |
Hong Kong | HKD | Bank of China ( Hong Kong ) Limited |
Hong Kong | CNY | Bank of China ( Hong Kong ) Limited |
Hong Kong | HKD | Bank of Communications (Hong Kong) Ltd. |
Hong Kong | CNY | Bank of Communications (Hong Kong) Ltd. |
Hong Kong | HKD | Bank of Communications Co., Ltd. Hong Kong Branch |
Hong Kong | CNY | Bank of Communications Co., Ltd. Hong Kong Branch |
Hong Kong | HKD | BANK OF INDIA |
Hong Kong | HKD | BANK OF MONTREAL |
Hong Kong | HKD | Bank of Singapore Limited |
Hong Kong | HKD | BANK OF TAIWAN |
Hong Kong | CNY | BANK OF TAIWAN |
Hong Kong | HKD | Bank SinoPac (Hong Kong Branch) |
Hong Kong | CNY | Bank SinoPac (Hong Kong Branch) |
Hong Kong | HKD | Barclays Bank PLC |
Hong Kong | HKD | BDO UNIBANK, INC. |
Hong Kong | HKD | BNP PARIBAS HONG KONG BRANCH |
Hong Kong | CNY | BNP PARIBAS HONG KONG BRANCH |
Hong Kong | HKD | BNP PARIBAS SECURITIES SERVICES |
Hong Kong | HKD | CA Indosuez (Switzerland) SA |
Hong Kong | HKD | CANADIAN IMPERIAL BANK OF COMMERCE |
Hong Kong | HKD | CANARA BANK HONG KONG |
Hong Kong | HKD | CATHAY BANK |
Hong Kong | HKD | Cathay United Bank Company, Limited, Hong Kong Branch |
Hong Kong | HKD | CHANG HWA COMMERCIAL BANK LIMITED |
Hong Kong | HKD | CHINA CITIC BANK INTERNATIONAL LIMITED |
Hong Kong | CNY | CHINA CITIC BANK INTERNATIONAL LIMITED |
Hong Kong | HKD | China Construction Bank (Asia) Corporation Limited |
Hong Kong | CNY | China Construction Bank (Asia) Corporation Limited |
Hong Kong | HKD | China Construction Bank Corporation, Hong Kong Branch |
Hong Kong | CNY | China Construction Bank Corporation, Hong Kong Branch |
Hong Kong | HKD | China Development Bank Hong Kong Branch |
Hong Kong | HKD | China Everbright Bank |
Hong Kong | CNY | China Everbright Bank |
Hong Kong | HKD | China Merchants Bank Co. Ltd. Hong Kong Branch |
Hong Kong | CNY | China Merchants Bank Co. Ltd. Hong Kong Branch |
Hong Kong | HKD | China Minsheng Banking Corp., Ltd |
Hong Kong | CNY | China Minsheng Banking Corp., Ltd |
Hong Kong | HKD | CHINA ZHESHANG BANK CO., LTD. |
Hong Kong | CNY | CHINA ZHESHANG BANK CO., LTD. |
Hong Kong | HKD | Chiyu Banking Corporation Limited |
Hong Kong | CNY | Chiyu Banking Corporation Limited |
Hong Kong | HKD | Chong Hing Bank Limited |
Hong Kong | CNY | Chong Hing Bank Limited |
Hong Kong | HKD | CIMB BANK BERHAD |
Hong Kong | HKD | Citibank (Hong Kong) Limited |
Hong Kong | CNY | Citibank (Hong Kong) Limited |
Hong Kong | HKD | Citibank N.A. |
Hong Kong | CNY | Citibank N.A. |
Hong Kong | HKD | CMB Wing Lung Bank Limited |
Hong Kong | CNY | CMB Wing Lung Bank Limited |
Hong Kong | HKD | Commerzbank AG, Hong Kong Branch |
Hong Kong | CNY | Commerzbank AG, Hong Kong Branch |
Hong Kong | HKD | Commonwealth Bank of Australia |
Hong Kong | HKD | COOPERATIEVE RABOBANK U.A. |
Hong Kong | HKD | Credit Agricole Corporate and Investment Bank |
Hong Kong | HKD | Credit Industriel et Commercial, Hong Kong Branch |
Hong Kong | HKD | Credit Suisse AG Hong Kong Branch |
Hong Kong | HKD | CTBC BANK CO., LTD |
Hong Kong | CNY | CTBC BANK CO., LTD |
Hong Kong | HKD | Dah Sing Bank, Limited |
Hong Kong | CNY | Dah Sing Bank, Limited |
Hong Kong | HKD | DBS Bank (Hong Kong) Limited |
Hong Kong | CNY | DBS Bank (Hong Kong) Limited |
Hong Kong | HKD | DBS Bank Ltd, HK Branch |
Hong Kong | CNY | DBS Bank Ltd, HK Branch |
Hong Kong | HKD | Deutsche Bank AG Hong Kong Branch |
Hong Kong | HKD | DZ BANK AG DEUTSCHE ZENTRAL- GENOSSENSCHAFTSBANK, FRANKFURT AM MAIN, HONG KONG BRANCH |
Hong Kong | HKD | E.Sun Commercial Bank, Ltd. |
Hong Kong | CNY | E.Sun Commercial Bank, Ltd. |
Hong Kong | HKD | EAST WEST BANK |
Hong Kong | HKD | EFG Bank AG Hong Kong Branch |
Hong Kong | HKD | Erste Group Bank AG |
Hong Kong | HKD | Far Eastern International Bank Co Ltd. |
Hong Kong | HKD | First Abu Dhabi Bank PJSC |
Hong Kong | HKD | FIRST COMMERCIAL BANK LTD HONG KONG BRANCH |
Hong Kong | HKD | Fubon Bank (Hong Kong) Limited |
Hong Kong | CNY | Fubon Bank (Hong Kong) Limited |
Hong Kong | HKD | Fusion Bank Limited |
Hong Kong | CNY | Fusion Bank Limited |
Hong Kong | HKD | Hang Seng Bank Ltd. |
Hong Kong | CNY | Hang Seng Bank Ltd. |
Hong Kong | HKD | HDFC BANK LIMITED |
Hong Kong | HKD | Hong Leong Bank Berhad Hong Kong Branch |
Hong Kong | CNY | Hong Leong Bank Berhad Hong Kong Branch |
Hong Kong | HKD | HUA NAN COMMERCIAL BANK LTD. (HK BRANCH) |
Hong Kong | HKD | Hua Xia Bank Co., Limited |
Hong Kong | HKD | ICBC STANDARD BANK PLC |
Hong Kong | HKD | ICICI BANK LIMITED |
Hong Kong | HKD | INDIAN OVERSEAS BANK |
Hong Kong | HKD | Industrial and Commercial Bank of China (Asia) |
Hong Kong | CNY | Industrial and Commercial Bank of China (Asia) |
Hong Kong | HKD | INDUSTRIAL AND COMMERCIAL BANK OF CHINA LIMITED |
Hong Kong | HKD | Industrial Bank Co., Ltd., Hong Kong Branch |
Hong Kong | CNY | Industrial Bank Co., Ltd., Hong Kong Branch |
Hong Kong | HKD | INDUSTRIAL BANK OF KOREA |
Hong Kong | HKD | ING Bank N.V., Hong Kong |
Hong Kong | HKD | Intesa Sanpaolo S.p.A., Hong Kong |
Hong Kong | HKD | JPMorgan Chase Bank, N.A. |
Hong Kong | HKD | KBC Bank N.V. Hong Kong Branch |
Hong Kong | HKD | KEB HANA BANK |
Hong Kong | HKD | Kookmin Bank |
Hong Kong | HKD | LAND BANK OF TAIWAN CO.,LTD. |
Hong Kong | HKD | LGT Bank AG., HK Branch |
Hong Kong | CNY | LGT Bank AG., HK Branch |
Hong Kong | HKD | Livi Bank Limited |
Hong Kong | CNY | Livi Bank Limited |
Hong Kong | HKD | MACQUARIE BANK LIMITED |
Hong Kong | HKD | Malayan Banking Berhad Hong Kong Branch |
Hong Kong | CNY | Malayan Banking Berhad Hong Kong Branch |
Hong Kong | HKD | Mashreq Bank Public Shareholding Company |
Hong Kong | CNY | Mashreq Bank Public Shareholding Company |
Hong Kong | HKD | Mega International Commercial Bank Co Ltd |
Hong Kong | HKD | Melli Bank Plc |
Hong Kong | HKD | MITSUBISHI UFJ TRUST AND BANKING CORPORATION |
Hong Kong | HKD | Mizuho Bank, Ltd. |
Hong Kong | CNY | Mizuho Bank, Ltd. |
Hong Kong | HKD | Mox Bank Limited |
Hong Kong | HKD | MUFG Bank, Ltd. |
Hong Kong | CNY | MUFG Bank, Ltd. |
Hong Kong | HKD | Nanyang Commercial Bank |
Hong Kong | CNY | Nanyang Commercial Bank |
Hong Kong | HKD | National Australia Bank Limited |
Hong Kong | HKD | National Bank of Pakistan |
Hong Kong | HKD | NATIXIS HONG KONG BRANCH |
Hong Kong | HKD | NatWest Markets Plc Hong Kong Branch |
Hong Kong | HKD | O-Bank Co., Ltd |
Hong Kong | HKD | OCBC Wing Hang Bank Limited |
Hong Kong | CNY | OCBC Wing Hang Bank Limited |
Hong Kong | HKD | OVERSEA - CHINESE BANKING CORPORATION LIMITED |
Hong Kong | CNY | OVERSEA - CHINESE BANKING CORPORATION LIMITED |
Hong Kong | HKD | PHILIPPINE NATIONAL BANK |
Hong Kong | HKD | Pictet & Cie (Europe) S.A., Hong Kong Branch |
Hong Kong | HKD | Ping An Bank Co., Ltd. |
Hong Kong | CNY | Ping An Bank Co., Ltd. |
Hong Kong | HKD | Ping An OneConnect Bank (Hong Kong) Limited |
Hong Kong | HKD | PT. BANK NEGARA INDONESIA (PERSERO) TBK. |
Hong Kong | HKD | Public Bank (Hong Kong) Limited |
Hong Kong | CNY | Public Bank (Hong Kong) Limited |
Hong Kong | HKD | PUNJAB NATIONAL BANK |
Hong Kong | HKD | Royal Bank of Canada, Hong Kong Branch |
Hong Kong | HKD | Shanghai Commercial Bank Limited |
Hong Kong | CNY | Shanghai Commercial Bank Limited |
Hong Kong | HKD | Shanghai Pudong Development Bank Co., Ltd. |
Hong Kong | CNY | Shanghai Pudong Development Bank Co., Ltd. |
Hong Kong | HKD | Shinhan Bank Hong Kong Branch |
Hong Kong | HKD | Skandinaviska Enskilda Banken AB |
Hong Kong | HKD | SOCIETE GENERALE HONGKONG BRANCH |
Hong Kong | HKD | Standard Chartered Bank (Hong Kong) Limited |
Hong Kong | CNY | Standard Chartered Bank (Hong Kong) Limited |
Hong Kong | HKD | STATE BANK OF INDIA |
Hong Kong | HKD | State Street Bank & Trust Company, Hong Kong |
Hong Kong | HKD | Sumitomo Mitsui Banking Corporation |
Hong Kong | CNY | Sumitomo Mitsui Banking Corporation |
Hong Kong | HKD | Sumitomo Mitsui Trust Bank, Limited, Hong Kong Branch |
Hong Kong | HKD | SVENSKA HANDELSBANKEN AB (PUBL) HONG KONG BRANCH |
Hong Kong | HKD | TAI SANG BANK LTD. |
Hong Kong | HKD | Tai Yau Bank Limited |
Hong Kong | HKD | Taipei Fubon Commercial Bank |
Hong Kong | CNY | Taipei Fubon Commercial Bank |
Hong Kong | HKD | Taishin International Bank Co Ltd |
Hong Kong | CNY | Taishin International Bank Co Ltd |
Hong Kong | HKD | Taiwan Business Bank, Ltd. |
Hong Kong | HKD | Taiwan Cooperative Bank |
Hong Kong | HKD | Taiwan Shin Kong Commercial Bank Co., LTD. |
Hong Kong | HKD | The Bank of East Asia, Limited |
Hong Kong | CNY | The Bank of East Asia, Limited |
Hong Kong | HKD | The Bank of New York Mellon, Hong Kong Branch |
Hong Kong | HKD | The Bank of Nova Scotia |
Hong Kong | HKD | The Chiba Bank Ltd |
Hong Kong | HKD | THE CHUGOKU BANK, LTD. |
Hong Kong | HKD | The Hachijuni Bank Ltd |
Hong Kong | HKD | The Hongkong and Shanghai Banking Corporation Limited |
Hong Kong | CNY | The Hongkong and Shanghai Banking Corporation Limited |
Hong Kong | HKD | The Shanghai Commercial & Savings Bank Ltd.Hong Kong Branch. |
Hong Kong | HKD | THE SHIGA BANK, LTD. |
Hong Kong | HKD | The Shizuoka Bank, Ltd. |
Hong Kong | HKD | Toronto Dominion Bank |
Hong Kong | HKD | UBS AG Hong Kong |
Hong Kong | HKD | UCO BANK HONG KONG |
Hong Kong | HKD | UNICREDIT BANK AG HONG KONG BRANCH |
Hong Kong | CNY | UNICREDIT BANK AG HONG KONG BRANCH |
Hong Kong | HKD | Union Bancaire Privee, UBP SA |
Hong Kong | HKD | UNION BANK OF INDIA |
Hong Kong | HKD | United Overseas Bank Limited |
Hong Kong | CNY | United Overseas Bank Limited |
Hong Kong | HKD | Welab Bank Limited |
Hong Kong | HKD | Wells Fargo Bank, N.A. Hong Kong Branch |
Hong Kong | HKD | Westpac Banking Corporation |
Hong Kong | HKD | Woori Bank Hong Kong Branch |
Hong Kong | HKD | YUANTA COMMERCIAL BANK CO.,LTD |
Hong Kong | HKD | ZA Bank Limited |
Hong Kong | CNY | ZA Bank Limited |