注意:因为以后可能会增加通知参数,请获取全量变量,然后遍历获取非空变量,而不能用request.getparam(“key”)这样用文档中的字段名来一个个获取,到时候收银宝增加通知字段,就无法兼容了.请参考demo
通知的每一个字段都会进行UTF-8的UrlEncode,如果商户接收结果的服务器用web容器进行接收,例如TOMCAT,IIS.则无需进行URLDecode,如果不是用web容器进行接收,而是读数据流自己进行解析,则需要进行UTF-8的UrlDecode
以java为例:
String trxreserve = "订购人+10086";
String sendData = URLEncoder.encode(trxreserve, "UTF-8");
String getData = URLDecoder.decode(sendData, "UTF-8");
通知响应结果:
商户服务端在接收到结果通知并正确处理后,应响应消息。正确处理响应success,其他响应或者不响应通联开发平台则通过重发机制进行重发,重发次数为5次
对后台通知交互时,如果通联收到商户的应答不符合规范或超时,通联认为通知失败,通联会通过一定的策略定期重新发起通知,尽可能提高通知的成功率,但通联不保证通知最终能成功。(通知频率为15s/15s/5m/10m/15m - 总计30m30s)
API接口进件的商户在运营人员进行合规性审核时,会对商户状态进行修改,平台会通过主动发起http post请求的方式,把审核结果通知到代理商平台配置的合规性审核通知地址,请求参数如下:
字段 |
名称 |
取值 |
说明 |
---|---|---|---|
orgid |
平台分配的代理商号 |
|
|
cusid |
平台分配的商户号 |
|
|
appid |
平台分配的机构APPID |
|
|
notifytype |
通知类型类型 |
compliance |
合规性审核通知 |
needrepair |
是否需要补录 |
0/1 |
为1时不需要补录 |
handlestate |
审核结果 |
0/2/3/4
|
0-正常 2-降低风控 3-延迟冻结 4-冻结 若rgctype为1则合规性后督模式 0-正常 4-待冻结 5-待降额 6-待分公司冻结 7-系统冻结 8-系统降额 |
cfstate |
审核状态 |
02/04/05/09/13/14/15 |
02-审核完毕 04-待二次补充 05-补充完毕 09-七天未处理系统冻结 若rgctype为1则合规性后督模式 00 未到期 01 待经办审核 02 待补录 03 补录审核 04 审核完 |
handlemsg |
审核异常错误信息 |
|
|
handledetail |
审核详情json数组 |
|
详情见下表 |
rgctype |
合规性模式 |
0/1 |
空或者0表示普通合规性 1表示合规性后督模式 |
sign |
签名信息 |
详见安全规范 |
|
其中handledetail:
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
---|---|---|---|---|---|
headresult |
门头照 |
|
是 |
10 |
1.完全一致 2.基本一致(废止) 3.不一致(废止) 4.无招牌经营内容一致 5.无招牌经营内容不一致(废止) 6.照片无法体现门头 7.疑似截图/翻拍 8.商户简称不一致 9.疑似冒用 0.其他不一致 新增的67890状态都关联降低风控且可修改客户简称 其中3、5关联降低风控 仅状态3、5时可补充修改且可修改客户简称 |
innerresult |
内部经营照 |
|
是 |
10 |
1.完全一致 2.基本一致(废止) 3.不一致(废止) 4.无照片(废止) 5.MCC选择错误 6.疑似截图/翻拍 7.场景未体现经营范围 8.疑似冒用 0.其他不一致 新增的56780会导致关联降低风控可进行补充修改 其中3、4导致关联降低风控 仅3、4时可补充修改 |
handpickresult |
经营者手持 有效证件合照 |
|
是 |
10 |
1.一致 2.不一致(废止) 3.疑似截图/翻拍 5.身份证未手持或不清晰 6.疑似冒用 0.其他不一致 新增的3560状态会导致关联冻结可补充修改 其中2导致商户冻结 仅状态2时可补充修改 |
peasonheadresult |
经营者与 店铺门头合照 |
|
是 |
10 |
1.一致 2.不一致(废止) 3.疑似截图/翻拍 4.未与店铺合照 5.疑似冒用 0.其他不一致 新增的3450状态会导致关联冻结且可补充修改 其中2导致商户冻结 仅状态2时可补充修改 |
creditresult |
营业证件 |
|
是 |
10 |
1.完全一致 2.基本一致(废止) 3.不一致(废止) 4.无照片(废止) 5.复印件需盖章 6.营业证件号不清晰 7.疑似截图/翻拍 8.疑似冒用 9.证件日期不一致 0.其他不一致 新增56780状态会导致关联冻结 其中3、4导致商户冻结 仅3、4时可补充修改 |
legalidresult |
身份证照 |
|
是 |
10 |
1.完全一致 2.不一致(废止) 3.无照片(废止) 4.复印件正、反需盖章 5.疑似截图/翻拍 6.疑似冒用 7.证件日期不一致 0.其他不一致 新增4560状态会导致关联冻结 其中2、3导致商户冻结 仅状态为2、3时可补充修改 |
rentctresult |
租赁合同 |
|
是 |
10 |
1.完全一致 2.不一致(废止) 3.无合同(废止) 4.日期不规范/无合同 5.合同缺少盖章或签字 6.疑似冒用 7.租赁地址/承租人与系统内不一致 8.免审 0.其他不一致 新增45670状态会导致关联降低风控且可修改商户注册地址 其中2、3导致关联降低风控 仅状态2、3时可补充修改且可以修改商户注册地址 |
paperresult |
纸质协议 |
|
是 |
10 |
1.合规 2.不合规(废止) 3.无协议(废止) 4.合同不规范/无合同 5.未盖公司章 6.无注册登记表或表格未盖章 新增45状态关联冻结商户可修改附件 其中2、3导致商户冻结 仅状态为2、3时可补充修改 |
clearparamresult |
结算信息 审核项 |
|
是 |
10 |
1.一致 新增456780状态关联商户冻结可修改附件 其中2、3导致商户冻结 仅状态2、3时可补充修改 |
authresult |
签字授权书 |
|
是 |
10 |
1.合规 2.不合规(废止) 3.授权必须为法人 4.复印件/扫描件未盖公司章 5.被授权人未签字 6.授权日期不规范 7.疑似冒用 0.其他不一致 其中2 3 4 5 6 7 0导致商户冻结 仅状态为2 3 45 670时可补充修改 |
subbranchresult |
门店审核项 |
|
否 |
2 |
1省市一致 2注册地与经营地不一致 3经营地与门店不一致 |
certifiedresult |
执业证明 材料审核项 |
|
是 |
2 |
1一致 状态为2导致商户冻结 |
legalidresulthd |
身份证正反面 |
0|1|2 审核内容非正常时 允许同时存在用英文,号拼接 |
是 |
10 |
合规性后督才有: 0正常 1与法人不一致(弃用) 2黑白复印件需盖章 3证件日期不一致 4疑似冒用 9其他不一致 1/2/3/4/9需要补录 13天未补充资料,由分公司发起冻结 |
creditresulthd |
营业执照 |
0|1 审核内容非正常时 允许同时存在用英文,号拼接 |
是 |
10 |
合规性后督才有: 0正常 1企业名称/法人/信用代码不一致 2黑白复印件需盖章 3营业证件号不清晰 4证件日期不一致 5商户性质不一致 6疑似冒用 9其他不一致 1/2/3/4/5/6/9需要补录 13天未补充资料,由分公司发起冻结 |
handpickresulthd |
法人手持 身份证照片 |
0|1 审核内容非正常时 允许同时存在用英文,号拼接 |
是 |
10 |
合规性后督才有: 0正常 1法人照片与身份证不一致 2未手持身份证/不清晰 3疑似截图/翻拍 4疑似冒用 9其他不一致 1/2/3/4/9需要补录 13天未补充资料,由分公司发起冻结 |
headresulthd |
门头照 |
0|1 审核内容非正常时 允许同时存在用英文,号拼接 |
是 |
10 |
合规性后督才有: 0正常 1与营业名称不一致(弃用) 2商户简称不一致 3局部未体现门 4疑似截图/翻拍 5疑似冒用 9其他不一致 1/2/3/4/5/9需要补录 30天内未补充,降低商户交易限额 |
innerresulthd |
内部经营照 |
0|1 审核内容非正常时 允许同时存在用英文,号拼接 |
是 |
10 |
合规性后督才有: 0正常 1与经营内容不匹配(弃用) 2MCC错误 3场景未体现 4疑似截图/翻拍 5疑似冒用 9其他不一致 1/2/3/4/5/9需要补录 30天内未补充,降低商户交易限额 |
authresulthd |
授权书 |
0|1 审核内容非正常时 允许同时存在用英文,号拼接 |
是 |
10 |
合规性后督才有: 0正常 1授权内容真实性存疑(弃用) 2未提供授权书 3授权须为法人 4复印/扫描需盖章 5被授权人未签字 6授权日期不规范 7疑似冒用 9其他不一致 1/2/3/4/5/6/7/9需要补录 13天未补充资料,由分公司发起冻结 |
clearparamresulthd |
结算信息 |
0|1 审核内容非正常时 允许同时存在用英文,号拼接 |
是 |
10 |
合规性后督才有: 0正常 1结算账号、账户名称不一致(弃用) 2类型不一致 3账号不清晰/不一致 4疑似冒用 9其他不一致 1/2/3/4/9需要补录 30天内未补充,降低商户交易限额 |
通知响应结果:
success