Tài liệu API
Bắt đầu
- Thêm tài khoản ngân hàng trong mục Cổng Thanh Toán, sau đó bấm Lấy Token để lấy token API của tài khoản đó.
- Gọi
GETtới endpoint của bank, thay{token}bằng token vừa lấy. - Nên dùng V2: mọi ngân hàng trả về cùng một định dạng như bên dưới. V1 trả nguyên dữ liệu gốc của từng ngân hàng.
- Muốn được thông báo ngay khi có giao dịch thay vì tự gọi API liên tục, hãy dùng Webhook.
Định dạng response V2 (chung mọi bank)
| Trường | Kiểu | Mô tả |
|---|---|---|
| status | string | success khi thành công, khác success là lỗi (xem msg) |
| transactions[].transactionID | string | Mã giao dịch phía ngân hàng |
| transactions[].amount | number | Số tiền (VND) |
| transactions[].description | string | Nội dung chuyển khoản |
| transactions[].transactionDate | string | Ngày giao dịch |
| transactions[].transactionTime | string | Giờ giao dịch HH:mm:ss |
| transactions[].type | string | IN tiền vào, OUT tiền ra |
HTTP/1.1 200 OK
{
"status": "false",
"msg": "Authorization Token not found"
}
HTTP/1.1 200 OK
{
"status": "success",
"message": "Thành công",
"transactions": [
{
"transactionID": "FT24316123456",
"amount": 50000,
"description": "NAP123 chuyen tien",
"transactionDate": "11/11/2024",
"transactionTime": "20:41:05",
"type": "IN"
},
{
"transactionID": "FT24316654321",
"amount": 8000,
"description": "Thanh toan don hang",
"transactionDate": "11/11/2024",
"transactionTime": "12:11:23",
"type": "OUT"
}
]
}
Endpoint theo ngân hàng
GET
https://pay.mualike.pro/historyapivcbv2/{token}
Response theo định dạng V2 chung ở trên. Lấy token tại danh sách tài khoản Vietcombank.
GET
https://pay.mualike.pro/historyapivcb/{token}
Xem response mẫu V1 của Vietcombank
HTTP/1.1 200 OK
{
"mid": "14",
"code": "00",
"des": "success",
"transactions": [
{
"tranDate": "11/11/2024",
"curCode": "VND",
"TransactionDate": "11/11/2024",
"Reference": "5272 - 23809",
"CD": "-",
"Amount": "8,000",
"Description": "MBVCB.7575327615.426726.DVD5216.CT tu 9356085124 NGUYEN VAN THIN toi 17236521 NGUYEN MINH QUAN tai ACB",
"PCTime": "121123",
"DorCCode": "D",
"EffDate": "2024-11-11",
"PostingDate": "2024-11-11",
"PostingTime": "121123",
"Remark": "MBVCB.7575327615.426726.DVD5216.CT tu 9356085124 NGUYEN VAN THIN toi 17236521 NGUYEN MINH QUAN tai ACB",
"SeqNo": "23809",
"TnxCode": "74",
"Teller": "5272"
},
{
"tranDate": "10/11/2024",
"curCode": "VND",
"TransactionDate": "10/11/2024",
"Reference": "5209 - 74975",
"CD": "+",
"Amount": "10,000",
"Description": "191723.101124.204104.DINH VAN CAU chuyen tien",
"PCTime": "204105",
"DorCCode": "C",
"EffDate": "2024-11-10",
"PostingDate": "2024-11-10",
"PostingTime": "204105",
"Remark": "191723.101124.204104.DINH VAN CAU chuyen tien",
"SeqNo": "74975",
"TnxCode": "34",
"Teller": "5209"
}
],
"nextIndex": "1"
}
GET
https://pay.mualike.pro/historyapivcbbizv2/{token}
Hỗ trợ lọc ngày:
?fromDate=dd/mm/yyyy&toDate=dd/mm/yyyy (mặc định từ đầu tháng đến hôm nay).Response theo định dạng V2 chung ở trên. Lấy token tại danh sách tài khoản VCB DigiBiz.
GET
https://pay.mualike.pro/historyapivcbbiz/{token}
Xem response mẫu V1 của VCB DigiBiz
HTTP/1.1 200 OK
{
"code": "00",
"message": "Thành công",
"traceId": "1776779271507149",
"data": {
"listHistory": [
{
"transactionDate": "2026-04-17",
"reference": "5425 - 42182",
"cd": "C",
"amount": 10000,
"description": "6107ASCB02QWPUG6.VI MINH KHOI CHUYEN KHOAN",
"tranCode": "34",
"tranType": "TRF",
"pcTime": "162540",
"seq": 0
}
],
"openAtCounter": "0"
}
}
GET
https://pay.mualike.pro/historyapitpbv2/{token}
Response theo định dạng V2 chung ở trên. Lấy token tại danh sách tài khoản TPBank.
GET
https://pay.mualike.pro/historyapitpb/{token}
Xem response mẫu V1 của TPBank
HTTP/1.1 200 OK
{
"totalCount": 2,
"transactionInfos": [
{
"arrangementId": "0000123456789",
"accountNo": "00001234567",
"bookingDate": "2025-02-01",
"bookingDateTime": "2025-02-01T09:30:15",
"description": "NGUYEN VAN B chuyen tien",
"creditAmount": 100000,
"debitAmount": 0,
"typeGroup": "CREDIT",
"currency": "VND",
"runningBalance": 500000
},
{
"arrangementId": "0000123456790",
"accountNo": "00001234567",
"bookingDate": "2025-01-31",
"bookingDateTime": "2025-01-31T16:45:00",
"description": "Thanh toan hoa don",
"creditAmount": 0,
"debitAmount": 50000,
"typeGroup": "DEBIT",
"currency": "VND",
"runningBalance": 400000
}
]
}
GET
https://pay.mualike.pro/historyapimbbankv2/{token}
Response theo định dạng V2 chung ở trên. Lấy token tại danh sách tài khoản MBBank.
GET
https://pay.mualike.pro/historymbbank/{token}
Xem response mẫu V1 của MBBank
HTTP/1.1 200 OK
{
"status": "success",
"message": "Thành công",
"TranList": [
{
"tranId": "FT23219370350054\\E17",
"postingDate": "07/08/2023 00:01:00",
"transactionDate": "06/08/2023 22:55:00",
"accountNo": "990919072000",
"creditAmount": "30000",
"debitAmount": "0",
"currency": "VND",
"description": "CUSTOMER cms2471. TU: NGUYEN QUOC LINH",
"availableBalance": null,
"beneficiaryAccount": null
},
{
"tranId": "FT23217019574662\\BNK",
"postingDate": "05/08/2023 14:54:00",
"transactionDate": "05/08/2023 14:54:00",
"accountNo": "990919072000",
"creditAmount": "30000",
"debitAmount": "0",
"currency": "VND",
"description": "CUSTOMER QR cms2811 Ma giao dich Trace2 23979 Trace 223979",
"availableBalance": null,
"beneficiaryAccount": null
},
{
"tranId": "FT23217060767427\\BNK",
"postingDate": "05/08/2023 12:58:00",
"transactionDate": "05/08/2023 12:58:00",
"accountNo": "990919072000",
"creditAmount": "30000",
"debitAmount": "0",
"currency": "VND",
"description": "CUSTOMER MBVCB 3973808215 091310 cms2110 CT tu 1028510335 TRAN MINH DUC toi 990 919072000 NGUYEN NHAT LOC Ngan hang Quan Doi MB Ma giao dich Trac",
"availableBalance": null,
"beneficiaryAccount": null
}
]
}
GET
https://pay.mualike.pro/historyapiviettinv2/{token}
Response theo định dạng V2 chung ở trên. Lấy token tại danh sách tài khoản VietinBank.
GET
https://pay.mualike.pro/historyapiviettin/{token}
Xem response mẫu V1 của VietinBank
HTTP/1.1 200 OK
{
"requestId": "BAIJTHHCHWKK|1731778107359",
"sessionId": "KRQO5F46FU",
"error": false,
"accountNo": "102880021842",
"currentPage": 0,
"nextPage": 1,
"pageSize": 100,
"totalRecords": 248,
"warningMsg": "",
"transactions": [
{
"currency": "VND",
"remark": "CT DI:424K24B0RAMJZ8HR NGUYEN MAI PHUONG HOA Chuyen tien",
"amount": "20000",
"balance": "27347",
"trxId": "424K24B0RAMJZ8HR",
"processDate": "16-11-2024 16:18:31",
"dorC": "D",
"refType": "",
"refId": "",
"tellerId": null,
"corresponsiveAccount": "8810019139",
"corresponsiveName": "DANG THI THAO",
"channel": "78 - Retail Internet Banking",
"serviceBranchId": "",
"serviceBranchName": "CN BAC THANH HOA - PGD NGA SON",
"pmtType": "RTGS - Chuyển tiền nhanh",
"sendingBankId": "",
"sendingBranchId": "",
"sendingBranchName": "",
"receivingBankId": "",
"receivingBranchId": "",
"receivingBranchName": "BIDV_NHTMCP DT va PT VN"
},
{
"currency": "VND",
"remark": "CT DEN:424T24A08B7TCKMW MBVCB.7228830596.305524.chuyen tien.CT tu 1047930198 TRAN QUY PHONG toi 102880021842 NGUYEN MAI PHUONG HOA tai VIETINBANK",
"amount": "50000",
"balance": "170479",
"trxId": "424T24A08B7TCKMW",
"processDate": "06-10-2024 08:32:14",
"dorC": "C",
"refType": "",
"refId": "",
"tellerId": null,
"corresponsiveAccount": "1047930198",
"corresponsiveName": "TRAN QUY PHONG",
"channel": "44 - Gateway (VTB)",
"serviceBranchId": "",
"serviceBranchName": "CN BAC THANH HOA - PGD NGA SON",
"pmtType": "RTGSIN - Chuyển tiền nhanh",
"sendingBankId": "",
"sendingBranchId": "",
"sendingBranchName": "VCB_NH TMCP Ngoai thuong VN",
"receivingBankId": "",
"receivingBranchId": "",
"receivingBranchName": ""
}
],
"checksum": "558172ac8904739f77916163da186b7c"
}
GET
https://pay.mualike.pro/historyapiviettelv2/{token}
Chỉ trả về
description, transactionDate, type (chưa có mã giao dịch và số tiền).Response theo định dạng V2 chung ở trên. Lấy token tại danh sách tài khoản Viettel Money.
GET
https://pay.mualike.pro/historyapiviettel/{token}
Xem response mẫu V1 của Viettel Money
HTTP/1.1 200 OK
{
"status": {
"code": "00",
"message": "Thành công.",
"responseTime": "2024-11-15T08:19:50.756Z",
"displayMessage": "Thành công."
},
"data": {
"content": [
{
"msisdn": "84973135071",
"clientCode": "VTP",
"clientId": "241020721712523DEBIT",
"channelType": "ALL",
"msgType": "BDSD",
"msgContent": "GD chuyen tien 241020721712523 NGUYEN THI HOANG VAN chuyen tien tu Viettel Money",
"requestId": "241020721712523",
"orderId": "241020721712523DEBIT",
"transDate": "2024-10-20 19:38:35",
"accountId": "9704...2255",
"amount": "100000",
"fee": "0",
"balance": "105482",
"bankTransId": "241020721712523",
"description": "241020721712523 NGUYEN THI HOANG VAN chuyen tien tu Viettel Money",
"paymentType": "DEBIT",
"status": 2,
"retry": false
},
{
"msisdn": "84973135071",
"clientCode": "MB",
"clientId": "I5uk35940260CREDIT",
"channelType": "ALL",
"msgType": "BDSD",
"msgContent": "I5uk35940260 NGUYEN BIEN TAN DAT chuyen tien",
"requestId": "",
"orderId": "I5uk35940260CREDIT",
"transDate": "2024-10-19 08:30:01",
"accountId": "9704...2255",
"amount": "200000",
"fee": "0",
"balance": "205482",
"bankTransId": "I5uk35940260",
"description": "I5uk35940260 NGUYEN BIEN TAN DAT chuyen tien",
"paymentType": "CREDIT",
"status": 2,
"retry": false
}
],
"pageMetadata": {
"size": 20,
"page": 1,
"totalPages": 16,
"totalElements": 305
}
}
}