Cách debug thanh toán USDT không khớp đơn hàng

Giao dịch blockchain thành công vẫn có thể không đáp ứng quy tắc của đơn. Hãy so sánh dữ liệu on-chain với đơn trước khi xử lý thủ công.

Phù hợp cho
Kiểm tra tx hash
Phù hợp cho
Quy tắc matching
Phù hợp cho
Luồng support
Checklist thanh toán không khớp
USDT payment did not match an order

Start with the tx hash:
1. Open the correct explorer for TRC20, ERC20, or BEP20
2. Confirm the transfer is a successful USDT Transfer
3. Compare network, token contract, destination, and amount
4. Check order status, expiration time, and confirmations
5. Search whether the tx hash already completed another order
6. If chain facts match, inspect scanner lag and webhook logs

Quy trình xử lý USDT không khớp đơn

Phù hợp cho support và developer điều tra khách đã trả USDT nhưng đơn vẫn pending.

  1. 01

    Lấy tx hash và xác định mạng khách thật sự dùng.

  2. 02

    Xác minh đó là USDT Transfer thành công từ hợp đồng đã cấu hình.

  3. 03

    So sánh địa chỉ, số tiền chuẩn hóa, xác nhận, trạng thái và thời hạn.

  4. 04

    Kiểm tra tx hash trùng, tiến độ scanner và log webhook trước khi completed thủ công.

Thanh toán không lưu ký

Tiền vào thẳng ví của merchant. BoltUtil chỉ giám sát blockchain và gửi thông báo.

Ba mạng USDT

Nhận USDT trên TRC20, ERC20 và BEP20 bằng một API tạo đơn và một webhook payload thống nhất.

Tự động hóa bằng webhook

Khi khoản thanh toán được phát hiện và xác nhận, backend của bạn nhận callback có chữ ký để xử lý đơn.

Ghi chú tích hợp

Điều quan trọng trước production

The wrong network is still a real payment

A customer may successfully send TRC20 USDT while the order expects ERC20. The chain transaction succeeded, but it should not complete that order.

Expired orders need policy, not guesswork

If a customer pays after expiration, the system should follow a consistent refund, manual review, or credit policy rather than silently completing old orders.

Scanner lag and webhook failure are different incidents

If no order is completed, inspect scanner progress. If the order is completed but the merchant app is stale, inspect webhook delivery.

Câu hỏi trước khi chạy production

Các câu trả lời này giúp developer, founder và đội support hiểu vòng đời thanh toán trước khi nhận USDT thật.

Vì sao giao dịch USDT thành công nhưng không khớp đơn? +

Có thể sai mạng, sai hợp đồng, sai địa chỉ, sai số tiền, thanh toán sau khi hết hạn, chưa đủ xác nhận hoặc tx hash đã được xử lý.

Support có nên tự completed đơn không? +

Chỉ sau khi xác minh dữ liệu on-chain và quy tắc nội bộ. Luôn lưu tx hash và đảm bảo xử lý idempotent.

Nếu BoltUtil completed nhưng app chưa cập nhật thì sao? +

Thường là lỗi webhook hoặc xử lý phía merchant. Kiểm tra log và gửi lại sau khi sửa endpoint.

Tài nguyên liên quan

Ra mắt luồng thanh toán USDT rõ ràng hơn

Tạo đơn, giám sát chuyển khoản và thông báo backend mà không cần yêu cầu khách gửi ảnh chụp thanh toán.

Tạo tài khoản miễn phí