接口地址:https://dms-api.shopoint.cn/shopoint-openapis-web/szyx/apiweb/pob
测试地址:https://dms-api-test.shopoint.cn/shopoint-openapis-web/szyx/apiweb/pob
使用场景:将商户可用资金代付到银行账户(银行账户必须是在结算通体系内申请开通的银行电子账户,或报备过的银行账户)。
请求参数
|
参数 |
参数名称 |
取值 |
可空 |
最大长度 |
备注 |
|
appid |
应用号 |
|
否 |
20 |
平台分配的APPID |
|
orgid |
机构ID |
|
是 |
11 |
实际交易的机构ID |
|
cusid |
付款商户号 |
店铺ID 分佣方ID |
否 |
11 |
|
|
reqsn |
商户订单号 |
|
否 |
20 |
商户自定义请求订单号,需保证在该平台范围内唯一 |
|
trxamt |
代付总金额 |
|
否 |
14 |
单位:分 |
|
dflist |
代付列表 |
|
否 |
|
最大支持10条,jsonArray格式字符串 |
|
randomstr |
随机字符串 |
|
否 |
32 |
商户自行生成的随机字符串 |
|
signtype |
签名方式 |
|
否 |
8 |
RSA/SM2 |
|
sign |
签名 |
|
否 |
32 |
详见安全规范 |
dflist参数详情:
|
参数 |
参数名称 |
取值 |
可空 |
最大长度 |
备注 |
|
subreqsn |
商户子订单号 |
|
否 |
50 |
需保证在本笔代付中唯一 |
|
acctname |
收款方户名 |
|
否 |
120 |
|
|
acctno |
收款方账号 |
|
否 |
32 |
|
|
accttype |
收款方账户类型 |
|
否 |
12 |
CREDIT:贷记卡;DEBIT:借记卡;PUBLIC:对公账户;PERSONAL:个人支付账户;COMPANY:单位支付账户;RESERVE:备付金账户;ALIPAY:支付宝 |
|
openbankibps |
收款方开户行联行号 |
|
是 |
12 |
对公账户必传,联行号参考《联行号.xlsx》 |
|
amount |
代付金额 |
|
否 |
14 |
单位:分 |
|
remark |
备注/附言 |
|
是 |
128 |
|
响应参数
|
参数 |
参数名称 |
取值 |
可空 |
最大长度 |
备注 |
|
retcode |
返回码 |
SUCCESS/FAIL |
否 |
88 |
此字段是通信标识,非交易结果,交易是否成功需要查看trxstatus来判断 |
|
retmsg |
返回码说明 |
|
是 |
100 |
|
以下信息只有当retcode为SUCCESS时有返回
|
参数 |
参数名称 |
取值 |
可空 |
最大长度 |
备注 |
|
cusid |
商户号 |
|
否 |
11 |
请求cusid |
|
appid |
应用ID |
|
否 |
20 |
请求appid |
|
orgid |
机构ID |
|
否 |
11 |
请求orgid |
|
reqsn |
商户订单号 |
|
否 |
20 |
|
|
transno |
代付流水号 |
|
否 |
30 |
|
|
confirmurl |
确认链接 |
|
是 |
|
部分银行渠道需二次确认时会返回链接 |