本文主要描述平台服务端为商户提供的API接口用于指导商户接入并使用爱贝计费平台的相关能力。
登录令牌认证:商户使用计费平台账号作为用户的应用登录账号时应鼡客户端调用计费平台sdk登录接口会拿到登录令牌,然后再调用本接口获取用户的账号信息
下单:商户调用计费平台sdk支付接口之前需要先調用本接口进行下单获取transid。
支付结果通知:支付完成后计费平台通过本接口向商户后台发送支付结果通知
支付结果查询:商户在发起支付请求后可以调用本接口查询支付结果。
契约查询:商户可以调用本接口查询托管在计费平台的契约数据
契约鉴权:用户在使用商户的業务时,商户可以通过本接口进行使用鉴权
契约退订:商户可以调用本接口将用户的契约进行退订。
接口均采用http协议POST方法。
商户需要鉯应用私钥对请求数据进行签名、使用平台公钥对应答数据进行验签错误应答无须验签。
feetype表示商品采用的计费方式目前定义如下:
0–消费型_应用传入价格
2 –消费型_平台设置价格
因为业务拓展,计费方式定义可能会扩展建议商户不要做严格校验
paytype表示用户采用的支付方式,目前定义如下:
因为业务拓展支付方式定义可能会扩展,建议商户不要做严格校验
code表示计费平台处理请求失败时返回的错误代码目湔定义如下:
1001–应用发起的请求签名验证失败
1002–请求参数错误
2001–登录令牌已过期
2002–登录令牌认证失败
3001–商户订单号已存在
3002–商品数据异常
3003–支付金额为0,不需要支付
3004–用户存在有效契约不需要支付
4001–订单正在处理
5001–用户不存在有效契约
5002–用户契约已过期
5003–用户契约已过完
9999–系统繁忙,请稍后再试
以上主要描述计费平台服务端为商户提供的API接口爱贝服务端接入的简介以及注意事项。