爱贝云计费契约鉴权功能说明
对于提供契约型商品的应用,应用可以在用户使用商品时调用本接口进行契约的鉴权。对于包时长类型的契约,鉴权成功会返回契约的有效截止时间;鉴权失败则返回错误码。对于包次数类型的契约,鉴权成功会将剩余次数减一,同时返回契约的剩余次数;鉴权失败则返回错误码。
接口采用http协议,POST方法。
爱贝云计费请求URL
http://ipay.iapppay.com:9999/payapi/subsauth
爱贝云计费请求格式示例
urlencode前内容:
transdata={"appuserid":"username","appid":"3213213","waresid":1}&sign=xxxxxx&signtype=RSA
爱贝云计费业务参数说明
参数名称 |
参数含义 |
数据类型 |
是否可选 |
参数说明 |
appuserid |
用户的应用账号 |
String(32) |
必填 |
用户在商户应用的唯一标识 |
appid |
应用编号 |
String(20) |
必填 |
平台分配的应用编号 |
waresid |
商品编号 |
integer |
必填 |
应用中的商品编号 |
Sign |
对transdata的签名数据 |
|
必填 |
对transdata的签名数据 |
Signtype |
签名算法类型 |
|
必填 |
签名算法类型,目前仅支持RSA |
返回参数及格式
成功应答数据样例(urlencode前内容):
transdata={"feetype":"6","leftcount":2,"subsstatus":0}&sign=xxxxxx&signtype=RSA
爱贝云计费成功应答参数说明:
参数名称 |
参数含义 |
数据类型 |
是否可选 |
参数说明 |
feetype |
计费类型 |
integer |
必填 |
计费类型,具体定义见附录 |
leftcount |
剩余次数 |
integer |
可选 |
剩余次数,对于包次数类契约有效 |
endtime |
截止时间 |
String(20) |
可选 |
契约的有效截止时间,格式为“HHHH-MM-DD HH24:MI:SS” |
subsstatus |
契约状态 |
integer |
必填 |
契约状态: 0 – 正常 1 – 退订 2 – 暂停 |
Sign |
对transdata的签名数据 |
|
必填 |
对transdata的签名数据 |
Signtype |
签名算法类型 |
|
必填 |
签名算法类型,目前仅支持RSA |
失败应答数据样例(urlencode前内容):
transdata={"code":"1001","errmsg":"签名验证失败"}
爱贝云计费失败应答参数列表:
参数名称 |
参数含义 |
数据类型 |
是否可选 |
参数说明 |
code |
错误代码 |
String(4) |
必填 |
请求失败时,返回的错误代码。具体定义参见简介及注意事项 |
errmsg |
错误信息描述 |
String(64) |
必填 |
错误原因描述 |
Sign |
对transdata的签名数据 |
|
必填 |
对transdata的签名数据 |
Signtype |
签名算法类型 |
|
必填 |
签名算法类型,目前仅支持RSA |