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

Vì sao đơn USDT / USDC vẫn pending sau khi khách đã thanh toán

Giao dịch blockchain thành công chưa chắc đơn merchant nên hoàn tất. Hãy kiểm tra mismatch thanh toán hoặc lỗi xử lý webhook.

Các bước

Quy trình xử lý USDT / USDC pending

Phù hợp cho support và vận hành điều tra đơn USDT / USDC đã trả nhưng vẫn pending.

  1. 01

    PENDING: chưa ghi nhận khoản thanh toán khớp; kiểm tra đơn gốc và tiến độ quét.

  2. 02

    PAID: đã ghi nhận thanh toán, đang chờ đủ xác nhận theo yêu cầu của mạng.

  3. 03

    CONFIRMED: thanh toán đã đáp ứng điều kiện xác nhận; kiểm tra giao Webhook và phản hồi của máy chủ người bán.

  4. 04

    COMPLETED: đầu nhận Webhook đã trả phản hồi 2xx. Kiểm tra riêng việc giao hàng hoặc ghi có trong ứng dụng của bạn.

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

Trạng thái thanh toán và thông báo

CONFIRMED là thanh toán đã xác nhận. COMPLETED chỉ có sau phản hồi 2xx từ đầu nhận Webhook; không chứng minh ứng dụng đã giao hàng.

6 mạng thanh toán

TRON, Ethereum, BNB Smart Chain, Polygon PoS, Solana, Base. TRON chỉ hỗ trợ USDT. Ethereum, Polygon, Solana và Base hỗ trợ USDC gốc; BNB Smart Chain dùng Binance-Peg USDC. USDT trên Base là Bridged USDT. Checkout chỉ hiển thị cặp mạng/token đã bật và có ví nhận hợp lệ của người bán. Kiểm tra hợp đồng hoặc mint được cấu hình, không chỉ ký hiệu token.

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.

Checklist thanh toán pending
PENDING     No matched payment recorded
PAID        Payment recorded, awaiting confirmation
CONFIRMED   Payment confirmed, inspect callbacks
COMPLETED   Callback received a successful response

Check your own fulfillment records separately.

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

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

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

Vì sao giao dịch đã thành công nhưng đơn vẫn pending?

Thông thường giao dịch không khớp mạng, hợp đồng USDT / USDC, địa chỉ nhận, số tiền chính xác, số xác nhận hoặc thời hạn của đơn.

Nếu BoltUtil hiển thị completed nhưng app của tôi chưa cập nhật thì sao?

Hãy kiểm tra log webhook, mã phản hồi, xác minh chữ ký và logic xử lý đơn của merchant trước khi gửi lại webhook.

Những mạng và phiên bản token nào được hỗ trợ?

TRON, Ethereum, BNB Smart Chain, Polygon PoS, Solana, Base. TRON chỉ hỗ trợ USDT. Ethereum, Polygon, Solana và Base hỗ trợ USDC gốc; BNB Smart Chain dùng Binance-Peg USDC. USDT trên Base là Bridged USDT. Checkout chỉ hiển thị cặp mạng/token đã bật và có ví nhận hợp lệ của người bán. Kiểm tra hợp đồng hoặc mint được cấu hình, không chỉ ký hiệu token.

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.