Tích hợp thanh toán

API thanh toán tiền mã hóa USDT và USDC

Tạo đơn hàng, truy vấn trạng thái thanh toán và xác minh Webhook có chữ ký từ máy chủ. Tích hợp thanh toán bằng ví hoặc chuyển khoản thủ công bằng USDT và USDC.

Các mạng thanh toán hỗ trợ

Không hỗ trợ USDC trên TRON. Tuyến thanh toán phải được bật và có ví nhận đang hoạt động. USDbC, USDC.e và hợp đồng khác không thay thế các tài sản được liệt kê.

USDC do Circle phát hành trên Ethereum, Polygon, Solana và Base. BNB Smart Chain sử dụng Binance-Peg USDC với 18 chữ số thập phân. Đây không phải USDC gốc do Circle phát hành. USDC gốc và USDT được cầu nối trên Base. Khả dụng tùy thuộc tuyến thanh toán đã bật và ví nhận đang hoạt động.

Các bước

Luồng tích hợp API

Phù hợp cho developer tích hợp thanh toán crypto vào SaaS, thành viên, marketplace hoặc checkout riêng.

  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.

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.

Node.js 22+ · USDC / Base
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.

Tích hợp thanh toán

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.