爱贝云计费接口契约退订说明

爱贝云计费接口契约退订功能说明

用户可以对已经完成购买的契约进行退订，退订时会将契约置为退订状态，在该状态下用户仍然可以使用该商品，直到契约失效，但是不再进行自动续费。

接口采用http协议，POST方法。

 

爱贝云计费请求URL

http://ipay.iapppay.com:9999/payapi/subcancel

 

爱贝云计费请求格式示例

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