接口地址
生产环境:https://cus.allinpay.com/cusapi/tlinvoice/getInvoiceOpenStatus
测试环境:https://syb-test.allinpay.com/vsppcusapi/tlinvoice/getInvoiceOpenStatus
使用场景:
商户调用接口获取电票开通状态
请求参数:
|
参数 |
参数名称 |
取值 |
可空 |
最大长度 |
备注 |
|
orgid |
机构号 |
平台分配的机构商户号 如果非机构号,则填空 |
是 |
15 |
|
|
cusid |
商户号 |
平台分配的商户号 |
否 |
15 |
|
|
appid |
应用ID |
平台分配的机构APPID |
否 |
8 |
|
|
version |
版本号 |
接口版本号 |
是 |
2 |
默认填12 |
|
randomstr |
随机字符串 |
商户自行生成的随机字符串 |
否 |
32 |
|
|
signtype |
签名类型 |
|
否 |
4 |
RSA/SM2 |
|
sign |
签名 |
|
否 |
256 |
详见安全规范 |
响应参数:
|
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
|
retcode |
返回码 |
SUCCESS/FAIL
|
否 |
8 |
此字段是通信标识,非交易结果 |
|
retmsg |
返回码说明 |
|
是 |
100 |
|
|
以下信息只有当retcode为SUCCESS时有返回 |
|||||
|
code |
开通状态 |
0-已开通;1-未开通 |
是 |
100 |
|
|
message |
开通信息 |
|
是 |
|
展示开通信息 |
|
abilitylist |
开通能力详情 |
Jsonarray格式,字段见下方开通能力详情字段 |
是 |
|
|
|
sign |
签名 |
|
否 |
256 |
详见安全规范 |
开通能力详情abilitylist字段
|
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
|
chnl |
开通渠道 |
微信|支付宝 |
否 |
|
|
|
ability |
开通能力 |
基础产品|成品油|不动产租赁 |
否 |
|
|
|
applytime |
申请时间 |
yyyy-mm-dd HH:mm:ss |
否 |
|
|
|
status |
状态描述 |
待接受邀请 开通成功 开通失败 已过期 待授权 待审核 审核未通过 人工置渠道已开通,待订阅通知 渠道开通成功,订阅通知失败 |
否 |
|
|
开通能力详情字段
|
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
|
chnl |
开通渠道 |
微信|支付宝 |
否 |
|
|
|
ability |
开通能力 |
基础产品|成品油|不动产租赁 |
否 |
|
|
|
applytime |
申请时间 |
yyyy-mm-dd HH:mm:ss |
否 |
|
|
|
status |
状态描述 |
待接受邀请 开通成功 开通失败 已过期 待授权 待审核 审核未通过 人工置渠道已开通,待订阅通知 渠道开通成功,订阅通知失败 |
否 |
|
|
请求报文:{appid=00000155, cusid=990605055336000, randomstr=1757663501950, sign=858037d10b8617c16f06ea4a19b47583, version=11}
响应报文:
{"appid":"00000155","code":"0","cusid":"990605055336000","randomstr":"154487445825","retcode":"SUCCESS","retmsg":"已开通","sign":"5649E3B28CEE620DCE76481EC981F387"}
开通能力详情字段
|
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
|
chnl |
开通渠道 |
微信|支付宝 |
否 |
|
|
|
ability |
开通能力 |
基础产品|成品油|不动产租赁 |
否 |
|
|
|
applytime |
申请时间 |
yyyy-mm-dd HH:mm:ss |
否 |
|
|
|
status |
状态描述 |
待接受邀请 开通成功 开通失败 已过期 待授权 待审核 审核未通过 人工置渠道已开通,待订阅通知 渠道开通成功,订阅通知失败 |
否 |
|
|
请求报文:{appid=00000155, cusid=990605055336000, randomstr=1757663501950, sign=858037d10b8617c16f06ea4a19b47583, version=11}
响应报文:
{"appid":"00000155","code":"0","cusid":"990605055336000","randomstr":"154487445825","retcode":"SUCCESS","retmsg":"已开通","sign":"5649E3B28CEE620DCE76481EC981F387"}