创建出款单（人民币-数字人民币）
创建人民币（CNY）数字人民币（e-CNY / 数字人民币钱包）代付订单接口。
请求资讯
- 请求 URL：
/gateway/api/v2/payouts - 请求方式：
POST - Content-Type：
application/json;charset=utf-8
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| platform_id | 是 | String(7) | 商户 ID |
| service_id | 是 | String(7) | 服务 ID，请填入固定值 SVC0084 |
| payout_cl_id | 是 | String(32) | 商户订单号 |
| amount | 是 | Integer(10) | 金额（分） |
| notify_url | 否 | String(256) | 交易结果通知地址 |
| name | 是 | String | 受款人户名（必须与数字人民币钱包实名一致） |
| number | 是 | String | 受款人数字人民币钱包绑定手机号 |
| request_time | 是 | Integer(10) | 请求时间（秒） |
| sign_type | 否 | String(16) | 签名类型，固定值 HMAC-SHA256 |
| sign | 是 | String(32|64) | 订单签名 |
请求示例
{
"amount": "50000",
"name": "test_name",
"notify_url": "https://xxx.xx/notification",
"number": "13800138000",
"payout_cl_id": "DEVPOT00143538",
"platform_id": "PF0002",
"request_time": "1595504997",
"service_id": "SVC0084",
"sign": "8ac38fb87c2bcce4cf36627d4f8aa747"
}
返回示例
成功返回
{
"error_code": "0000",
"data": {
"payout_id": "POT00000001"
}
}
错误返回示例
{
"error_code": "0004",
"error_msg": "验签错误!"
}
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| error_code | String | 错误码，详见全局错误码 |
| error_msg | String | 错误讯息（error_code 不为 "0000" 时返回） |
| payout_id | String | 平台订单号 |
备注
重要提示
因为存在网络波动、并发量过大、被攻击等不可抗力因素，如若在调用代付接口时遇到 超时、HTTP 500 错误、调用结果返回空白，或网络延迟时，请以 订单查询接口状态 为依据，或与运营人员取得联系，提供商户单号进行人工查询，由运营人员人工确认代付订单是否失败。 未经过运营人员人工确认就驳回代付订单所造成的损失，本平台概不负责！
数字人民币钱包要求
name必须与数字人民币钱包的实名一致，未实名或姓名不符会被拒付number请填入受款人数字人民币钱包绑定的手机号- 数字人民币钱包有个人额度上限，超额会被拒付，请由商户自行控制出款金额
- 商户 ID 为系统分配之唯一识别，如尚未取得请联系系统人员
- 服务 ID 请填入
SVC0084（数字人民币代付） - 交易金额单位为人民币（分）
- 请求时间使用 Unix timestamp，单位为秒
- 返回 "0000" 时仅代表接口调用成功，并不表示交易状态，请调用查询接口确认结果
- 如遇任何情况未取得 Server 回应（e.g. 5xx HttpStatus...），需调用查询接口或等待回调，不可直接视为订单失败