跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.xpaylabs.com/llms.txt

Use this file to discover all available pages before exploring further.

创建一个新的付款订单，从您的网关管理的钱包向外部区块链地址发送资金。网关在处理前会验证收款地址的格式是否与指定链匹配。

​
请求

POST http://your-gateway:3010/v1/order/createPayout

​
请求头

头部值
Content-Typeapplication/json

​
请求体参数（data 字段）

​
amount
string
必填
付款金额，十进制字符串格式，例如 "50.00"。必须大于零。
​
symbol
string
必填
要发送的代币符号，例如 "USDT"。必须是指定链上支持的代币。
​
chain
string
必填
付款的区块链网络。必须与收款地址的网络匹配：
  • TRON — TRC20
  • ETH — ERC20
  • BSC — BEP20
  • POLYGON — Polygon
  • AVAX_C_CHAIN — Avalanche
  • SUI — SUI Network
​
receiveAddress
string
必填
目标区块链地址。网关会验证地址格式是否与指定链匹配。示例：TRON 地址 "TWkKZkmuB8DpVeiMoHiKf99ZoFHzk73CqR" 或 EVM 地址 "0x..."。
​
orderId
string
您的唯一订单标识符。V3 商家必填。
​
uid
string
您的内部用户标识符。V2 商家必填。不能为 "0"。

​
cURL

curl -X POST http://your-gateway:3010/v1/order/createPayout \
  -H "Content-Type: application/json" \
  -d '{
    "sign": "a1b2c3d4e5f6...",
    "timestamp": 1717000000,
    "nonce": "550e8400-e29b-41d4-a716-446655440000",
    "data": {
      "amount": "50.00",
      "symbol": "USDT",
      "chain": "TRON",
      "receiveAddress": "TWkKZkmuB8DpVeiMoHiKf99ZoFHzk73CqR",
      "orderId": "payout_001"
    }
  }'

​
响应

成功的请求返回 HTTP 200，带 R<PaymentAddress> 信封。

​
PaymentAddress 对象

​
address
string
付款的源地址。
​
amount
string
付款金额，与请求金额一致。
​
symbol
string
代币符号。
​
chain
string
区块链网络。
​
orderId
string
您的订单标识符，从请求中原样返回。
​
expiredTime
integer
此付款请求过期的 Unix 时间戳。

​
示例响应

{
  "code": 200,
  "msg": "success",
  "data": {
    "address": "TWkKZkmuB8DpVeiMoHiKf99ZoFHzk73CqR",
    "amount": "50.00",
    "symbol": "USDT",
    "chain": "TRON",
    "orderId": "payout_001",
    "expiredTime": 1717086400
  }
}

​
错误响应

码消息原因
400"The receiveAddress cannot be left blank."receiveAddress 缺失或为空
400"ReceiveAddress error"地址格式对指定链无效
400"The amount cannot be left blank."amount 缺失
400"The symbol cannot be left blank."symbol 缺失
400"The chain cannot be left blank."chain 缺失
付款会从您的网关钱包中转移真实资金。在提交付款请求前，请始终验证收款地址。区块链交易不可逆转。
Last modified on May 31, 2026