跳到主要内容

创建出款单（渠道型加密货币）

创建渠道型加密货币代付订单接口。加密货币代付统一使用通用入口 service_id=SVC0077，靠 currency 区分币种与链：usdt → 向 TRON 地址出款、jpyc → 向 ETHEREUM 地址出款。我方调用上游渠道发起链上打款，处理结果通过回调通知。

请求资讯​

  • 请求 URL： /gateway/api/v2/payouts
  • 请求方式： POST
  • Content-Type： application/json;charset=utf-8

请求参数​

参数名必选类型说明
platform_id是String(6)商户 ID
service_id是String(7)服务 ID，加密货币代付固定填 SVC0077（加密货币代付通用入口）
payout_cl_id是String(64)商户订单号（长度 1~64）
amount是Integer金额，单位为 0.01（币量 ×100）。例如 2 USDT 请传 200
currency是String币种，决定币种与链：usdt（向 TRON 地址出款）/ jpyc（向 ETHEREUM 地址出款）
number是String(5~64)收款链上地址（须与 currency 对应的链一致：usdt 填 TRON 地址、jpyc 填 ETHEREUM 地址）
notify_url否String(256)交易结果通知地址
request_time是Integer(10)请求时间（Unix timestamp，单位：秒）
sign_type否String(16)签名类型，固定值 HMAC-SHA256；留空则使用 MD5
sign是String(32|64)订单签名
service_id 固定、币种靠 currency 决定

加密货币代付统一用 service_id=SVC0077，不要按币种切换 service_id。币种与目标链完全由 currency 决定（usdt → TRON / jpyc → ETHEREUM）。这是通用入口设计，未来新增加密币只需扩展 currency 值，service_id 不变。

收款地址须与币种匹配

number 必须是 currency 对应链上的有效收款地址：currency=usdt 时填 TRON（TRC-20）地址、currency=jpyc 时填 ETHEREUM 地址。地址与链不匹配会导致出款失败或资金不可达。

请求示例​

USDT 代付（TRON）​

{
  "platform_id": "PF0001",
  "service_id": "SVC0077",
  "payout_cl_id": "payout_20260610001",
  "amount": "200",
  "currency": "usdt",
  "number": "TAkr13ZMWyPSpo7jvQ4ajgmm8X9EG4dEZK",
  "notify_url": "https://your-domain.com/notification",
  "request_time": "1749523200",
  "sign_type": "HMAC-SHA256",
  "sign": "c81634c1769044eac9e9628a2292f557"
}

JPYC 代付（ETHEREUM）​

{
  "platform_id": "PF0001",
  "service_id": "SVC0077",
  "payout_cl_id": "payout_20260610002",
  "amount": "200",
  "currency": "jpyc",
  "number": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
  "notify_url": "https://your-domain.com/notification",
  "request_time": "1749523200",
  "sign_type": "HMAC-SHA256",
  "sign": "d2e4534fce8c1d1053bbf59fd8ae4464"
}

返回示例​

成功返回​

{
  "error_code": "0000",
  "data": {
    "payout_id": "DEMOPO0123456",
    "payout_cl_id": "payout_20260610001",
    "amount": 200,
    "target_address": "TAkr13ZMWyPSpo7jvQ4ajgmm8X9EG4dEZK"
  }
}

错误返回示例​

{
  "error_code": "0007",
  "error_msg": "余额不足!"
}

返回参数说明​

参数名类型说明
error_codeString错误码，详见全局错误码
error_msgString错误讯息（error_code 不为 "0000" 时返回）
payout_idString平台订单号
payout_cl_idString商户订单号
amountInt提单金额（单位 0.01）
target_addressString目标收款地址（即请求的 number）
备注

下单成功仅表示订单受理并进入处理流程，不代表链上已打款完成。最终打款结果以出款结果通知或查询出款单返回的 status 为准。余额不足等情况会返回非 0000 错误码、订单不受理。

备注​

  • 商户 ID 为系统分配之唯一识别，如尚未取得请联系系统人员
  • 服务 ID 固定填 SVC0077（加密货币代付通用入口），参考 service_id 列表
  • 币种与目标链由 currency 决定：usdt（TRON）/ jpyc（ETHEREUM）
  • 金额单位为 0.01，请将币量乘以 100 传入，例如出款 2 USDT 请传 200
  • 金额精度上限为小数点后 2 位，超过将返回金额精度错误
  • 请求时间使用 Unix timestamp，单位为秒
  • 代付成功 = 链上打款完成；代付失败 = 退回商户余额。结果将通知至 notify_url，参数规范见 出款结果通知