开通钱包业务配置¶
开通钱包业务、关闭钱包、配置费率
请求参数¶
- 请求地址
https://spin.cloudpnr.com/ssproxy/configWallet
- 公共请求参数
请求报文头HEADER - 「接口规则-参数规定-报文头」 ,请求报文体BODY - 「接口规则-参数规定-报文体」 ,响应报文体 - 「接口规则-参数规定-响应报文体」
- 请求参数(data)
参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
---|---|---|---|---|---|
req_seq_id | 请求流水号 | String | Y | 32 | |
req_date | 请求时间 | String | Y | 8 | 请求时间yyyyMMdd |
product_id | 产品编号 | String | Y | 32 | 固定值产品编号;由渠道商入驻时与渠道商号一同分配 |
huifu_id | 商户汇付Id | String | Y | 18 | |
settle_cycle | 结算户转入钱包周期 | String | Y | 2 | T1:下个工作日到账;D1:下个自然日到账; TS:实时 ;首次开通时必填 |
wallet_cash_config_list | 取现配置 | List | C | 1 | JSON列表;开通钱包业务必填 |
async_return_url | 异步通知地址 | String | N | 128 | 格式: virgo://消息接收地址,如:virgo://http://service.example.com/to/path 为空不推送审核消息。 |
wallet_status | 钱包状态 | String | N | 1 | 1:开通 0:关闭;不填默认开通 |
wallet_cash_config_list
参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
---|---|---|---|---|---|
switch_state | 状态 | String | Y | 1 | 1:开通 0:关闭;修改状态为关闭时,以下字段不支持修改 |
cash_type | 业务类型 | String | N | 2 | 取现类型D0:当日取现,当日到账D1:当日取现,下个自然日到账T1:当日取现,下个工作日到账 |
fix_amt | 提现手续费(固定/元) | BigDecimal | N | 16,2 | 每笔取现收取手续费费用,固定值。取现手续费与取现费率二选一必填 |
fee_rate | 费率(百分比/%) | BigDecimal | N | 6,2 | 按照取现金额百分比收取。取现手续费与取现费率二选一必填 |
fee_charge_type | 交易手续费收取类型 | String | N | 1 | 1:实收 2:后收(不填默认实收) |
out_fee_flag | 是否开通取现手续费外扣 | String | N | 1 | 1:外扣 2:内扣(默认内扣) |
out_fee_huifuid | 取现手续费外扣汇付ID | String | N | 16 | out_settle_flag=1时必填 |
响应参数¶
- 同步响应参数(data)
参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
---|---|---|---|---|---|
sub_resp_code | 业务返回码 | String | Y | 8 | 业务返回码 |
sub_resp_desc | 业务返回描述 | String | Y | 512 | 业务返回描述 |
apply_no | 申请单编号 | String | N | 256 | 微信支付分配的申请单号,申请成功时返回 |
- 异步响应参数(data)
参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
---|---|---|---|---|---|
sub_resp_code | 业务返回码 | String | Y | 8 | 业务返回码 |
sub_resp_desc | 业务返回描述 | String | Y | 512 | 业务返回描述 |
req_seq_id | 请求流水号 | String | Y | 32 | 原请求流水号 |
req_date | 请求时间 | String | Y | 8 | 原请求时间YYYYMMDD |
audit_status | 审核结果 | String | Y | 1 | Y:审核通过 N:审核拒绝 F:失败 |
audit_desc | 审核描述 | String | N | 512 | 审核结果描述 |
product_id | 产品编号 | String | Y | 32 | 固定值产品编号 |
huifu_id | 汇付客户号 | String | N | 18 | 固定18位 ,汇付分配的商户号 |
apply_no | 申请单号 | String | N | 18 | 汇付返回商户开户业务申请单号 |
请求示例¶
{
"data": "{\"req_seq_id\":\"rQ202104088003805983707\",\"req_date\":\"20210408\",\"product_id\":\"ZDTEST\",\"huifu_id\":\"6666000103657077\",\"settle_cycle\":\"T1\",\"async_return_url\":\"http://192.168.85.157:30031/sspm/testVirgo\",\"wallet_status\":\"1\",\"wallet_cash_config_list\":[{\"cash_type\":\"D1\",\"fix_amt\":\"2\",\"fee_rate\":\"2\",\"fee_charge_type\":\"1\",\"out_fee_flag\":\"2\",\"out_fee_huifuid\":\"6666000103657077\"}]}",
"sys_id": "ssproxy_dev",
"sign": "PRTcr5o2oF2UdXNU7o9vglrkOn4b08VZ3DdLhxL76z1Zml+CFLXpbXR8xIWeTFmOhXm95vSxG/mKXR5fWxaznh6FDVQdNx/CxLfrRhX4VfcLNLTlqtEZ99zZDrD/BPzA16cAdVVnolMbMqv6xXEra+GFGtxcjOyvoRzcdSAWdOo=",
"sign_type": "RSA2"
}
响应示例¶
{
"data":"{\"sub_resp_code\":\"00000000\",\"sub_resp_desc\":\"成功\"}",
"resp_code":"10000",
"resp_desc":"成功调用",
"sign":"QfkHGK4jbfbIP1fO2UNz29D8nWedIIUfDBchqiiddqy3ktiPXsnchleNmGSOCW+BqEUtquRfJg3iFD0htlyNNy5yN/zxc3dOb+sgTS0JSdkxYlfwMBtGg9xAp791ugguos5lhQSUplGAi7B7BWur7HvcjwL5brTsFPdOWcyrJkM="
}