API Thesieure

TSR API

Tích hợp giao dịch Thesieure

API lịch sử Thesieure cho các hệ thống nạp tiền và xử lý giao dịch cổng thẻ tự động. Kết nối này phù hợp cho đại lý dịch vụ số và website nạp tiền tự động.

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 Thesieure để xem tham số và dữ liệu trả về.

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

<?php
$ch = curl_init('https://thueapibank.vn/historyapithesieure/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/historyapithesieure/YOUR_TOKEN', {
  headers: { Accept: 'application/json' }
});

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

{
  "status": true,
  "msg": "Thành công",
  "tranList": [
    {
      "transId": "04042024063548",
      "type": 1,
      "amount": "15600",
      "username": "shinsad000",
      "status": "Thành công",
      "description": "BL1396"
    },
    {
      "transId": "03042024194714",
      "type": 1,
      "amount": "44000",
      "username": "bqkhanh35",
      "status": "Thành công",
      "description": "ZI7534"
    },
    {
      "transId": "03042024184700",
      "type": 1,
      "amount": "50000",
      "username": "mochi_saur12",
      "status": "Thành công",
      "description": "RZ6172"
    }
  ]
}

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

<?php
$ch = curl_init('https://thueapibank.vn/historyapithesieurev2/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/historyapithesieurev2/YOUR_TOKEN', {
  headers: { Accept: 'application/json' }
});

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

{
  "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 Thesieure. Luôn kiểm tra trường tồn tại trước khi đọc.

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

1. 1
   Lưu mã giao dịch

   Dùng transactionID làm khóa chống xử lý trùng.

2. 2
   Chỉ xử lý tiền vào

   Kiểm tra type === "IN" trước khi ghép đơn.

3. 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. 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.

Tài liệu liên quan

API Gachthe1s→GTFAPI GachTheFast→