API Viettel Money: tài liệu lấy lịch sử giao dịch

VIETTEL API

Tích hợp giao dịch Viettel Money

Đọc lịch sử giao dịch Viettel Money và đưa dữ liệu tiền vào về website bằng API hoặc webhook. Kết nối này phù hợp cho dịch vụ số, đại lý và nền tảng có khách hàng thanh toán qua ví.

Phương thứcGET

Định dạngJSON

Xác thựcToken

Phiên bảnV1, V2, V3

Tài liệu API theo phiên bản

Chọn phiên bản tương ứng trong trang quản lý tài khoản Viettel Money để xem tham số và dữ liệu trả về.

GETV1

https://thueapibank.vn/historyapiviettel/YOUR_TOKEN

Tham số cần thiết

Tham số	Bắt buộc	Mô tả
`YOUR_TOKEN`	Có	Token API được cấp trong trang quản lý.

Code mẫu

curl --request GET \
  "https://thueapibank.vn/historyapiviettel/YOUR_TOKEN" \
  --header "Accept: application/json"

<?php
$ch = curl_init('https://thueapibank.vn/historyapiviettel/YOUR_TOKEN');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 20,
    CURLOPT_HTTPHEADER => ['Accept: application/json'],
]);
$response = curl_exec($ch);
$data = json_decode($response, true, flags: JSON_THROW_ON_ERROR);
curl_close($ch);

const response = await fetch('https://thueapibank.vn/historyapiviettel/YOUR_TOKEN', {
  headers: { Accept: 'application/json' }
});

if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

Response mẫu

{
  "status": {
    "code": "00",
    "message": "Thành công.",
    "responseTime": "2026-03-07T13:47:54.465Z",
    "displayMessage": "Thành công."
  },
  "data": {
    "trans": [
      {
        "id": "ab600e44-0947-47a5-ae51-2fb9b38e7937",
        "processCode": "912020",
        "serviceCode": "MMSERVICEAPI",
        "requestId": "260115607700684",
        "transactionId": "260115607700684",
        "requestDate": "2026-01-15 18:05:05",
        "transName": "Nhận tiền TK Mobile Money",
        "transAmount": "2.000",
        "tranStatus": "THANH_CONG",
        "transType": null,
        "transDesc": "BUI THANH PHUONG chuyen FT26015090936188",
        "sourceBankCode": "MM",
        "spendMoneyTransaction": false,
        "displayType": "91",
        "iconUrl": "https://api24cdn.vtmoney.vn/vtm-icon/images/vtm-features/icHisTransfer.png",
        "originalTransHis": null,
        "action": "DEL",
        "viettelBankCode": "MM",
        "fields": null,
        "appExtraInfo": null
      },
      {
        "id": "a42ab276-c86d-4789-99e7-9ef8cac0503d",
        "processCode": "CT2200",
        "serviceCode": null,
        "requestId": "260113515069084",
        "transactionId": "260113515069084",
        "requestDate": "2026-01-13 02:00:27",
        "transName": "BUI THANH PHUONG",
        "transAmount": "2.000",
        "tranStatus": "THANH_CONG",
        "transType": "CHUYENTIEN",
        "transDesc": "Bui Thanh Phuong chuyen tien tu ViettelMoney",
        "sourceBankCode": "MM",
        "spendMoneyTransaction": true,
        "displayType": "2",
        "iconUrl": "https://api24cdn.vtmoney.vn/vtm-icon/images/vtm-features/icHisTransfer.png",
        "originalTransHis": null,
        "action": "DEL",
        "viettelBankCode": "MM",
        "fields": null,
        "appExtraInfo": null
      },
      {
        "id": "cd96b73a-6d64-46d2-932d-986fadd6a7f7",
        "processCode": "912020",
        "serviceCode": "MMSERVICEAPI",
        "requestId": "260113662256831",
        "transactionId": "260113662256831",
        "requestDate": "2026-01-13 01:59:32",
        "transName": "Nhận tiền TK Mobile Money",
        "transAmount": "10.000",
        "tranStatus": "THANH_CONG",
        "transType": null,
        "transDesc": "BUI THANH PHUONG chuyen FT26013520760781",
        "sourceBankCode": "MM",
        "spendMoneyTransaction": false,
        "displayType": "91",
        "iconUrl": "https://api24cdn.vtmoney.vn/vtm-icon/images/vtm-features/icHisTransfer.png",
        "originalTransHis": null,
        "action": "DEL",
        "viettelBankCode": "MM",
        "fields": null,
        "appExtraInfo": null
      },
      {
        "id": "06c20312-867b-4523-8a9c-70e2e4be3785",
        "processCode": "CT2102",
        "serviceCode": null,
        "requestId": "260107572021636",
        "transactionId": "260107572021636",
        "requestDate": "2026-01-07 17:31:15",
        "transName": "MAT TRAN TO QUOC VN - BAN CUU TRO TW",
        "transAmount": "5.555",
        "tranStatus": "THANH_CONG",
        "transType": "CHUYENTIEN",
        "transDesc": "Ung Ho MTTQVN",
        "sourceBankCode": "VTT",
        "spendMoneyTransaction": true,
        "displayType": "2",
        "iconUrl": "https://api24cdn.vtmoney.vn/vtm-icon/images/vtm-features/icHisTransfer.png",
        "originalTransHis": null,
        "action": "DEL",
        "viettelBankCode": "VTT",
        "fields": null,
        "appExtraInfo": null
      },
      {
        "id": "6d4cc438-dc16-4376-8f09-a12886fc5033",
        "processCode": "900011",
        "serviceCode": "900011",
        "requestId": "260107571796493",
        "transactionId": "260107571796493",
        "requestDate": "2026-01-07 17:29:45",
        "transName": "Nhận tiền liên ngân hàng",
        "transAmount": "5.555",
        "tranStatus": "THANH_CONG",
        "transType": null,
        "transDesc": "GD nhan tien 328176 BUI THANH PHUONG chuyen tien FT26007822825010",
        "sourceBankCode": "VTT",
        "spendMoneyTransaction": false,
        "displayType": "91",
        "iconUrl": "https://api24cdn.vtmoney.vn/vtm-icon/images/vtm-features/ic_nhan_tien_lien_ngan_hang_56.png",
        "originalTransHis": null,
        "action": "DEL",
        "viettelBankCode": "VTT",
        "fields": null,
        "appExtraInfo": null
      },
      {
        "id": "a44c2eda-b4d0-4524-b99e-c691c66f7353",
        "processCode": "CT2102",
        "serviceCode": null,
        "requestId": "251223554656083",
        "transactionId": "251223554656083",
        "requestDate": "2025-12-23 15:26:57",
        "transName": "MAT TRAN TO QUOC VN - BAN CUU TRO TW",
        "transAmount": "2.222",
        "tranStatus": "THANH_CONG",
        "transType": "CHUYENTIEN",
        "transDesc": "Bui Thanh Phuong chuyen tien tu ViettelMoney",
        "sourceBankCode": "VTT",
        "spendMoneyTransaction": true,
        "displayType": "2",
        "iconUrl": "https://api24cdn.vtmoney.vn/vtm-icon/images/vtm-features/icHisTransfer.png",
        "originalTransHis": null,
        "action": "DEL",
        "viettelBankCode": "VTT",
        "fields": null,
        "appExtraInfo": null
      },
      {
        "id": "b64c6315-b2ec-4255-aa25-335f7271fbcc",
        "processCode": "CT2102",
        "serviceCode": null,
        "requestId": "251223554641969",
        "transactionId": "251223554641969",
        "requestDate": "2025-12-23 15:21:28",
        "transName": "BUI THANH PHUONG",
        "transAmount": "2.000",
        "tranStatus": "THANH_CONG",
        "transType": "CHUYENTIEN",
        "transDesc": "Bui Thanh Phuong chuyen tien tu ViettelMoney",
        "sourceBankCode": "VTT",
        "spendMoneyTransaction": true,
        "displayType": "2",
        "iconUrl": "https://api24cdn.vtmoney.vn/vtm-icon/images/vtm-features/icHisTransfer.png",
        "originalTransHis": null,
        "action": "DEL",
        "viettelBankCode": "VTT",
        "fields": null,
        "appExtraInfo": null
      },
      {
        "id": "ae7faee5-9fb8-439f-9d48-af7e770237b7",
        "processCode": "CT2101",
        "serviceCode": null,
        "requestId": "251223554612070",
        "transactionId": "251223554612070",
        "requestDate": "2025-12-23 15:18:55",
        "transName": "BUI THANH PHUONG",
        "transAmount": "2.000",
        "tranStatus": "THANH_CONG",
        "transType": "CHUYENTIEN",
        "transDesc": "naptien1238",
        "sourceBankCode": "VTT",
        "spendMoneyTransaction": true,
        "displayType": "2",
        "iconUrl": "https://api24cdn.vtmoney.vn/vtm-icon/images/vtm-features/icHisTransfer.png",
        "originalTransHis": null,
        "action": "DEL",
        "viettelBankCode": "VTT",
        "fields": null,
        "appExtraInfo": null
      },
      {
        "id": "02e0f4ce-cd76-4092-8cf1-c0b365ced2cf",
        "processCode": "900011",
        "serviceCode": "900011",
        "requestId": "251223554664815",
        "transactionId": "251223554664815",
        "requestDate": "2025-12-23 15:18:05",
        "transName": "Nhận tiền liên ngân hàng",
        "transAmount": "5.000",
        "tranStatus": "THANH_CONG",
        "transType": null,
        "transDesc": "GD nhan tien 665816 BUI THANH PHUONG chuyen tien FT25357158099003",
        "sourceBankCode": "VTT",
        "spendMoneyTransaction": false,
        "displayType": "91",
        "iconUrl": "https://api24cdn.vtmoney.vn/vtm-icon/images/vtm-features/ic_nhan_tien_lien_ngan_hang_56.png",
        "originalTransHis": null,
        "action": "DEL",
        "viettelBankCode": "VTT",
        "fields": null,
        "appExtraInfo": null
      },
      {
        "id": "8e488ad0-c6be-4fe8-81fd-8f183c04fa4a",
        "processCode": "900011",
        "serviceCode": "900011",
        "requestId": "251010510879191",
        "transactionId": "251010510879191",
        "requestDate": "2025-10-10 05:32:45",
        "transName": "Nhận tiền liên ngân hàng",
        "transAmount": "3.000",
        "tranStatus": "THANH_CONG",
        "transType": null,
        "transDesc": "GD nhan tien 096891 BUI THANH PHUONG chuyen tien FT25283498690490",
        "sourceBankCode": "VTT",
        "spendMoneyTransaction": false,
        "displayType": "91",
        "iconUrl": "https://api24cdn.vtmoney.vn/vtm-icon/images/vtm-features/ic_nhan_tien_lien_ngan_hang_56.png",
        "originalTransHis": null,
        "action": "DEL",
        "viettelBankCode": "VTT",
        "fields": null,
        "appExtraInfo": null
      },
      {
        "id": "1ac379fd-846b-47bf-9849-8bba79903958",
        "processCode": "CT2102",
        "serviceCode": null,
        "requestId": "251010510355026",
        "transactionId": "251010510355026",
        "requestDate": "2025-10-10 01:11:31",
        "transName": "BUI THANH PHUONG",
        "transAmount": "2.000",
        "tranStatus": "THANH_CONG",
        "transType": "CHUYENTIEN",
        "transDesc": "NGUYEN THU TRANG bao nuoi thang 10",
        "sourceBankCode": "VTT",
        "spendMoneyTransaction": true,
        "displayType": "2",
        "iconUrl": "https://api24cdn.vtmoney.vn/vtm-icon/images/vtm-features/icHisTransfer.png",
        "originalTransHis": null,
        "action": "DEL",
        "viettelBankCode": "VTT",
        "fields": null,
        "appExtraInfo": null
      },
      {
        "id": "744ee579-2d14-4af0-9443-459746d9ea15",
        "processCode": "CT2200",
        "serviceCode": null,
        "requestId": "251010510414366",
        "transactionId": "251010510414366",
        "requestDate": "2025-10-10 01:09:17",
        "transName": "BUI THANH PHUONG",
        "transAmount": "2.000",
        "tranStatus": "THANH_CONG",
        "transType": "CHUYENTIEN",
        "transDesc": "Bui Thanh Phuong chuyen tien tu ViettelMoney",
        "sourceBankCode": "MM",
        "spendMoneyTransaction": true,
        "displayType": "2",
        "iconUrl": "https://api24cdn.vtmoney.vn/vtm-icon/images/vtm-features/icHisTransfer.png",
        "originalTransHis": null,
        "action": "DEL",
        "viettelBankCode": "MM",
        "fields": null,
        "appExtraInfo": null
      },
      {
        "id": "e6fd2182-eecf-4a5d-828f-4af8d83aa5b8",
        "processCode": "900011",
        "serviceCode": "900011",
        "requestId": "251010510365218",
        "transactionId": "251010510365218",
        "requestDate": "2025-10-10 01:08:24",
        "transName": "Nhận tiền liên ngân hàng",
        "transAmount": "2.000",
        "tranStatus": "THANH_CONG",
        "transType": null,
        "transDesc": "GD nhan tien 961058 BUI THANH PHUONG chuyen tien FT25283320047009",
        "sourceBankCode": "VTT",
        "spendMoneyTransaction": false,
        "displayType": "91",
        "iconUrl": "https://api24cdn.vtmoney.vn/vtm-icon/images/vtm-features/ic_nhan_tien_lien_ngan_hang_56.png",
        "originalTransHis": null,
        "action": "DEL",
        "viettelBankCode": "VTT",
        "fields": null,
        "appExtraInfo": null
      },
      {
        "id": "916986e0-9a31-4cf8-9ac7-a8073e0aa21a",
        "processCode": "CT2102",
        "serviceCode": null,
        "requestId": "251008595940624",
        "transactionId": "251008595940624",
        "requestDate": "2025-10-08 04:22:15",
        "transName": "BUI THANH PHUONG",
        "transAmount": "30.000",
        "tranStatus": "THANH_CONG",
        "transType": "CHUYENTIEN",
        "transDesc": "Bui Thanh Phuong chuyen tien tu ViettelMoney",
        "sourceBankCode": "VTT",
        "spendMoneyTransaction": true,
        "displayType": "2",
        "iconUrl": "https://api24cdn.vtmoney.vn/vtm-icon/images/vtm-features/icHisTransfer.png",
        "originalTransHis": null,
        "action": "DEL",
        "viettelBankCode": "VTT",
        "fields": null,
        "appExtraInfo": null
      }
    ],
    "telcoMmTrans": null,
    "pageIndex": 0,
    "totalPages": 0,
    "filter": {
      "fromDate": "2026-02-05 20:47:55",
      "toDate": "2026-03-07 20:47:54"
    },
    "isEnded": true
  }
}

GETV2

https://thueapibank.vn/historyapiviettelv2/YOUR_TOKEN

Tham số cần thiết

Tham số	Bắt buộc	Mô tả
`YOUR_TOKEN`	Có	Token API được cấp trong trang quản lý.

Code mẫu

curl --request GET \
  "https://thueapibank.vn/historyapiviettelv2/YOUR_TOKEN" \
  --header "Accept: application/json"

<?php
$ch = curl_init('https://thueapibank.vn/historyapiviettelv2/YOUR_TOKEN');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 20,
    CURLOPT_HTTPHEADER => ['Accept: application/json'],
]);
$response = curl_exec($ch);
$data = json_decode($response, true, flags: JSON_THROW_ON_ERROR);
curl_close($ch);

const response = await fetch('https://thueapibank.vn/historyapiviettelv2/YOUR_TOKEN', {
  headers: { Accept: 'application/json' }
});

if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

Response mẫu

{
  "status": "success",
  "message": "Thành công",
  "transactions": [
    {
      "transactionID": 3172,
      "amount": 13000,
      "description": "E4S9J GD 519816-013124 22:29:46",
      "transactionDate": "01/02/2024",
      "type": "IN"
    },
    {
      "transactionID": 3171,
      "amount": 10000,
      "description": "Thanh toan QR E923Z GD 343127-013124 20:40:43",
      "transactionDate": "01/02/2024",
      "type": "OUT"
    }
  ]
}

GETV3Khuyên dùng

https://thueapibank.vn/historyapiviettelv3/PASSWORD/ACCOUNT_NUMBER/YOUR_TOKEN

Tham số cần thiết

Tham số	Bắt buộc	Mô tả
`PASSWORD`	Có	Mật khẩu hoặc mã xác thực kết nối.
`ACCOUNT_NUMBER`	Có	Số tài khoản Viettel Money cần truy vấn.
`YOUR_TOKEN`	Có	Token API được cấp trong trang quản lý.

Code mẫu

curl --request GET \
  "https://thueapibank.vn/historyapiviettelv3/PASSWORD/ACCOUNT_NUMBER/YOUR_TOKEN" \
  --header "Accept: application/json"

<?php
$ch = curl_init('https://thueapibank.vn/historyapiviettelv3/PASSWORD/ACCOUNT_NUMBER/YOUR_TOKEN');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 20,
    CURLOPT_HTTPHEADER => ['Accept: application/json'],
]);
$response = curl_exec($ch);
$data = json_decode($response, true, flags: JSON_THROW_ON_ERROR);
curl_close($ch);

const response = await fetch('https://thueapibank.vn/historyapiviettelv3/PASSWORD/ACCOUNT_NUMBER/YOUR_TOKEN', {
  headers: { Accept: 'application/json' }
});

if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

Response mẫu

{
  "status": "success",
  "message": "Thành công",
  "transactions": [
    {
      "type": "IN",
      "transactionID": "FT26091912345678",
      "amount": 450000,
      "description": "DH1024 THANH TOAN",
      "transactionDate": "2026-09-19 10:24:36"
    }
  ]
}

Response thực tế có thể bổ sung trường riêng của Viettel Money. Luôn kiểm tra trường tồn tại trước khi đọc.

Luồng xử lý khuyến nghị

1
Lưu mã giao dịch
Dùng transactionID làm khóa chống xử lý trùng.
2
Chỉ xử lý tiền vào
Kiểm tra type === "IN" trước khi ghép đơn.
3
Ghép đúng đơn hàng
So khớp số tiền và mã đơn trong nội dung chuyển khoản.
4
Đối soát lại
Chạy tác vụ định kỳ để bù các webhook bị chậm hoặc thất bại.

Câu hỏi về API Viettel Money

API Viettel Money dùng để làm gì?

API giúp lấy dữ liệu giao dịch Viettel Money dạng JSON để xác nhận chuyển khoản, cộng số dư và đối soát tự động.

Nên dùng phiên bản API nào?

Nên ưu tiên phiên bản mới nhất mà tài khoản của bạn đang hỗ trợ. V1 và V2 phù hợp tích hợp bằng token; V3 bổ sung thông tin tài khoản trong đường dẫn.

Có thể nhận giao dịch Viettel Money qua webhook không?

Có. Sau khi thêm tài khoản, bạn có thể cấu hình URL webhook để hệ thống gửi sự kiện giao dịch mới về máy chủ của bạn.

API Viettel Money

Tích hợp giao dịch Viettel Money

Tài liệu API theo phiên bản

Tham số cần thiết

Code mẫu

Response mẫu

Tham số cần thiết

Code mẫu

Response mẫu

Tham số cần thiết

Code mẫu

Response mẫu

Luồng xử lý khuyến nghị

Câu hỏi về API Viettel Money

Tài liệu liên quan