API Gachthe1s

GT1S API

Tích hợp giao dịch Gachthe1s

Truy vấn giao dịch Gachthe1s qua API để đồng bộ trạng thái nạp tiền và đối soát. Kết nối này phù hợp cho website dịch vụ số, đại lý và cổng nạp tiền.

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

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

<?php
$ch = curl_init('https://thueapibank.vn/historyapigachthe1s/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/historyapigachthe1s/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/historyapigachthe1sv2/YOUR_TOKEN" \
  --header "Accept: application/json"

<?php
$ch = curl_init('https://thueapibank.vn/historyapigachthe1sv2/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/historyapigachthe1sv2/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 Gachthe1s. 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 Thesieure→GTFAPI GachTheFast→