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

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

请求资讯

请求 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`（USDT / TRON）、JPYC 收款填 `SVC0087`（JPYC / ETHEREUM）
payment_cl_id	是	String(64)	商户订单号（长度 1~64）
amount	是	Integer	金额，单位为 0.01（币量 ×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)	订单签名

币种由 service_id 决定

渠道型加密货币代收的币种与链由 service_id 决定，无需额外传 currency：SVC0086 = USDT（TRON）、SVC0087 = JPYC（ETHEREUM）。本接口与法币代收共用同一入口，但加密货币渠道收款不需要填写银行卡、户名、付款人等法币字段。

请求示例

{
  "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	订单收银台地址，请将付款人引导至此页面完成链上转账
payment_id	String	平台订单号
payment_cl_id	String	商户订单号
amount	Int	提单金额（单位 0.01）

收款地址不在本接口返回

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

备注

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

请求资讯​

请求参数​

请求示例​

返回示例​

成功返回​

错误返回示例​

返回参数说明​

备注​