付币 API

付币相关接口说明。

创建付币订单

创建一个新的付币订单。

请求

POST /order/api/v2/payout/order

签名要求：此接口需要签名认证。

请求参数

参数	类型	必填	说明
contractId	String	是	付币合约 ID
orderNo	String	是	商户订单号（建议唯一）
recipient	String	是	收款地址
amount	String	是	付币金额
symbol	String	是	代币符号（USDT/USDC）
payoutType	Integer	否	支付类型：1=余额，2=授权，默认 1
fromAddress	String	授权模式必填	授权地址
remark	String	否	备注

请求示例

{
  "contractId": "CONTRACT_001",
  "orderNo": "PAYOUT_20250401_001",
  "recipient": "TR7NHqjeK692FJNHQpJd7cY8x",
  "amount": "100.00",
  "symbol": "USDT",
  "payoutType": 1,
  "remark": "User withdrawal"
}

响应参数

参数	类型	说明
orderNo	String	订单号
orderId	String	订单 ID
status	String	订单状态
createTime	Long	创建时间

订单状态

状态值	说明
SUCCESS	付币成功
REFUSE	付币被拒绝

查询付币订单

查询付币订单详情。

请求

GET /order/api/v2/payout/detail

请求参数

参数	类型	必填	说明
orderNo	String	是	商户订单号

响应参数

参数	类型	说明
orderNo	String	订单号
contractId	String	合约 ID
recipient	String	收款地址
amount	String	付币金额
symbol	String	代币符号
payoutType	Integer	支付类型
txId	String	链上交易哈希
status	String	订单状态
fee	String	手续费
gasAmount	String	Gas 消耗
createTime	Long	创建时间
updateTime	Long	更新时间

批量创建付币订单

批量创建付币订单。

请求

POST /order/api/v2/payout/batch

请求参数

参数	类型	必填	说明
contractId	String	是	付币合约 ID
orders	Array	是	订单列表
orders[].orderNo	String	是	商户订单号
orders[].recipient	String	是	收款地址
orders[].amount	String	是	付币金额
orders[].symbol	String	是	代币符号
payoutType	Integer	否	支付类型

请求示例

{
  "contractId": "CONTRACT_001",
  "payoutType": 1,
  "orders": [
    {
      "orderNo": "PAYOUT_001",
      "recipient": "TR7NHqjeK692FJNHQpJd7cY8x",
      "amount": "50.00",
      "symbol": "USDT"
    },
    {
      "orderNo": "PAYOUT_002",
      "recipient": "TR7NHqjeK692FJNHQpJd7cY8x",
      "amount": "30.00",
      "symbol": "USDT"
    }
  ]
}

响应参数

参数	类型	说明
successCount	Integer	成功数量
failCount	Integer	失败数量
orders	Array	订单结果列表