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

Đị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
ERC20	USDC	0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48Sao chép	6
BEP20	USDC	0x8ac76a51cc950d9822d68b83fe1ad97b32cd580dSao chép	18
POLYGON	USDC	0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359Sao chép	6
SOLANA	USDC	EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1vSao chép	6
BASE	USDC	0x833589fcd6edb6e08f4c7c32d4f71b54bda02913Sao chép	6

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

1. 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ủ.
2. 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.
3. 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.
4. 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

Ethereum, Polygon, Solana và Base dùng USDC gốc. BNB Smart Chain dùng Binance-Peg USDC với 18 chữ số thập phân. TRC20 không hỗ trợ USDC. USDbC, USDC.e và hợp đồng khác không thay thế các định danh đã liệt kê.

• ERC20 ở đây là Ethereum mainnet, không phải mọi mạng dùng chuẩn này. Cùng địa chỉ 0x có thể tồn tại trên nhiều mạng EVM; dùng mạng và phiên bản token của đơn. USDC gốc của Circle không thể thay bằng bản cầu nối.

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.

# 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":"USDC","network":"ERC20","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"

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