爱贝云计费接口契约鉴权说明

爱贝云计费契约鉴权功能说明

对于提供契约型商品的应用，应用可以在用户使用商品时调用本接口进行契约的鉴权。对于包时长类型的契约，鉴权成功会返回契约的有效截止时间；鉴权失败则返回错误码。对于包次数类型的契约，鉴权成功会将剩余次数减一，同时返回契约的剩余次数；鉴权失败则返回错误码。

接口采用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