接口地址
生产环境：https://cus.allinpay.com/cusapi/merchantapi/prodfeeshareqry
测试环境：https://syb-test.allinpay.com/vsppcusapi/merchantapi/prodfeeshareqry
使用场景：
可以指定客户部分手续费部分补贴配置详情
请求参数：
|
参数 |
参数名称 |
取值 |
可空 |
最大长度 |
备注 |
|---|---|---|---|---|---|
|
orgid |
机构号 |
平台分配的机构号 |
否 |
15 |
|
|
cusid |
商户号 |
平台分配的商户号 |
否 |
15 |
|
|
appid |
应用ID |
平台分配的机构APPID |
否 |
8 |
|
|
version |
版本号 |
接口版本号 |
可 |
2 |
默认填11 |
|
randomstr |
随机字符串 |
商户自行生成的随机字符串 |
否 |
32 |
|
|
sign |
签名 |
详见安全规范 |
否 |
32 |
|
|
signtype |
签名方式 |
RSA/SM2 |
否 |
4 |
|
响应参数：
|
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
|---|---|---|---|---|---|
|
retcode |
返回码 |
SUCCESS/FAIL
|
否 |
8 |
此字段是通信标识，非交易结果 |
|
retmsg |
返回码说明 |
|
是 |
100 |
|
|
trxstatus |
状态码 |
1000|1999 |
否 |
4 |
1000: 获取结果成功 1999:获取结果失败 |
|
orgid |
机构号 |
平台分配的机构号 |
否 |
15 |
与请求时一致 |
|
cusid |
商户号 |
商户号 |
否 |
15 |
与请求时一致 |
|
以下信息只有当retcode为SUCCESS时有返回 |
|||||
|
errmsg |
错误描述 |
|
是 |
100 |
|
|
sharetype |
承担方类型 |
|
是 |
|
1：代理商 2：第三方 |
|
sharecusid |
承担方客户号 |
|
是 |
|
|
|
limitamt |
单笔限额 |
|
是 |
|
|
|
validbegin |
生效开始时间 |
|
是 |
|
格式:yyyy-MM-dd HH:mm:ss |
|
validend |
生效结束时间 |
|
是 |
|
格式:yyyy-MM-dd HH:mm:ss |
|
sharesumamt |
手续费补贴总额度 |
|
是 |
|
|
|
sharebalance |
补贴余额 |
|
是 |
|
|
|
sharecrbalance |
信用卡补贴余额 |
|
是 |
|
|
|
sharedrbalance |
消费-借记卡补贴剩余额度 |
|
是 |
|
|
|
shareqrbalance |
扫码交易补贴剩余额度 |
|
是 |
|
|
|
overpadflag |
单笔超限是否补贴 |
|
是 |
|
1:是 其他为否 |
|
crlimitflag |
是否限制消费-信用卡补贴总额度 |
|
是 |
|
1:是 其他为否 |
|
crlimitamt |
消费-信用卡补贴总额度 |
|
是 |
|
|
|
validstate |
是否生效状态 |
|
是 |
|
1:置生效中 0:已置失效 |
|
prodfeesharelist |
产品补贴费率列表json格式数组 |
|
是 |
|
json格式数组字符串 结构体字体参考prodfeesharelist 详细字段说明
|
prodfeesharelist 样例：
[{"mtrxcode":"VSP671","pid":"P0001","rankfeearr":[{"feerate":"2","feetype":"1","lowlimit":"","ratetype":"02","toplimit":""},{"feerate":"3","feetype":"2","lowlimit":"","ratetype":"02","toplimit":""}]},{"mtrxcode":"300003","pid":"V0001","rankfeearr":[{"feerate":"10","feetype":"1","lowlimit":"","ratetype":"02","toplimit":""}]}]
prodfeesharelist详细字段说明
|
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
|---|---|---|---|---|---|
|
pid |
产品名称 |
P0003 |
否 |
8 |
P0003-网上收银 |
|
mtrxcode |
交易类型 |
详见附录交易类型 |
否 |
20 |
|
|
rankfeearr |
补贴费率比例详情json格式数组 |
|
否 |
|
son格式数组字符串 结构体字体参考rankfeearr详细字段说明 |
rankfeearr详细字段说明
|
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
|---|---|---|---|---|---|
|
feerate |
补贴费率 |
|
否 |
|
|
|
ratetype |
补贴费率类型 |
|
否 |
20 |
01：单笔固定金额 02：千分比 |
|
lowlimit |
补贴保底金额 |
|
是 |
|
单位：元 |
|
toplimit |
补贴封顶金额 |
|
是 |
|
单位：元 |
|
feetype |
补贴借贷标识 |
|
是 |
|
1：借记交易补贴 2：贷记交易补贴 针对借贷分离计费交易有效，非借贷分离时，只存在feetype=01规则 |