创建代付订单

用于创建一笔代付订单。成功后平台会先冻结待付金额和网络费，并返回完整订单详情。

如果不传 fromAddress，系统会自动选择满足余额条件的可用付款地址；没有满足余额条件的地址时会返回地址余额不足。

POST/openapi/payout/orders

请求头

字段名称	字段类型	是否必填	说明
x-api-key	string	是	商户 API Key，使用商户后台 API 接入页面中的 mch_ 开头字符串。
x-merchant-uid	string	是	商户 UID。
x-timestamp	string	是	13 位毫秒时间戳，默认允许和服务器时间相差 5 分钟。
x-nonce	string	是	每次请求唯一的随机字符串，最长 128 位，重复使用会被拒绝。
x-signature	string	是	使用 HMAC-SHA256 生成的十六进制签名，签名原文由 Merchant UID、时间戳、nonce、请求方法、路径、规范化 query 和规范化 body 组成。

接口参数

字段名称	字段类型	是否必填	说明
chainCode	string	是	链编码，支持 TRON / BSC / SOL。
tokenSymbol	string	是	代币符号。
fromAddress	string	否	指定付款地址；不传时系统自动分派。
toAddress	string	是	收款地址。
amount	string	是	代付金额，最多保留 6 位小数。
deleteSourceAfterSuccess	boolean	否	可选 JSON boolean，默认 false。true 仅本笔链上确认成功后软删除来源地址，失败或取消不删除。付款不强制预留余额。
merchantOrderNo	string	是	商户侧订单号。
notifyUrl	string	是	该订单专用的回调通知地址，建议传商户自己的公网 HTTPS 地址。

请求示例

{
  "chainCode": "TRON",
  "tokenSymbol": "USDT",
  "fromAddress": "TNjBrNq2a9FK2vwu4W9C1QdLKSZ42Yx5YY",
  "toAddress": "TS7b7iD8G2PaPqK1TqSmLJ9nrrYH4oKX1S",
  "amount": "35.50",
  "deleteSourceAfterSuccess": false,
  "merchantOrderNo": "PO202604150001",
  "notifyUrl": "https://merchant.example.com/api/uugate/payout-notify"
}

接口返回

字段名称	字段类型	是否必填	说明
orderNo	string	是	平台代付订单号。
merchantOrderNo	string \| null	是	商户订单号。
fromAddress	string \| null	是	实际付款地址。
toAddress	string	是	收款地址。
amount	string	是	代付金额。
txHash	string \| null	是	已广播时返回链上哈希。
status	string	是	submitted / broadcasted / confirmed / failed。
submittedAt	string \| null	是	提交时间。
broadcastedAt	string \| null	是	广播时间。
confirmedAt	string \| null	是	确认时间。
failedAt	string \| null	是	失败时间。
createdAt	string \| null	是	创建时间。

返回示例

{
  "orderNo": "PO1776193200A1B2C3D4",
  "merchantOrderNo": "PO202604150001",
  "fromAddress": "TNjBrNq2a9FK2vwu4W9C1QdLKSZ42Yx5YY",
  "toAddress": "TS7b7iD8G2PaPqK1TqSmLJ9nrrYH4oKX1S",
  "amount": "35.500000",
  "txHash": "b3d4fb0cb11eb86bb906d1e0ee3b84e17f40d5441d1e4c651ea46920a48a9a01",
  "status": "broadcasted",
  "submittedAt": "2026-04-15T03:00:00Z",
  "broadcastedAt": "2026-04-15T03:00:08Z",
  "confirmedAt": null,
  "failedAt": null,
  "createdAt": "2026-04-15T03:00:00Z"
}

代码示例

cURL 请求示例

curl -X POST 'https://api.uugate.com/openapi/payout/orders' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: mch_xxxxxxxxxxxxxxxxxxxx' \
  -H 'x-merchant-uid: 880001' \
  -H 'x-timestamp: 1776193200000' \
  -H 'x-nonce: 2f5c7b147c3748f0a8b3d9bb38aa91a4' \
  -H 'x-signature: <SIGNATURE_HEX>' \
  -d '{
    "chainCode": "TRON",
    "tokenSymbol": "USDT",
    "fromAddress": "TNjBrNq2a9FK2vwu4W9C1QdLKSZ42Yx5YY",
    "toAddress": "TS7b7iD8G2PaPqK1TqSmLJ9nrrYH4oKX1S",
    "amount": "35.50",
    "deleteSourceAfterSuccess": false,
    "merchantOrderNo": "PO202604150001",
    "notifyUrl": "https://merchant.example.com/api/uugate/payout-notify"
  }'

说明

公开 API 只提供单笔付款；批量付款仅在商户后台使用。
付款 10 时来源可用余额至少需要 10，不额外预留余额，与 deleteSourceAfterSuccess 的取值无关。付款金额不会自动扣减，费用账户仍须足额支付网络费。
该参数应传 true / false，不接受字符串。同一 merchantOrderNo 重试必须保持参数一致；存在其他未完成转账时不能选择删除来源。
广播或创建成功不等于链上确认成功。软删除保留历史订单、账目及密钥引用，失败或取消不删除。
创建接口会自动尝试提交链上；请以返回或后续查询中的 status 判断结果，不要把 HTTP 2xx 当作链上成功。