创建收款单（USDT 渠道）

创建 USDT 渠道代收订单接口。订单创建后，请将付款人引导至返回的 link（平台收银台），收银台会展示渠道返回的 USDT 收款地址、二维码与应付金额，付款人完成链上转账后由渠道结算并回调通知。

请求资讯

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

请求参数

参数名	必选	类型	说明
platform_id	是	String(6)	商户 ID
service_id	是	String(7)	服务 ID，USDT 渠道收款固定填 `SVC0086`
payment_cl_id	是	String(64)	商户订单号（长度 1~64）
amount	是	Integer	金额，单位为 0.01 USDT（USDT 数量 ×100）。例如 2 USDT 请传 `200`
notify_url	否	String(256)	交易结果通知地址
request_time	是	Integer(10)	请求时间（Unix timestamp，单位：秒）
sign_type	否	String(16)	签名类型，固定值 `HMAC-SHA256`；留空则使用 MD5
sign	是	String(32\|64)	订单签名

USDT 渠道无需银行卡/付款人字段

本接口与法币代收共用同一入口，但 USDT 渠道收款不需要填写银行卡、户名、付款人等法币字段，传入 platform_id / service_id / payment_cl_id / amount / notify_url / request_time / sign 即可。

请求示例

{
  "platform_id": "PF0001",
  "service_id": "SVC0086",
  "payment_cl_id": "order_20260610001",
  "amount": "200",
  "notify_url": "https://your-domain.com/notification",
  "request_time": "1749523200",
  "sign_type": "HMAC-SHA256",
  "sign": "c81634c1769044eac9e9628a2292f557"
}

返回示例

成功返回

{
  "error_code": "0000",
  "data": {
    "link": "https://pay.example.com/payment/index.html?token=eyJhbG",
    "payment_id": "DEMOPM0123456",
    "payment_cl_id": "order_20260610001",
    "amount": 200
  }
}

错误返回示例

{
  "error_code": "0004",
  "error_msg": "验签错误!"
}

返回参数说明

参数名	类型	说明
error_code	String	错误码，详见全局错误码
error_msg	String	错误讯息（error_code 不为 "0000" 时返回）
link	String	订单收银台地址，请将付款人引导至此页面完成 USDT 转账
payment_id	String	平台订单号
payment_cl_id	String	商户订单号
amount	Int	提单金额（单位 0.01 USDT）

USDT 收款地址不在本接口返回

本接口成功仅返回 link（收银台地址），不直接返回链上收款地址、链别或二维码。USDT 收款地址、TRC-20 网络与二维码由收银台页面展示给付款人。商户只需把付款人导向 link 即可。

备注

商户 ID 为系统分配之唯一识别，如尚未取得请联系系统人员
服务 ID 请填入 SVC0086（USDT 渠道收款），参考 service_id 列表
金额单位为 0.01 USDT，请将 USDT 数量乘以 100 传入，例如收款 2 USDT 请传 200
USDT 金额精度上限为小数点后 2 位，超过将返回金额精度错误
当前仅支持 TRON（TRC-20） 网络
请求时间使用 Unix timestamp，单位为秒
交易结果将通知至 notify_url，请传入可公开访问之完整地址（仅支援 http 与 https 协议），参数规范见交易结果通知

请求资讯​

请求参数​

请求示例​

返回示例​

成功返回​

错误返回示例​

返回参数说明​

备注​