Tài liệu nhà phát triển

Hướng dẫn tích hợp thanh toán USDT

Nhận USDT trên sáu mạng. Kiểm tra phiên bản token, hợp đồng hoặc Mint và số chữ số thập phân được hỗ trợ trước khi tạo đơn có chữ ký và xử lý xác nhận.

Định danh token được hỗ trợ trên mạng chính

Hợp đồng và Mint là giá trị cấu hình sẵn, không phải trạng thái kênh trực tiếp. Tạo đơn cần mạng và tài sản đã bật cùng ví người bán hợp lệ. Luôn chuyển đến payment.address từ API, không chuyển đến hợp đồng hoặc Mint.

Định danh token được hỗ trợ trên mạng chính
Mạng	Loại tiền	Hợp đồng / Mint	Số chữ số thập phân của token
TRC20	USDT	TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t	6
ERC20	USDT	0xdAC17F958D2ee523a2206206994597C13D831ec7	6
BEP20	USDT	0x55d398326f99059fF775485246999027B3197955	18
POLYGON	USDT	0xc2132D05D31c914a87C6611C10748AEb04B58e8F	6
SOLANA	USDT	Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB	6
BASE	USDT	0xfde4c96c8593536e31f229ea8f37b2ada2699bb2	6

Thiết lập của người bán

Cấu hình ví nhận của mạng và Webhook đã bật với URL và khóa. Chỉ lưu API Key và khóa HMAC trên máy chủ.
Kiểm tra tổ hợp network / currency có khả dụng. Quản trị viên quản lý RPC, mạng và tài sản; người bán không cần triển khai bộ quét.
Hiển thị payment.amount, payment.address, currency, network và hạn từ phản hồi. Dữ liệu QR không phải hình ảnh.
Xác minh chữ ký, loại trùng và lưu bền vững sự kiện trước khi trả HTTP 2xx. Xử lý giao hàng bảo đảm tính lũy đẳng.

Lưu ý về mạng và tài sản

Mạng

USDT được hỗ trợ trên sáu mạng. Token được cấu hình trên BNB Smart Chain dùng 18 chữ số thập phân; năm mạng còn lại dùng 6. Điều này khác với độ chính xác số tiền đơn hàng. Base dùng USDT qua cầu nối đã cấu hình; BoltUtil không chuyển tiền giữa các mạng. Chọn đúng mạng của đơn và phiên bản token được liệt kê: cùng ký hiệu hoặc địa chỉ không có nghĩa mạng hay token có thể thay thế nhau.

TRC20 là mã API của TRON, chỉ hỗ trợ USDT, không dùng currency=USDC. USDT có 6 chữ số thập phân của token; giữ nguyên số tiền API trả về. Xác nhận theo cấu hình và kết quả quét, không bảo đảm số giây cố định.

Ví dụ yêu cầu có chữ ký và phản hồi

25.00 là số tiền minh họa. Dùng số tiền thực của đơn và đáp ứng mức tối thiểu của tài sản. Địa chỉ, đơn và mã băm là ví dụ. cURL / Java đã sao chép sẽ gửi yêu cầu: cấu hình khóa của bạn trước khi chạy.

create / cURL

# Run against your account only when ready; this sends an API request.
: "${BOLTUTIL_API_KEY:?Set your complete API Key}"
: "${BOLTUTIL_WEBHOOK_SECRET:?Set your Webhook secret}"
timestamp=$(python3 -c 'import time; print(int(time.time()*1000))')
body='{"amount":"25.00","currency":"USDT","network":"TRC20","externalOrderId":"INV-20260209-99281"}'
signature=$(printf '%s.%s' "$timestamp" "$body" | openssl dgst -sha256 -hmac "$BOLTUTIL_WEBHOOK_SECRET" | awk '{print $NF}')

curl --request POST "https://api.boltutil.com/api/v1/order/create" \
  --header 'Content-Type: application/json' \
  --header "X-Bolt-Key: $BOLTUTIL_API_KEY" \
  --header "X-Bolt-Timestamp: $timestamp" \
  --header "X-Bolt-Signature: $signature" \
  --data-binary "$body"

Địa chỉ, băm giao dịch và đơn đặt hàng là ví dụ. Thay thế chúng bằng bài kiểm tra data của riêng bạn.

Base URL

PROD

https://api.boltutil.com

Đầy đủ tham số đơn →

Xác nhận và xử lý thông báo

Phát hiện không phải xác nhận. Dùng trạng thái và callback đã xác minh: PAID vẫn chờ xác nhận. CONFIRMED / COMPLETED có thể do chấp nhận thủ công; kiểm tra paidAmount, shortfallAmount, settlementType. COMPLETED không chứng minh đã giao hàng.

Câu hỏi tích hợp

Loại tiền được hỗ trợ có đang khả dụng không?

Chưa chắc. Mạng và tài sản phải được bật, với ví và Webhook hợp lệ. Bảng tĩnh không thể hiện trạng thái trực tiếp.

Khách có được làm tròn số tiền không?

Thanh toán đầy đủ payment.amount. Hệ thống có thể làm tròn lên và thêm phần chênh nhỏ để phân biệt các đơn dùng chung ví. Không tự làm tròn hoặc cắt bớt.

Có thể giao hàng ngay khi số dư tăng không?

Xác minh kết quả đơn đã xác nhận và tính xác thực của thông báo. Sai mạng, phiên bản token, số tiền và sự kiện trùng cần xử lý. Số dư tăng không thay thế kết quả thanh toán đơn.