Tích hợp thanh toán stablecoin trên Base

Đị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
BASE	USDT	0xfde4c96c8593536e31f229ea8f37b2ada2699bb2Sao 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

• Base mainnet có chain ID 8453, không dùng Base Sepolia. Người bán cấu hình ví; quản trị viên quản lý RPC và bật mạng. USDC gốc Circle, USDT là bản cầu nối cấu hình sẵn; không gồm USDbC. Quét theo độ cao an toàn L1-finalized: chuyển trước khi hết đếm ngược, xác nhận có thể đến sau và không có thời gian cố định. Kiểm tra phiên bản WooCommerce đã cài và mạng, loại tiền hỗ trợ.

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":"USDT","network":"BASE","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