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

Cách chấp nhận thanh toán USDT / USDC trên trang web bằng Node.js

Việc thanh toán USDT / USDC sản xuất cần nhiều hơn một địa chỉ ví. Tạo đơn đặt hàng từ Node.js, trả lại dữ liệu thanh toán cho trình duyệt, sau đó chỉ thực hiện sau khi webhook thanh toán trực tuyến đã được xác minh.

Các bước

Việc thanh toán USDT / USDC sản xuất cần nhiều hơn một địa chỉ ví. Tạo đơn đặt hàng từ Node.js, trả lại dữ liệu thanh toán cho trình duyệt, sau đó chỉ thực hiện sau khi webhook thanh toán trực tuyến đã được xác minh.

Cách chấp nhận thanh toán USDT / USDC trên trang web bằng Node.js

  1. 01

    Tạo đơn thanh toán với số tiền, mạng, mã đơn hàng và URL quay lại.

  2. 02

    Hiển thị địa chỉ ví, mã QR, trang checkout và số USDT / USDC chính xác cho người mua.

  3. 03

    BoltUtil quét chuyển khoản TRC20, ERC20, BEP20, Polygon hoặc Solana và đối chiếu theo mạng, địa chỉ, số tiền.

  4. 04

    Sau khi giao dịch được xác nhận on-chain, BoltUtil gửi webhook có chữ ký kèm tx hash và trạng thái.

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

Thanh toán không lưu ký

Tiền vào thẳng ví của merchant. BoltUtil chỉ giám sát blockchain và gửi thông báo.

Sáu mạng thanh toán

TRON, Ethereum, BNB Smart Chain, Polygon, Solana và Base. TRON chỉ hỗ trợ USDT / USDC; các tuyến USDT / USDC khác cần tài sản được bật và ví nhận hợp lệ.

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.

Node.js 22+ · USDC / Base checkout
import crypto from 'node:crypto'

// Node.js 20+ server module. Call only after authenticating the buyer.
// order must come from your database, with ownership and price checked.
// Never pass req.body directly; persist externalOrderId before calling.
export async function createStablecoinCheckout(order) {
  const key = process.env.BOLTUTIL_API_KEY
  const secret = process.env.BOLTUTIL_API_SECRET
  if (!key || !secret) throw new Error('Missing server credentials')

  const payload = JSON.stringify({
    externalOrderId: order.externalOrderId,
    amount: order.amount,
    currency: 'USDC',
    network: 'BASE',
    notifyUrl: 'https://merchant.com/webhooks/boltutil',
    returnUrl: 'https://merchant.com/orders/complete'
  })
  const timestamp = Date.now().toString()
  const signature = crypto.createHmac('sha256', secret)
    .update(`${timestamp}.${payload}`).digest('hex')

  // A timeout does not prove creation failed. Query order/status using
  // the SAME externalOrderId before deciding whether to retry.
  const response = await fetch('https://api.boltutil.com/api/v1/order/create', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-Bolt-Key': key,
      'X-Bolt-Timestamp': timestamp,
      'X-Bolt-Signature': signature
    },
    body: payload,
    signal: AbortSignal.timeout(10000)
  })
  const result = await response.json()
  if (!response.ok || result.code !== 200 || !result.data?.checkoutUrl) {
    throw new Error('Create order failed; reconcile the saved order')
  }
  // Save result.data on the server. Return only checkout data to the buyer.
  return result.data
}

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

Thanh toán không lưu ký

Tiền vào thẳng ví của merchant. BoltUtil chỉ giám sát blockchain và gửi thông báo.

Ba mạng USDT / USDC

Nhận USDT / USDC trên TRC20, ERC20, BEP20, Polygon và Solana bằng một API tạo đơn và một webhook payload thống nhất.

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.

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

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

BoltUtil có giữ tiền của merchant không?

Không. BoltUtil là lớp giám sát và thông báo không lưu ký. Merchant cấu hình ví nhận tiền của riêng mình.

BoltUtil đối chiếu thanh toán như thế nào?

Hệ thống kiểm tra mạng, địa chỉ nhận, số USDT / USDC chính xác, trạng thái đơn và thời gian hết hạn.

Mạng nào hỗ trợ USDT và USDC?

TRON chỉ hỗ trợ USDT. Ethereum, BNB Smart Chain, Polygon, Solana và Base dùng phiên bản USDT / USDC được cấu hình. Khả dụng phụ thuộc kênh đang bật và ví của người bán.

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.