Payouts to Vietnam
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": "vnd",
"country_iso3": "VIE",
"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 |
|---|---|---|
| Vietnam | VND | Dong A Joint Stock Commercial Bank (DongA Bank) |
| Vietnam | VND | United Overseas Bank (Vietnam) Limited |
| Vietnam | VND | Cimb Bank (Vietnam) Limited |
| Vietnam | VND | Industrial Bank Of Korea Ha Noi Branch |
| Vietnam | VND | National Citizen Commercial Joint Stock Bank (NCB) |
| Vietnam | VND | Woori Bank |
| Vietnam | VND | Shinhan Bank Vietnam (SHBVN) |
| Vietnam | VND | Hong Leong Bank Vietnam |
| Vietnam | VND | Vietnam Russia Joint Venture Bank (VR Bank) |
| Vietnam | VND | Indovina Bank |
| Vietnam | VND | ZaloPay |
| Vietnam | VND | Public Bank Vietnam Limited (Public Bank) |
| Vietnam | VND | Vietnam Public Joint Stock Commercial Bank (PVcomBank) |
| Vietnam | VND | BaoViet Commercial Joint Stock Bank (BaoViet Bank) |
| Vietnam | VND | Vietnam Thuong Tin Commercial Joint Stock Bank (Vietbank) |
| Vietnam | VND | Viet A Joint Stock Commercial Bank (Viet A Bank) |
| Vietnam | VND | Orient Commercial Bank (OCB) |
| Vietnam | VND | Viet Capital Joint Stock Commercial Bank (Viet Capital Bank) |
| Vietnam | VND | VNPT Pay |
| Vietnam | VND | Vietnam Export Import Commercial Joint Stock Bank (EximBank) |
| Vietnam | VND | An Binh Commercial Joint Stock Bank (AnBinh Bank) |
| Vietnam | VND | Vietnam Bank for Agriculture and Rural Development (AgriBank) |
| Vietnam | VND | Military Commercial Joint Stock bank (MB) |
| Vietnam | VND | Nam A Commercial Joint Stock Bank (NamA Bank) |
| Vietnam | VND | Vietnam Maritime Commercial Joint Stock Bank (Maritime Bank) |
| Vietnam | VND | Bank for Investment and Development of Vietnam Joint Stock Commercial Bank (BIDV) |
| Vietnam | VND | Vietnam Technological and commercial Joint Stock Bank (Techcom Bank) |
| Vietnam | VND | Vietnam Prosperity Joint Stock Commercial Bank (VPBank) |
| Vietnam | VND | Vietnam Joint Stock Commercial Bank for Intrustry and Trade (VietinBank) |
| Vietnam | VND | Vietnam International Commercial Joint Stock Bank (VIB) |
| Vietnam | VND | Tienphong commercial Joint Stock Bank (TienPhong Bank) |
| Vietnam | VND | Southeast Asia Commercial Joint Stock Bank (SeaBank) |
| Vietnam | VND | Saigon Thuong Tin Commercial Joint Stock Bank (SacomBank) |
| Vietnam | VND | Saigon Commercial Bank (SGCB) |
| Vietnam | VND | Saigon Bank for Industry and Trade (SaigonBank) |
| Vietnam | VND | Saigon - Hanoi Commercial Joint Stock Bank (SHB) |
| Vietnam | VND | Petrolimex Group Commercial Joint Stock Bank (PG Bank) |
| Vietnam | VND | Ocean Commercial One Member Limited Liability Bank (OceanBank) |
| Vietnam | VND | Lien Viet Post Joint Stock Commercial Bank (LienViet Bank) |
| Vietnam | VND | Kien Long Commercial Joint Stock Bank (KienLong Bank) |
| Vietnam | VND | Joint Stock Commercial Bank for Foreign Trade of Vietnam (Vietcombank) |
| Vietnam | VND | Ho Chi Minh City Development Joint Stock Commercial Bank (HDBank) |
| Vietnam | VND | Global Petro Sole Member Limited Commercial Bank (GPBank) |
| Vietnam | VND | Asia Commercial Bank (ACB) |
| Vietnam | VND | Momo |