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

Tích hợp thanh toán stablecoin trên BNB Smart Chain

Kiểm tra định danh token, tham số và xác nhận trên BNB Smart Chain. Thanh toán toàn bộ số tiền API trả về.

Đị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
BEP20	USDT	0x55d398326f99059fF775485246999027B3197955	18
BEP20	USDC	0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d	18

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

BEP20 là BNB Smart Chain mainnet, không phải Ethereum. USDT và USDC cấu hình sẵn có 18 chữ số thập phân của token, khác độ chính xác phân biệt đơn. USDC là Binance-Peg, không phải bản gốc Circle.

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":"BEP20","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.