爱贝云计费服务端接入

本文主要描述爱贝云计费平台服务端为商户提供的API接口，用于指导商户接入并使用爱贝计费平台的相关能力。

API接口列表简介

登录令牌认证：商户使用计费平台账号作为用户的应用登录账号时，应用客户端调用计费平台sdk登录接口会拿到登录令牌，然后再调用本接口获取用户的账号信息。

下单：商户调用计费平台sdk支付接口之前需要先调用本接口进行下单获取transid。

支付结果通知：支付完成后计费平台通过本接口向商户后台发送支付结果通知。

支付结果查询：商户在发起支付请求后可以调用本接口查询支付结果。

契约查询：商户可以调用本接口查询托管在计费平台的契约数据。

契约鉴权：用户在使用商户的业务时，商户可以通过本接口进行使用鉴权。

契约退订：商户可以调用本接口将用户的契约进行退订。

接口说明

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

数据传输的时候参数值需要进行urlencode，urlencode规则使用application/x-www-form-urlencoded方式，即空格” ”会被编码成加号”+”。进行urlencode编码时，中文字符采用UTF-8编码。

请求和应答参数均为transdata、sign、signtype。transdata为具体业务参数，数据格式为json格式；sign为transdata的签名数据；signtype为签名算法类型，目前只支持RSA算法。具体呈现方式为transdata=xxxx&sign=yyyy&signtype=RSA，其中yyyy就是对xxxx的签名数据，采用RSA MD5数字签名算法，私钥签名、公钥验签。和Java里面的MD5WithRSA算法一致。

商户需要以应用私钥对请求数据进行签名、使用平台公钥对应答数据进行验签。错误应答无须验签。

通用参数定义

feetype定义

feetype表示商品采用的计费方式，目前定义如下：

0–消费型_应用传入价格

2 –消费型_平台设置价格

3 –订阅型_按时长

4 –订阅型_自动续费

5 –非消费型

6 –订阅型_按次数

因为业务拓展，计费方式定义可能会扩展，建议商户不要做严格校验

paytype定义

paytype表示用户采用的支付方式，目前定义如下：

1 –充值卡

2 –游戏点卡

4 –银行卡

401 –支付宝

402 –财付通

501 –支付宝网页

502 - 财付通网页

403 - 微信支付

5 - 爱贝币

6 - 爱贝一键支付

16 - 百度钱包

30 - 移动话费

31 - 联通话费

32 - 电信话费

因为业务拓展，支付方式定义可能会扩展，建议商户不要做严格校验

code定义

code表示计费平台处理请求失败时返回的错误代码，目前定义如下：

1001–应用发起的请求签名验证失败

1002–请求参数错误

2001–登录令牌已过期

2002–登录令牌认证失败

3001–商户订单号已存在

3002–商品数据异常

3003–支付金额为0，不需要支付

3004–用户存在有效契约，不需要支付

4001–订单正在处理

5001–用户不存在有效契约

5002–用户契约已过期

5003–用户契约已过完

9999–系统繁忙，请稍后再试

以上主要描述计费平台服务端为商户提供的API接口，爱贝服务端接入的简介以及注意事项。