爱贝服务端接入指南.doc

爱贝服务端接入指南 目录 简介及注意事项 2 1. 简介 2 2. API接口列表简介 2 3. 接口说明 3 4. 通用参数定义 3 API接口列表 5 1.登录令牌认证 5 1.1 功能说明 5 1.2 请求URL 5 1.3 请求格式示例 5 1.4业务参数说明 5 1.5示例代码 7 2.下单 7 2.1功能说明 7 2.2 请求URL 8 2.3 请求格式示例 8 2.4 业务参数说明 9 2.5 示例代码 10 3.交易结果回调通知 11 3.1功能说明 11 3.2 请求URL 11 3.3 请求格式示例 11 3.4 业务参数说明 11 3.5 示例代码 12 4.交易结果主动查询 13 4.1 功能说明 13 4.2 请求URL 13 4.3 请求格式示例 13 4.4 业务参数说明 13 4.5 示例代码 15 5. 契约查询 15 5.1 功能说明 15 5.2 请求URL 15 5.3 请求格式示例 15 5.4 业务参数说明 16 5.5 示例代码 18 6. 契约鉴权 18 6.1 功能说明 18 6.2 请求URL 18 6.3 请求格式示例 18 6.4 业务参数说明 19 6.5 示例代码 20 7. 契约退订 20 7.1功能说明 20 7.2 请求URL 21 7.3 请求格式示例 21 7.4 业务参数说明 21 7.5 示例代码 23 简介及注意事项 1. 简介 本文档主要描述计费平台服务端为商户提供的API接口，用于指导商户接入并使用计费平台的相关能力。 2. API接口列表简介 登录令牌认证：商户使用计费平台账号作为用户的应用登录账号时，应用客户端调用计费平台sdk登录接口会拿到登录令牌，然后再调用本接口获取用户的账号信息。 下单：商户调用计费平台sdk支付接口之前需要先调用本接口进行下单获取transid。 支付结果通知：支付完成后计费平台通过本接口向商户后台发送支付结果通知。 支付结果查询：商户在发起支付请求后可以调用本接口查询支付结果。 契约查询：商户可以调用本接口查询托管在计费平台的契约数据。 契约鉴权：用户在使用商户的业务时，商户可以通过本接口进行使用鉴权。 契约退订：商户可以调用本接口将用户的契约进行退订。 3. 接口说明 接口均采用http协议，POST方法。 数据传输的时候参数值需要进行urlencode，urlencode规则使用application/x-www-form-urlencoded方式，即空格” ”会被编码成加号”+”。进行urlencode编码时，中文字符采用UTF-8编码。 请求和应答参数均为transdata、sign、signtype。transdata为具体业务参数，数据格式为json格式；sign为transdata的签名数据；signtype为签名算法类型，目前只支持RSA算法。具体呈现方式为transdata=xxxxsign=yyyysigntype=RSA，其中yyyy就是对xxxx的签名数据，采用RSA MD5数字签名算法，私钥签名、公钥验签。和Java里面的MD5WithRSA算法一致。 商户需要以应用私钥对请求数据进行签名、使用平台公钥对应答数据进行验签。错误应答无须验签。 4. 通用参数定义 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接口列表 1.登录令牌认证 1.1 功能说明 商户使用计费平台账号作