创建收款单（人民币）
创建人民币（CNY）收款订单接口。
请求资讯
- 请求 URL：
/gateway/api/v2/payments - 请求方式：
POST - Content-Type：
application/json;charset=utf-8
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| platform_id | 是 | String(6) | 商户 ID |
| service_id | 是 | String(7) | 服务 ID |
| payment_cl_id | 是 | String(64) | 商户订单号 |
| amount | 是 | Integer(10) | 金额（分） |
| notify_url | 是 | String(256) | 交易结果通知地址 |
| bank_name | 否 | String(16) | 银行代码，银行列表 |
| name | 否 | String(16) | 汇款人户名 |
| request_time | 是 | Integer(10) | 请求时间（秒） |
| sign_type | 否 | String(16) | 签名类型，固定值 HMAC-SHA256 |
| sign | 是 | String(32|64) | 订单签名 |
服务 ID
服务可用性
以下为常用服务 ID，实际可用服务请以客服提供的服务编号为准。
SVC0001银行卡代收SVC0002银行卡充值SVC0008微信扫码SVC0010支付宝扫码SVC0011支付宝H5
返回示例
成功返回
{
"error_code": "0000",
"data": {
"link": "https://pay.example.com/cashier/DEMOPM0123456",
"payment_id": "DEMOPM0123456",
"payment_cl_id": "order_20260112001",
"amount": 10000,
"payment_cl_name": "王小明",
"card_name": "",
"card_number": "",
"bank_name": ""
}
}
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| error_code | String | 错误码，详见全局错误码 |
| error_msg | String | 错误讯息（error_code 不为 "0000" 时返回） |
| link | String | 订单收银台地址 |
| payment_id | String | 平台订单号 |
| payment_cl_id | String | 商户订单号 |
| amount | Int | 提单金额 |
| payment_cl_name | String | 付款人姓名，即建单传入的 name 原样回带 |
| card_name | String | 收款账户名 |
| card_number | String | 收款银行卡号 / 账号 |
| bank_name | String | 收款银行名称 |
收款账号字段何时有值
card_name / card_number / bank_name 三项仅在银行转账类服务返回。
扫码类服务（支付宝扫码、微信扫码）不返回结构化收款账号，此时三项均为空字符串，
请引导用户至 link 完成支付。
备注
- 交易金额单位为人民币（分），请乘以 100 传入
- 请求时间使用 Unix timestamp，单位为秒
- 交易结果将通知至
notify_url，参数规范见 交易结果通知