Mandatory parameters - Bank transfer

Mandatory parameterDescriptionFlow
login32 charsALL
pass32 charsALL
external_idMax. 100 charsALL
beneficiary_nameMax. 50 charsALL
beneficiary_lastnameMax. 50 charsALL
countryVNALL
bank_codeSee bank codes below.ALL
bank_accountMax. 45 charsALL
amountMax. 2 decimal numbersALL
currencyVND or USDALL
purpose"EPREMT" (remittance)
Mandatory only for remittance (P2P)
P2P
remitter_full_nameMax. 50 chars
Mandatory only for remittance (P2P)
P2P
remitter_document_type"ID" for national identification number
"PASS" for passport
Mandatory only for remittance (P2P)
P2P
remitter_documentMax. 45 chars
Mandatory only for remittance (P2P)
P2P
remitter_birth_dateFormat 'YYYYMMDD'
Mandatory only for remittance (P2P)
P2P
remitter_addressMax. 200 chars
Mandatory only for remittance (P2P)
P2P
remitter_countryISO 3166-1 alpha-2 code
Mandatory only for remittance (P2P)
P2P

Example request

{
    "login":"1n234n56",
    "pass":"HolAc123o",
    "external_id": "#RANDOMALPHANUMERIC:9",
    "document_id": "27836873654",
    "beneficiary_name": "Juan",
    "beneficiary_lastname": "Alonso",
    "country": "VN",
    "bank_code": "13",
    "bank_account": "1234567890",
    "account_type": "C",
    "amount": 10,
    "currency": "VND",
    "type": "json",
    "notification_url":"https://thisisawebsite.net/payments"
}

Mandatory parameters - Wallets transfer

Mandatory parameterDescription
login32 chars
pass32 chars
external_idMax. 100 chars
beneficiary_nameMax. 50 chars
beneficiary_lastnameMax. 50 chars
countryVN
account_type"MOMO" for Mobile Money
"VNPAY" for VNPAY
"VNPT" for VNPT Pay
amountMax. 2 decimal numbers
currencyUSD or VND
phoneMax. 15 chars (country code (+84) + up to 11 digits)
addressMax. 200 chars

Example request

{
    "external_id": "8tSHXacig",
    "beneficiary_name": "Test",
    "beneficiary_lastname": "Test",
    "country": "VN",
    "account_type": "MOMO",
    "amount": 10,
    "currency": "VND",
    "type": "json",
    "phone": "+8534655436888",
    "address": "test address",
    "login": "userco",
    "pass": "passco"
}

Bank codes

Bank CodeBank NameOther name
36Australia and New Zealand Banking GroupANZ Vietnam
54CIMB Bank LimitedCIMB Bank
51Citibank Bank Viet NamCitibank
43Cooperative Bank of VietnamCoopBank
37HSBC Bank VietnamHSBC Bank
48Industrial Bank of Korea– Ha Noi branchIBK - HN
39Nam A Commercial Join Stock BankNamABank
46Ngân hàng TNHH IndovinaIVB
41NH Chinh Sach XHVNVBSP
16NH Lien Doanh Viet NgaVRBank
40NH MoneygramMoneygramBank
13NH Nong Nghiep va Phat Trien Nong Thon Vietnam *Agribank
42NH Phat Trien VNVDB
15NH Vietnam Thuong TinVietBank
45NH Xay Dung VNCBBank
18NHTMCP A ChauACB
4NHTMCP An BinhABBank
31NHTMCP Bac ABacABank
14NHTMCP Ban VietVietcapital Bank
32NHTMCP Bao VietBVB
30NHTMCP Buu Dien Lien VietLienVietPostBank
2NHTMCP Cong Thuong VietnamVietinbank
7NHTMCP Dai Chung VietnamPVcomBank
5NHTMCP Dai DuongOceanBank
9NHTMCP Dau Khi Toan CauGP Bank
11NHTMCP Dau Tu va Phat Trien VietnamBIDV Bank
10NHTMCP Dong A *Dong A Bank
6NHTMCP Dong Nam ASeABank
12NHTMCP Kien LongKienLongBank
26NHTMCP Ky Thuong VietnamTechcombank
17NHTMCP Ngoai Thuong VietnamVietcombank (VCB)
22NHTMCP Phat Trien Thanh Pho HCMHDBank
27NHTMCP Phuong DongOCB
23NHTMCP Quan DoiMBBank
28NHTMCP Quoc DanNCB
25NHTMCP Quoc Te VietnamVIB
21NHTMCP Sai Gon Ha NoiSHB
35NHTMCP SaigonSCB
3NHTMCP Saigon Cong ThuongSaigonbank
1NHTMCP Saigon Thuong TinSacombank
20NHTMCP Tien PhongTPBank
24NHTMCP Vietnam Thinh VuongVPBank
8NHTMCP Xang Dau PetrolimexPG Bank
19NHTMCP Xuat Nhap Khau VietnamEximbank
29NHTNHH MTV Hongleong VietnamHLBVN
34NHTNHH MTV Public VietnamPublic Bank VN
33NHTNHH MTV Shinhan VietnamShinhanVN
52Standard Chartered Bank Viet Nam LimitedStandard Chartered Bank
53United Overseas Bank Viet NamUOB Bank
44Viet A BankVAB
38Vietnam Maritime Commercial Stock BankMaritime Bank
49Woori Bank VietnamWooriBank