API GachTheFast

GTF API

Tích hợp giao dịch GachTheFast

API GachTheFast giúp tự động lấy giao dịch cổng thẻ và đưa vào luồng xử lý của website. Kết nối này phù hợp cho dịch vụ số, đại lý thẻ và hệ thống cộng số dư.

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

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

<?php
$ch = curl_init('https://thueapibank.vn/historyapigachthefast/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/historyapigachthefast/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"
    }
  ]
}

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

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