创建 USDT 支付订单

创建订单 API 会返回 Checkout URL、收款地址、精确金额、二维码数据和过期时间。

适用于: 商户订单号
适用于: 精确金额
适用于: Checkout URL

创建订单请求

POST /api/v1/order/create
X-Bolt-Key: bt_live_xxx
Content-Type: application/json

{
  "externalOrderId": "ORDER_2026_001",
  "amount": 199.00,
  "currency": "USDT",
  "network": "TRC20",
  "notifyUrl": "https://merchant.com/webhooks/boltutil",
  "returnUrl": "https://merchant.com/orders/001"
}

创建订单清单

当您的应用需要发起一次客户支付会话时使用这个接口。

01
生成唯一的商户订单号。
02
提交金额、币种、网络、notifyUrl 和 returnUrl。
03
展示返回的 Checkout URL 或付款信息。
04
收到签名 Webhook 后再履约订单。

非托管结算

资金直接进入您配置的商户钱包。BoltUtil 只负责监听链上交易和发送通知，不接触也不托管用户资金。

三条 USDT 网络

通过同一套订单 API 和统一 Webhook，接入 TRC20、ERC20、BEP20 三条主流 USDT 网络。

Webhook 自动化

当链上交易被检测并确认后，您的系统会收到带签名的回调，可自动发货、开通会员或入账。

接入要点

上线前真正重要的细节

The external order ID is your reconciliation anchor

Use a stable ID from your own system so support, accounting, webhook logs, and status queries all point to the same business order.

Metadata keeps fulfillment context close to the payment

Attach plan, SKU, user ID, or invoice metadata so webhook handlers can update the right local entity without fragile lookups.

Order expiry prevents ambiguous late payments

A visible expiration window makes it easier to explain unmatched transfers and decide whether a late transfer should be handled manually.

上线前商户常问的问题

这些回答帮助开发者、创始人和客服团队在接收真实 USDT 付款前理解完整支付生命周期。

BoltUtil 会托管商户资金吗？ +

不会。BoltUtil 是非托管的链上监听与通知层，商户配置自己的收款钱包，资金直接到商户钱包。

BoltUtil 如何匹配一笔付款？ +

系统会同时校验网络、收款地址、精确 USDT 金额、订单状态和订单有效期，然后才会更新订单。

目前支持哪些 USDT 网络？ +

当前生产重点支持 TRC20、ERC20 和 BEP20。

上线更清晰的 USDT 收款流程

创建订单、监听转账并通知您的后端，不再要求客户发送付款截图。

创建免费账户