创建收款订单

用于创建一笔固定金额的共享收款订单，系统会返回订单号、收款地址、收银台地址和支付状态。

notifyUrl 为必填字段，平台后续会按订单维度把回调直接投递到这个地址。

POST/openapi/payin/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	是	代币符号，例如 USDT。
merchantOrderNo	string	是	商户订单号。
amount	string	是	收款金额，最多保留 6 位小数。
notifyUrl	string	是	该订单专用的回调通知地址，建议传商户自己的公网 HTTPS 地址。

请求示例

{
  "chainCode": "TRON",
  "tokenSymbol": "USDT",
  "merchantOrderNo": "M202604150001",
  "amount": "100.00",
  "notifyUrl": "https://merchant.example.com/api/uugate/payin-notify"
}

接口返回

字段名称	字段类型	是否必填	说明
orderNo	string	是	平台订单号。
merchantOrderNo	string \| null	是	商户订单号。
bindKey	string \| null	是	独享钱包场景的绑定键；共享收款订单为空。
amount	string \| null	是	订单金额。
paidAmount	string \| null	是	实收金额，未支付时为空。
address	string	是	实际收款地址。
cashierUrl	string	是	收银台完整地址。
paymentUri	string	是	钱包拉起 URI。
expireAt	string \| null	是	订单失效时间。
createdAt	string \| null	是	创建时间。
detectedAt	string \| null	是	检测到付款时间，未检测到时为空。
confirmedAt	string \| null	是	链上确认时间，未确认时为空。
completedAt	string \| null	是	订单完成时间，未完成时为空。
status	string	是	订单状态。

返回示例

{
  "orderNo": "PI1776193200123ABCD1234",
  "merchantOrderNo": "M202604150001",
  "bindKey": null,
  "amount": "100.000000",
  "paidAmount": null,
  "address": "TXYZ3x9nJ5J4xP2gh6mQW7rT31jB8Y2pA9",
  "cashierUrl": "https://open.uugate.com/SK/PI1776193200123ABCD1234",
  "paymentUri": "TRON:TXYZ3x9nJ5J4xP2gh6mQW7rT31jB8Y2pA9?token=USDT&amount=100.000000",
  "expireAt": "2026-04-18T06:30:00.000Z",
  "createdAt": "2026-04-18T06:00:00.000Z",
  "detectedAt": null,
  "confirmedAt": null,
  "completedAt": null,
  "status": "waiting_payment"
}

代码示例

cURL 请求示例

curl -X POST 'https://api.uugate.com/openapi/payin/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",
    "merchantOrderNo": "M202604150001",
    "amount": "100.00",
    "notifyUrl": "https://merchant.example.com/api/uugate/payin-notify"
  }'

说明

共享收款订单在同一商户、同一链、同一币种、同一金额且仍在有效期内时，可能触发 40105 金额占用错误。