接口地址
生产环境:https://cus.allinpay.com/cusapi/merchantapi/agentExpired
测试环境:https://syb-test.allinpay.com/vsppcusapi/merchantapi/agentExpired
使用场景:
代理商可以通过请求获取代理商下属商户证件到期提醒结果文件的临时下载地址。
请求参数:
参数 |
参数名称 |
取值 |
可空 |
最大长度 |
备注 |
---|---|---|---|---|---|
orgid |
机构号 |
平台分配的机构号 |
否 |
15 |
|
cusid |
商户号 |
平台分配的商户号 |
否 |
15 |
|
appid |
应用ID |
平台分配的机构APPID |
否 |
8 |
|
version |
版本号 |
接口版本号 |
可 |
2 |
默认填11 |
randomstr |
随机字符串 |
商户自行生成的随机字符串 |
否 |
32 |
|
filetype |
到期提醒文件类型 |
90 -- 90天到期商户文件 |
否 |
|
|
enddate |
到期日 |
默认为当前日期。格式:yyyy-MM-dd |
可 |
|
|
notifyurl |
通知地址 |
待文件生成,通过该url回调给调用方,详见2.41 |
否 |
3 |
|
signtype |
签名类型 |
支持类型 RSA,SM2 |
可 |
32 |
|
sign |
签名 |
详见安全规范 |
否 |
32 |
|
响应参数:
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
---|---|---|---|---|---|
retcode |
返回码 |
SUCCESS/FAIL
|
否 |
8 |
此字段是通信标识,非交易结果 |
retmsg |
返回码说明 |
|
是 |
100 |
|
orgid |
机构号 |
平台分配的机构号 |
否 |
15 |
与请求时一致 |
cusid |
商户号 |
商户号 |
否 |
15 |
与请求时一致 |
以下信息只有当retcode为SUCCESS时有返回 |
|||||
randomstr |
随机字符串 |
随机生成的字符串 |
否 |
32 |
|
sign |
签名 |
|
否 |
32 |
详见安全规范 |