创建付款订单 | POST /v1/order/createPayout

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

请求

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

请求头

头部	值
`Content-Type`	`application/json`

请求体参数（`data` 字段）

string

必填

付款金额，十进制字符串格式，例如 "50.00"。必须大于零。

string

必填

要发送的代币符号，例如 "USDT"。必须是指定链上支持的代币。

string

必填

付款的区块链网络。必须与收款地址的网络匹配：

TRON — TRC20
ETH — ERC20
BSC — BEP20
POLYGON — Polygon
AVAX_C_CHAIN — Avalanche
SUI — SUI Network

string

必填

目标区块链地址。网关会验证地址格式是否与指定链匹配。示例：TRON 地址 "TWkKZkmuB8DpVeiMoHiKf99ZoFHzk73CqR" 或 EVM 地址 "0x..."。

string

您的唯一订单标识符。V3 商家必填。

string

您的内部用户标识符。V2 商家必填。不能为 "0"。

cURL

curl -X POST http://your-gateway:180/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 对象

string

付款的源地址。

string

付款金额，与请求金额一致。

string

代币符号。

string

区块链网络。

string

您的订单标识符，从请求中原样返回。

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` 缺失

付款会从您的网关钱包中转移真实资金。在提交付款请求前，请始终验证收款地址。区块链交易不可逆转。

概述

订单

代币

Webhook

创建付款订单 | POST /v1/order/createPayout

请求

请求头

请求体参数（`data` 字段）

cURL

响应

PaymentAddress 对象

示例响应

错误响应

​请求

​请求头

​请求体参数（data 字段）

​cURL

​响应

​PaymentAddress 对象

​示例响应

​错误响应

请求

请求头

请求体参数（`data` 字段）

cURL

响应

PaymentAddress 对象

示例响应

错误响应