接口地址
生产环境：https://cus.allinpay.com/cusapi/merchantapi/product
测试环境：https://syb-test.allinpay.com/vsppcusapi/merchantapi/product
使用场景：
对商户开通产品的增删改查操作
请求参数：
|
参数 |
参数名称 |
取值 |
可空 |
最大长度 |
备注 |
|
orgid |
代理商号 |
平台分配的代理商号 |
否 |
15 |
|
|
cusid |
商户号 |
审核通过分配的通联商户号 |
否 |
15 |
|
|
appid |
应用ID |
平台分配的机构APPID |
否 |
8 |
|
|
version |
版本号 |
接口版本号 |
可 |
2 |
默认填11 |
|
randomstr |
随机字符串 |
商户自行生成的随机字符串 |
否 |
32 |
|
|
reqtype |
请求类型 |
query/add/edit/del |
否 |
10 |
接口请求子类型 |
|
prodlist |
支付产品信息列表 |
产品列表的json |
否 |
1000 |
当reqtype为query时可为空 |
|
signtype |
签名类型 |
|
|
|
RSA/SM2 |
|
sign |
签名 |
详见安全规范 |
否 |
32 |
|
其中产品列表prodlist的json信息为：
|
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
|
pid |
产品名称 |
P0003 |
否 |
8 |
P0003-网上收银 |
|
mtrxcode |
交易类型 |
详见附录交易类型 |
否 |
20 |
|
|
feerate |
费率 |
千分之 |
否 |
8 |
例如3.5代表千分之3.5 |
|
creditrate |
信用卡费率 |
千分之 |
是 |
8 |
例如3.5代表千分之3.5 （借贷分离者必填） |
|
feecycle |
收费周期 |
|
否 |
2 |
2 日结 4 月结 |
|
lowlimit |
保底 |
元 |
是 |
|
例如保底10元填：10 |
|
toplimit |
封顶 |
元 |
是 |
|
例如封顶100元填：100 |
|
rankrate |
费率json |
Json数组 |
是 |
2000 |
费率数组 具体模式看feeratetype |
rankrate数组详细字段列表
|
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
|---|---|---|---|---|---|
|
feerate |
借记卡费率 |
为千分比 |
是 |
8 |
例如3.5代表千分之3.5 |
|
creditrate |
贷记卡费率 |
为千分比 |
是 |
8 |
例如3.5代表千分之3.5或单笔3.5元 |
|
lowlimit |
借记卡保底值 |
元 |
是 |
|
例如保底10元填：10 |
|
toplimit |
借记卡封顶值 |
元 |
是 |
|
例如保底10元填：10 |
|
rank |
区间 |
元 |
是 |
8 |
|
[{"rank":"0-1000","feerate":"3.5","creditrate":"","lowlimit":"10","toplimit":"100"},{"rank":"1000-5000","feerate":"4.5","creditrate":"","lowlimit":"20","toplimit":"100"},{"rank":"5000-","feerate":"5.5","creditrate":"","lowlimit":"10","toplimit":"100"}]
响应参数：
|
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
|
retcode |
返回码 |
SUCCESS/FAIL |
否 |
8 |
SUCCESS-请求成功 FAIL-请求或前端处理失败，具体看retmsg |
|
retmsg |
返回码说明 |
|
是 |
100 |
|
|
trxstatus |
状态码 |
1000|1999 |
否 |
4 |
1000: 获取结果成功 1999:获取结果失败 |
|
orgid |
代理商号 |
|
否 |
15 |
与请求时一致 |
|
cusid |
商户号 |
|
否 |
15 |
与请求时一致 |
|
以下信息只有当retcode为SUCCESS时有返回 |
|||||
|
auditstatus |
状态码 |
|
|
|
状态码为00时，表示请求成功(增删改查) |
|
errmsg |
错误描述 |
|
是 |
100 |
|
|
prodlist |
门店信息列表json格式 |
|
是 |
|
仅reqtype为query时返回数据 |
reqtype为query时 prodlist详细字段列表
|
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
|---|---|---|---|---|---|
|
pid |
产品名称 |
P0003 |
否 |
8 |
P0003-网上收银 |
|
mtrxcode |
交易类型 |
详见附录交易类型 |
否 |
20 |
|
|
feerate |
费率 |
千分之 |
是 |
8 |
例如3.5代表千分之3.5 |
|
feepen |
每笔多少元 |
元 |
是 |
8 |
仅当网上收银-网关B2B 时配置其他交易类型为空 |
|
creditrate |
信用卡费率 |
千分之 |
是 |
8 |
例如3.5代表千分之3.5 （借贷分离者必填） |
|
lowlimit |
保底 |
元 |
是 |
|
例如保底10元填：10 |
|
toplimit |
封顶 |
元 |
是 |
|
例如封顶100元填：100 |
|
feecycle |
收费周期 |
|
是 |
2 |
2 日结 4 月结 |
|
rankrate |
阶梯费率 |
Json数组 |
是 |
2000 |
阶梯费率数组 |
|
rankrate.rankstart |
阶梯起点 |
元 |
是 |
8 |
表示0~1000中的0 |
|
rankrate.rankend |
阶梯终点 |
元 |
是 |
8 |
表示0~1000中的1000 如果rankend 为空表示当前阶梯为大于起点 |
|
rankrate.feerate |
借记卡费率 |
为千分比 |
是 |
8 |
例如3.5代表千分之3.5 |
|
rankrate.creditrate |
贷记卡费率 |
为千分比 |
是 |
8 |
例如3.5代表千分之3.5或单笔3.5元 |
|
rankrate.lowlimit |
保底值 |
元 |
是 |
|
例如保底10元填：10 |
|
rankrate.toplimit |
封顶值 |
元 |
是 |
|
例如保底10元填：10 |
|
allowrtgoods |
是否允许退货 |
|
是 |
2 |
0不允许退货 1允许退货 |
|
refundfee |
退货退手续费 |
|
是 |
2 |
0不退手续费 1退手续费 |
|
prodstate |
产品状态 |
删除属于物理删除无结果返回 |
是 |
2 |
0 冻结 1正常 |
|
confirmstate |
待审核状态 |
当前交易类型是否存在待审核状态 |
是 |
2 |
A新增待审核 D关闭待审核 R解冻待审核 F冻结待审核 |