Hướng dẫn tích hợp

Vì sao webhook USDT / USDC 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.

Các bước

Quy trình chẩn đoán retry webhook

Phù hợp cho developer debug đơn USDT / USDC đã completed nhưng callback đầu tiên thất bại.

  1. 01

    Xác nhận đơn đã completed trong BoltUtil.

  2. 02

    So sánh lần gửi lỗi với retry thành công: status, độ trễ, timeout và response body.

  3. 03

    Xác minh HMAC bằng raw body trước khi parse JSON.

  4. 04

    Xử lý idempotent theo external order ID và tx hash, sau đó gửi lại webhook.

BoltUtil kiểm tra thanh toán và gửi callback có chữ ký. Máy chủ của bạn xác minh chữ ký, trạng thái và loại trùng lặp trước khi giao hàng, kích hoạt hoặc ghi có.

Ghi chú tích hợp

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

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 / USDC

Nhận USDT / USDC trên TRC20, ERC20, BEP20, Polygon và Solana 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.

Chẩn đoán retry webhook
timestamp + "." + raw_request_body
→ HMAC_SHA256 with webhook secret
→ Verify timestamp / signature
→ Validate order and payment
→ Persist and deduplicate
→ 2xx response

Ví dụ dành cho tích hợp và kiểm tra. Không gửi yêu cầu. Hãy đối chiếu đơn hàng, cấu hình mạng và tài liệu API.

Đọc tài liệu API

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 / USDC

Nhận USDT / USDC trên TRC20, ERC20, BEP20, Polygon và Solana 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.

Hướng dẫn tích hợp

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

Retry có nghĩa là thanh toán USDT / USDC đượ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.

Mạng nào hỗ trợ USDT và USDC?

TRON chỉ hỗ trợ USDT. Ethereum, BNB Smart Chain, Polygon, Solana và Base dùng phiên bản USDT / USDC được cấu hình. Khả dụng phụ thuộc kênh đang bật và ví của người bán.

Ra mắt luồng thanh toán USDT / USDC 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.