银联无卡分期费率查询
1.修订记录
| 修订 |
日期 |
说明 |
作者 |
| V0.1 |
2021/9/10 |
新接口参数定义 |
刘雷 |
| V0.2 |
2021/12/27 |
支持国密 |
王晶 |
2.接口说明
（1）场景说明
1、银联无卡分期费率查询，提供商户查询对应银行的分期数与对应的费率
（2）接口说明
1、银联无卡分期费率查询
3.请求地址
4.请求参数说明
4.1公共请求参数
| 参数 |
类型(字节长度） |
必填 |
参数说明 |
| method |
String(128) |
Y |
接口名称 固定值 ysepay.online.bank.installment.fee.rate.query |
| partner_id |
String(20) |
Y |
在银盛支付开设的服务商商户号，请联系客户经理提供 |
| timestamp |
String(19) |
Y |
发送请求的时间，格式"yyyy-MM-dd HH:mm:ss" 示例值：2014-07-24 03:07:50 |
| charset |
String(10) |
Y |
商户网站使用的编码格式，如UTF-8、GBK、GB2312等，默认值 GBK |
| sign_type |
String(10) |
Y |
报文签名算法，RSA/SM |
| sign |
String(256) |
Y |
签名字符串，再用Base64编码 |
| version |
String(3) |
Y |
接口版本3.0 当前版本：3.0 |
| biz_content |
String |
Y |
业务请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递 |
4.2 业务请求参数
参数名biz_content,值为一个json格式对象，下面列表描述json对象的值
| 参数 |
类型(字节长度） |
参数说明 |
样例 |
对应v1.0版本节点 |
是否可为空 |
| merchant_usercode |
String(1,20) |
商户号,如果被查询的商户号和合作商户号不一致则需要检查机构信息 |
X2111261141140148841 |
|
可空 |
5.返回参数说明
请注意：银盛后期会对返回参数保留扩展的权力，扩展方式为新增参数但不会删除参数，请商户在解析银盛返回参数时要支持银盛可能扩展参数这种情况。
5.1 公共响应参数
| 参数 |
类型(字节长度） |
必填 |
参数说明 |
| sign |
String |
Y |
签名字符串，Base64编码 |
| ysepay_online_bank_installment_fee_rate_query_response |
String |
Y |
业务响应参数的集合，最大长度不限 |
5.2 业务响应参数
| 参数 |
参数类型 |
必填 |
参数说明 |
| code |
String |
Y |
响应代码 |
| msg |
String |
Y |
响应代码描述 |
| bank_installment_fee_rates |
List |
N |
相关银行分期费率信息 |
BankFeeRate 银行所列分期费率
| 参数 |
参数类型 |
必填 |
参数说明 |
| bank_code |
String |
Y |
银行编码 |
| bank_name |
String |
Y |
银行名称 |
| installment_fee_rates |
List |
Y |
银行分期费率信息 |
BankInstallmentFeeRate 银行对应分期数及费率
| 参数 |
参数类型 |
必填 |
参数说明 |
| bank_code |
String |
Y |
银行编码 |
| bank_name |
String |
Y |
银行名称 |
| installment_num |
Integer |
Y |
分期数 |
| fee_rate |
Double |
Y |
费率 |
6.样例
无
7.附录
无