FAQ

Nâng cao Cập nhật: 22/03/2026

Câu hỏi thường gặp

ThueAPI.VN hỗ trợ những ngân hàng nào?

Hiện tại hỗ trợ: Vietcombank (VCB), VietinBank (CTG), Techcombank (TCB), BIDV, ACB, MBBank (MBB), TPBank (TPB). Danh sách sẽ được mở rộng thường xuyên.

Webhook có delay bao lâu?

Thông thường dưới 1-3 giây sau khi giao dịch được xác nhận bởi ngân hàng.

Tôi nhận được webhook trùng lặp, làm sao xử lý?

Đây là hành vi bình thường khi webhook retry. Luôn dùng transactionNumber làm unique key và kiểm tra trước khi xử lý:

<?php
// Dùng INSERT IGNORE hoặc firstOrCreate
Transaction::firstOrCreate(['transaction_number' => $tx['transactionNumber']], $data);

API key có hết hạn không?

API key không có thời hạn, nhưng bạn có thể thu hồi và tạo mới bất kỳ lúc nào trong Dashboard.

Webhook của tôi bị thất bại, có thể gửi lại không?

Có. Vào Dashboard → Webhooks → Lịch sử, tìm webhook thất bại và nhấn Gửi lại. Hệ thống cũng tự động retry 6 lần với exponential backoff.

Có thể test webhook mà không cần server thật không?

Dùng webhook.site hoặc ngrok để expose localhost:

ngrok http 3000
# Dùng URL ngrok làm webhook URL trong Dashboard ThueAPI

Làm sao phân biệt giao dịch nào của đơn hàng nào?

Hướng dẫn khách hàng nhập mã đơn hàng vào nội dung chuyển khoản. Sau đó parse trường content trong webhook. Ví dụ:

<?php
// Tìm mã đơn hàng trong nội dung "Thanh toan DH12345"
if (preg_match('/DH(\d+)/', $tx['content'], $matches)) {
    $orderId = $matches[1];
}

Rate limit 60 req/phút có đủ không?

Đủ cho hầu hết use case. Nếu cần nhiều hơn, liên hệ [email protected] để nâng giới hạn theo gói Enterprise.

Tôi có thể dùng nhiều webhook URL không?

Có. Mỗi tài khoản có thể tạo nhiều webhook với URL, sự kiện, và tài khoản ngân hàng khác nhau.

Liên hệ hỗ trợ

Email: [email protected]
Dashboard: thueapi.vn/dashboard