申请出款
商户向指定会员账户转款，不收手续费。受理后返回处理中状态，通过结果通知或查询接口确认最终结果。请求使用签名鉴权。
JSON 请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
third_order_no | string | 是 | 三方订单号，1–32 个字符，同一 APPID 下唯一；重复返回 1019 |
user_id | string | 是 | 收款会员的10位用户ID，首位非0；不是Telegram ID |
payout_amount | string | 是 | 出款金额，USDT；不收手续费，商户扣款与会员到账均等于此金额 |
custom_params | string | 否 | 自定义参数，最多 500 字符；原样返回，默认空字符串 |
callback_url | string | 否 | 本订单回调地址，非必填；填写时必须为 HTTPS，最多 2048 字节，须为公网地址；未传或空字符串表示不通知 |
json
{
"third_order_no": "PAYOUT202610220001",
"user_id": "1234567891",
"payout_amount": "100.00",
"custom_params": "customer=example",
"callback_url": "https://merchant.example.com/notify/payout"
}出款规则
- 仅转入已注册且状态正常的会员账户；
user_id为10位用户ID。 - 不收手续费：出款100 USDT，商户所属账户扣款100 USDT，会员到账100 USDT。
- 同一APPID下三方订单号唯一，重复请求返回
1019。请求超时先查询原单，不要更换订单号重复申请。 PROCESSING表示已受理；SUCCESS表示到账；FAILED不扣款，具体原因见failure_reason。余额不足或账户不可用时出款失败。- 失败后重新申请使用新订单号；收款会员不能是当前商户所属会员。
成功响应
json
{
"request_id": "7d5f6832c7494cb28e413f97f8460981",
"code": 0,
"message": "成功",
"data": {
"payout_id": "202610220000000044",
"app_id": "1234567890",
"third_order_no": "PAYOUT202610220001",
"user_id": "1234567891",
"currency": "USDT",
"payout_amount": "100.00",
"status": "PROCESSING",
"failure_reason": "",
"custom_params": "customer=example",
"callback_url": "https://merchant.example.com/notify/payout",
"create_time": "2026-10-22T00:00:00Z",
"finish_time": "",
"update_time": "2026-10-22T00:00:00Z"
}
}| 字段 | 类型 | 说明 |
|---|---|---|
data.payout_id | string | 平台出款ID，YYYYMMDD + 10位随机数字，表内唯一 |
data.app_id | string | 商户 APPID，由鉴权请求头确定 |
data.third_order_no | string | 三方订单号，1–32 个字符，同一 APPID 下唯一；重复返回 1019 |
data.user_id | string | 收款会员的10位用户ID，首位非0；不是Telegram ID |
data.currency | string | 币种，固定为 USDT |
data.payout_amount | string | 出款金额，USDT；不收手续费，商户扣款与会员到账均等于此金额 |
data.status | string | 出款状态：PROCESSING 处理中，SUCCESS 成功，FAILED 失败 |
data.failure_reason | string | 出款失败原因；非失败状态为空字符串 |
data.custom_params | string | 自定义参数，最多 500 字符；原样返回，默认空字符串 |
data.callback_url | string | 本订单回调地址，非必填；填写时必须为 HTTPS，最多 2048 字节，须为公网地址；未传或空字符串表示不通知 |
data.create_time | string | 创建时间，RFC 3339 格式，UTC 时区 |
data.finish_time | string | 处理完成时间，RFC 3339 / UTC；处理中为空字符串 |
data.update_time | string | 更新时间，RFC 3339 格式，UTC 时区 |
公共响应字段见通用约定。
业务错误
| code | message | 处理方式 |
|---|---|---|
| 1011 | 账户不存在 | 联系服务方核实账户是否已开通。 |
| 1019 | 订单号已存在 | 同一 APPID 下三方订单号不可重复；请查询原订单或使用新的订单号创建。 |
| 1027 | 回调地址格式不正确 | callback_url 可不传或为空字符串；填写时须为有效 HTTPS 地址，最多 2048 字节，不允许账号密码、片段或空白字符。 |
| 1028 | 出款金额格式不正确 | payout_amount 必须为大于0的十进制字符串，最多24位整数、2位小数。 |
| 1030 | 收款会员不存在 | user_id 使用收款会员的10位用户ID，不能使用 Telegram ID。 |
| 1031 | 收款会员不可用 | 核实收款会员账户状态。 |
| 1032 | 不能向商户所属账户出款 | 收款会员不能是当前商户所属会员。 |
填写 callback_url 后，订单结果按结果通知发送；未填写则不通知。