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.
Vì sao webhook USDT có thể chỉ thành công sau khi retry
Khi thanh toán đã completed nhưng app merchant chỉ cập nhật ở lần retry, vấn đề thường nằm ở endpoint, xác minh chữ ký, timeout hoặc xử lý đơn chưa idempotent.
- Phù hợp cho
- Retry webhook
- Phù hợp cho
- Debug callback
- Phù hợp cho
- Xử lý idempotent
Chẩn đoán retry webhook
Webhook retry diagnosis
1. Confirm the order status is already completed
2. Open the webhook delivery log for the order
3. Check first attempt HTTP status, timeout, and response body
4. Verify raw body signature before parsing JSON
5. Make fulfillment idempotent by order ID and tx hash
6. Fix the endpoint, then resend or wait for the next retryQuy trình chẩn đoán retry webhook
Phù hợp cho developer debug đơn USDT đã completed nhưng callback đầu tiên thất bại.
- 01
Xác nhận đơn đã completed trong BoltUtil.
- 02
So sánh lần gửi lỗi với retry thành công: status, độ trễ, timeout và response body.
- 03
Xác minh HMAC bằng raw body trước khi parse JSON.
- 04
Xử lý idempotent theo external order ID và tx hash, sau đó gửi lại webhook.
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 first attempt often exposes a cold path
Cold serverless functions, sleeping containers, DNS delays, or lazy database connections can make the first webhook exceed the timeout while the retry succeeds.
Signature validation must use the raw body
If middleware parses, formats, or reorders JSON before HMAC verification, the first callback may be rejected even though the payload is valid.
A retry is expected behavior, not a duplicate payment
Merchants should store processed order IDs and transaction hashes, then return a successful response for already-processed callbacks.
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.
Retry có nghĩa là thanh toán USDT được phát hiện muộn không? +
Không nhất thiết. Nếu đơn đã completed, scanner đã hoạt động; retry thường là vấn đề gửi callback.
Webhook endpoint nên trả về gì? +
Trả về 2xx sau khi xác minh chữ ký và ghi nhận sự kiện bền vững. Tránh redirect và tác vụ chặn quá lâu.
Làm sao tránh xử lý trùng? +
Lưu external order ID và tx hash đã xử lý; callback hợp lệ lặp lại nên trả về thành công nhưng không giao hàng hai lần.
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í