兑吧APP积分商城虚拟商品接口说明.pdf

2015年6⽉16⽇星期⼆ 虚拟商品充值接⼝使⽤说明 V2.0 （接口改动见末尾说明，初次接入请忽略） ⼀、虚拟商品充值接⼝ 接口定义： 用户下单之后，兑吧会通过该接口向开发者发起一个虚拟商品的充值请求，开发者需在收 到请求后处理该订单，为用户充值。 （见文档末尾流程图） 使用前提： 开发者配置了虚拟商品充值接口 。 使用说明： 兑吧在创建虚拟商品订单并扣除积分成功之后，会通过此接口向开发者发起虚拟商品充值 请求。 1.兑吧等待超过5分钟没有收到通知响应(见 ：二、通知接口)，则进入异常超时流程，兑 吧会把该条订单标记为超时订单，在开发者订单页面，提供手动操作行为。 2.充值结果成功，则订单成功，走成功兑换流程。充值结果失败则订单失败。 注意事项： 1. 开发者若配置好了虚拟商品充值接口，所有虚拟商品将走新的兑换流程。 2. 开发者在调试虚拟商品充值接口时，请勿必下架所有已上架的虚拟商品，将配置了虚 拟商品的活动关闭，以免造成订单失败卡单的现象。 3. 开发者可选择不配置虚拟商品充值接口，老的已上架的虚拟商品兑换，依然维持现有 的流程，将不受影响。 4. 开发者若没有配置虚拟商品充值接口，添加虚拟商品入口将关闭，虚拟商品无法上 架，配置了虚拟商品的活动无法开启。 1 2015年6⽉16⽇星期⼆ 接口参数说明： 输入参数 ： 参数 是否必须 参数类型 说明 appKey yes string 接⼝appKey timestamp yes long 1970-01-01开始时间戳,毫秒 params yes string 虚拟商品标识符 orderNum yes string 兑吧订单号 developBizId yes string 开发者订单号 uid yes string ⽤户id sign yes string 签名 description no string ⽂案描述(来源活动名称) 响应参数： 参数 是否必须 参数类型 说明 status yes string success成功，fail失败，process处理中 credits yes long ⽤户当前最新积分 supplierBizId yes string 订单流⽔号，开发者返回给兑吧的凭据 errorMessage yes string status=fail返回的失败原因,成功可不填 响应示例： 成功 ： {status:success,credits:10, supplierBizId :no123456} 处理中 ： {status:process ,credits:10 , supplierBizId :no123456} 失败 ： {status:fail , errorMessage:签名签证失败, supplierBizId:no123456} 2 2015年6⽉16⽇星期⼆ 二. 虚拟商品通知接口： 使用情景： 兑吧发起虚