批量解绑/绑定商户异步通知
1、修订记录
修订记录 |
日期 |
说明 |
1.0 |
2022.06.09 |
初版 |
2、业务说明
2.1、接口说明
当商户调用完批量解绑/绑定商户接口,银盛异步解绑/绑定操作完成之后会异步下发回执
注意:
1、银盛收到客户方请求后,返回success,则会异步处理商户解绑/绑定操作,操作完成之后会发送回执
2、若返回非success,不会异步去执行商户解绑/绑定操作,不会有回执通知
3、回执通知失败,会进行2次重发,通知中间没有间隙
2.2、接入方接受异步通知接口的要求:
1、接受方式:POST
2、接受主体类型:application/json
3、需要对通知的数据进行验签,验签使用公钥验签,详见demo
4、必须要有一个返回值 该值为String类型。
5、接入方必须能够正确处理重复的通知,以避免函数重入造成的数据混乱。
3、异步通知报文结构
3.1、公共请求参数
参数 |
类型(长度) |
必填 |
参数说明 |
timeStamp |
String |
Y |
发送请求的时间,格式"yyyy-MM-dd HH:mm:ss" |
src |
String |
Y |
异步通知来源,固定"ysf" |
reqId |
String |
Y |
请求流水号 |
charset |
String(10) |
Y |
编码格式 固定为UTF-8 |
sign |
String |
Y |
签名,需要银盛公钥验签,详见demo |
bizContent |
String |
Y |
异步通知的内容(绑定结果,txt文件转base64) |
4、接入方返回值定义
接入方返回参数为String,不返回和非success都为失败,如果接入方处理失败,可以返回处理失败原因,以供查找问题