自有虚拟商品充值

更新记录

  1. 2016/05/29 更新:输入参数增加充值账号 account

  2. 2017/11/21 更新:增加活动中奖虚拟商品流程

虚拟商品定义

由开发者自己平台直接向用户提供充值的商品,如:会员等级,虚拟礼品,游戏点数,虚拟货币等。 如果要使用虚拟商品充值,需开发虚拟商品充值接口和回调兑吧的接口。

虚拟商品兑换流程图:

1普通兑换虚拟商品充值流程

虚拟商品流程图

2.活动中奖领奖虚拟商品充值流程:

如果虚拟商品配置到活动抽奖中,中奖领奖的流程和普通兑换是有一些区别的,中奖虚拟商品是在扣积分请求和结果通知请求之后,并且活动抽奖中奖虚拟商品才会请求虚拟商品接口,具体流程图如下

虚拟商品流程图

注意:

1.活动中奖虚拟商品的兑吧订单号是活动中奖领奖订单号,并不是扣积分请求的兑吧订单号,请不要把虚拟商品充值请求的兑吧订单号和活动扣积分请求中的兑吧订单号进行关联。

2.同时,虚拟商品抽奖会存在免费抽奖抽中虚拟商品的情况,所以活动中奖的虚拟商品充值请求会存在开发者订单号(developBizId)为空的情况。

一、虚拟商品充值接口

接口定义:

用户下单之后,兑吧会通过该接口向开发者发起一个虚拟商品的充值请求,开发者需在收到请求后处理该订单,为用户充值。(见文档末尾流程图)

使用前提:

开发者配置了虚拟商品充值接口。

使用说明:

兑吧在创建虚拟商品订单并扣除积分成功之后,会通过此接口向开发者发起虚拟商品充值请求。

  1. 兑吧等待超过5分钟没有收到通知响应(见 :二、通知接口),则进入异常超时流程,兑吧会把该条订单标记为超时订单,在开发者订单页面,提供手动操作行为。
  2. 充值结果成功,则订单成功,走成功兑换流程。充值结果失败则订单失败。

接口参数说明:

输入参数(Get请求方式传参):

参数 是否必须 参数类型 限制长度 参数说明
appKey yes string 255 接口appKey,应用的唯一标识
orderNum yes string 255 兑吧订单号
developBizId yes string 255 开发者订单号
uid yes string 255 用户id
params yes string 255 虚拟商品标识符
timestamp yes long 20 1970-01-01开始的时间戳,毫秒。
sign yes string 255 签名,详见签名规则
description no string 255 文案描述(来源活动名称)
account no string 255 用户兑换虚拟商品时输入的账号,只有在打开虚拟商品账号输入开关时,会传输此参数。

响应参数:

参数 是否必须 参数类型 限制长度 参数说明
status yes string 255 success成功,fail失败,process处理中
credits yes long 255 用户当前最新积分
supplierBizId yes string 255 订单流水号,开发者返回给兑吧的凭据
errorMessage yes string 255 status=fail返回的失败原因,成功可不填

响应示例: 成功: {status:"success",credits:"10", supplierBizId:"no123456"}

处理中: {status:"process ",credits:"10" , supplierBizId:"no123456"}

失败: {status:"fail ", errorMessage:"签名签证失败", supplierBizId:"no123456"}

二. 虚拟商品通知接口:

接口地址:

http://www.duiba.com.cn/confirm/confirm?

使用情景:

兑吧发起虚拟商品充值请求时,没有收到开发者响应或响应"process"时,则订单状态一直为处理中,等待开发者通知响应。(见文档末尾流程图)

使用说明:

兑吧发起虚拟商品充值请求时,没有收到开发者响应时,兑吧一直等待开发者回调通知。 若超过5分钟未收到通知,则进入异常超时订单列表,供开发者人工处理。 通知响应成功,则订单成功,进入成功兑换流程,通知响应失败,则订单失败,则进入失败流程。 若开发者发出了回调通知,却没有收到兑吧ok响应时,开发者需重试5次,每次间隔10分钟。

接口参数说明:

输入参数:

参数 是否必须 参数类型 限制长度 参数说明
appKey yes string 255 接口appKey,应用的唯一标识
orderNum yes string 255 兑吧订单号
success yes string 255 兑换成功(true)/失败(false)
errorMsg yes string 255 本次兑换的失败原因,成功可不填
credits yes long 255 用户当前的积分数
timestamp yes long 20 1970-01-01开始的时间戳,毫秒。
sign yes string 255 签名

响应参数:

兑吧处理成功之后,将返回字符串 ok ,除了 ok 之外,其他返回值意味着处理失败或者未收到通知,需重复通知(建议重试5次,每次间隔10分钟)。

响应示例:

成功:ok
失败:fail(或者除ok以外任何响应)

(针对原有虚拟商品接口)变更说明:

兑吧针对虚拟商品的接口设计进行了优化,避免了原有方案中,由于网络原因造成的虚拟商品充值成功但兑吧系统订单失败的情况。 建议需要使用虚拟商品功能的开发者都进行升级。
新流程的主要改动为:用户进行了虚拟商品兑换之后,开发者接到扣积分请求的时候,不要同步做充值逻辑。等兑吧通过新的充值接口发送充值请求的时候,再进行充值行为。

results matching ""

    No results matching ""