Api & Demo

Params (Body)

Headers: Content-Type: application/json, APIKEY, Checksum (HMAC-MD5 chuỗi ký theo thứ tự: amount, request_id, type, callback — hex)

Param	Type	Bắt buộc	Mô tả
amount	number	✓	Số tiền VNĐ
request_id	string	✓	Mã đơn duy nhất
type	string	✓	bank | momo
callback	string	—	URL nhận thông báo khi giao dịch hoàn tất

Chuỗi ký (bodyToSign): JSON.stringify({"amount": amount, "request_id": request_id, "type": type, "callback": callback || ""}) — dùng Private Key để tạo Checksum (HMAC-MD5).

Body example:

{
  "amount": 10000,
  "request_id": "112233445566111",
  "type": "bank",
  "callback": "https://example.com/callback"
}

Response example (bank):

{
  "success": true,
  "request_id": "vietnam006",
  "amount": 50000,
  "status": true,
  "message": "success",
  "results": {
    "account": "37314017",
    "account_name": "NGUYEN THI XUAN LINH",
    "amount": 50000,
    "bank": "ACB",
    "bank_code": "ACB",
    "content": "ck lose cat 75603",
    "qr_data": "0002010102123852...",
    "qr_img": "data:image/png;base64,iVBORw0KGgo..."
  },
  "qr_link": "0002010102123852..."
}

Response example (momo — có thêm deep_link):

{
  "success": true,
  "request_id": "momo001",
  "amount": 50000,
  "status": true,
  "message": "success",
  "results": {
    "amount": 50000,
    "content": "small movie 43674",
    "deep_link": "momo:///?action=p2p&extra=...&url=https://momo.vn/download",
    "name": "Nguyễn Thị Nuôi",
    "phone": "0993847905",
    "qr_data": "2|99|0993847905|...",
    "qr_img": "data:image/png;base64,iVBORw0KGgo..."
  },
  "qr_link": "2|99|0993847905|...",
  "deep_link": "momo:///?action=p2p&extra=..."
}

Params (Body)

Param	Type	Bắt buộc	Mô tả
request_id	string	✓	Mã đơn duy nhất
type	string	✓	bank | momo
amount	number	✓	Số tiền VNĐ (min 100.000)
account	string	✓	STK (bank) hoặc SĐT (momo)
bank_code	string	bank	Mã ngân hàng (VD: VCB) hoặc MOMO
bank_fullname	string	✓	Tên chủ tài khoản
callback	string	—	URL nhận thông báo khi giao dịch hoàn tất

Headers: Content-Type: application/json, APIKEY: YOUR_API_KEY, Checksum: HMAC-MD5(JSON body, privateKey) hex

Chuỗi ký (checksum): request_id, type, amount, account, bank_code, bank_fullname, callback

Body example:

{
  "request_id": "hatay001",
  "type": "bank",
  "amount": 100000,
  "account": "321321321321",
  "bank_code": "VCB",
  "bank_fullname": "NGUYEN VAN A",
  "callback": "https://example.com/cashout-callback"
}

Response example:

{
  "success": true,
  "request_id": "hatay001",
  "amount": 100000,
  "status": "PENDING",
  "message": "OK",
  "results": {}
}

Headers: APIKEY: YOUR_API_KEY

Response example:

{
  "success": true,
  "data": [
    { "code": "VCB", "name": "Vietcombank" },
    { "code": "BIDV", "name": "BIDV" }
  ]
}

Params (Query)

Param	Type	Bắt buộc	Mô tả
request_id	string	✓	Mã đơn duy nhất

Headers: APIKEY: YOUR_API_KEY

Response example:

{
  "success": true,
  "request_id": "112233445566111",
  "amount": 50000,
  "fee_amount": 2000,
  "status": "SUCCESS",
  "created_at": "...",
  "updated_at": "..."
}

Params (Query)

Param	Type	Bắt buộc	Mô tả
request_id	string	✓	Mã đơn duy nhất

Headers: APIKEY: YOUR_API_KEY

Response example:

{
  "success": true,
  "request_id": "hatay001",
  "amount": 50000,
  "status": "SUCCESS",
  "type": "bank",
  "created_at": "...",
  "updated_at": "..."
}

Code	Bank Name
ABB	ABBANK
ACB	ACB
AGR	Agribank
BAB	Bac A Bank
VCCB	BanVietBank
BVB	Bao Viet Bank
BIDV	BIDV
CAKE	Cake by VPBank
DAB	Dong A Bank
EIB	Eximbank
HDB	HD Bank
KLB	KienLong Bank
LPB	LienVietPostBank
MSB	Maritime Bank
MBB	MB Bank
NAB	Nam A Bank
OCB	Orient Commercial Bank
PGB	PG Bank
PVC	PVComBank
STB	Sacombank
SCB	Sai Gon Commercial Bank
SGB	Saigonbank
SEAB	SeaBank
SHB	SHB bank
SHBVN	Shinhan bank Việt Nam
TCB	Techcombank
TPB	TienPhong Bank
VIB	VIB
VBB	VietBank
VCB	Vietcombank
VTB	Vietinbank
VPB	VP Bank
MOMO	Ví Momo