重新报备
1、修订记录
修订记录 |
日期 |
说明 |
作者 |
1.0 |
2022.04.01 |
初稿 |
康俊锋 |
2、业务说明
(1)接口说明
开通扫码服务商商户进件成功后银盛会自动扫码报备,当因为某种原 因导致商户扫码报备失败,可以用此接口重新扫码报备,type 与 flag 同时为空或不为空,同时为空时表示全渠道报备,同时不为空时表示 单渠道报备
3、请求地址
4、请求参数说明
4.1、公共请求参数
参数 |
类型(长度) |
必填 |
参数说明 |
ver |
String(3) |
Y |
版本号 固定值1.0 |
src |
String(50) |
Y |
由银盛生成的接入机构号,请联系银盛客户经理获取。示例值:ORG20210427160753 |
msgCode |
String(20) |
Y |
接口代码 固定值Merchant |
method |
String(30) |
Y |
接口方法 固定值termSweepReport |
signType |
String(10) |
Y |
报文签名算法,RSA、SM 注:应监管要求签名算法变更为国密,新接入商户请选择SM |
charset |
String(10) |
Y |
字符集 固定值UTF-8 |
reqFlowId |
String(20) |
Y |
请求流水号 示例值:202110011944011101 注:该字段不参与签名 |
signValue |
String |
Y |
签名串,请参考"签名样例以及demo下载" |
data |
String |
Y |
业务参数(des加密成密文字符串) |
4.2、业务请求参数
data加密前的json数据明文字符串
参数 |
类型(长度) |
必填 |
参数说明 |
mercId |
String(20) |
Y |
商户号 |
mcc |
String |
N |
mcc码 |
reportMercNm |
String |
N |
报备名称 |
type |
String(10) |
N |
银联网联标识 CUPS 银联 NUCC 网联 |
flag |
String(10) |
N |
微信支付宝 标识 wx 微信 alipay 支付宝 |
5、响应参数说明
银盛支付对商户的请求数据处理完成后,会将处理的结果数据同步回执给商户。
请注意:银盛后期会对返回参数保留扩展的权力,扩展方式为新增参数但不会删除参数,请商户在解析银盛返回参数时要支持银盛可能扩展参数这种情况。
5.1、公共响应参数
参数 |
类型(字节长度) |
必填 |
参数说明 |
ver |
String(3) |
Y |
版本号 固定值1.0 |
src |
String(50) |
Y |
由银盛生成的接入机构号,请联系银盛客户经理获取。示例值:ORG20210427160753 |
msgCode |
String(20) |
Y |
接口代码 固定值Merchant |
method |
String(30) |
Y |
接口方法 固定值termSweepReport |
signType |
String(10) |
Y |
报文签名算法,RSA、SM 注:应监管要求签名算法变更为国密,新接入商户请选择SM |
charset |
String(10) |
Y |
字符集 固定值UTF-8 |
reqFlowId |
String(20) |
Y |
请求流水号 示例值:202110011944011101 注:该字段不参与签名 |
signValue |
String |
Y |
签名串,请参考"签名样例以及demo下载" |
data |
String |
Y |
业务参数(JSON数据) |
5.2、业务响应参数
data(JSON数据)
参数 |
类型(字节长度) |
必填 |
参数说明 |
code |
String(2) |
Y |
返回码 00-成功; 50-超时; 99-失败 |
note |
String(100) |
Y |
返回码说明 |
mapList |
JSONArray |
N |
第三方商户号列表 |
第三方商户号对象(json数据key: mapList):
参数 |
类型(字节长度) |
必填 |
参数说明 |
apprSts |
String |
N |
报备状态 00 报备成功 03 报备失败 04 交易失败 |
remark |
String |
N |
报备备注 |
type |
String |
N |
银联网联标识(CUPS 银联 NUCC 网联 |
flag |
String |
N |
微信支付宝标识 wx 微信 alipay 支 付宝 |
thirdMercId |
String |
N |
第三方商户号 |