自有虚拟商品充值

虚拟商品定义

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

一.虚拟商品普通兑换流程图

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

虚拟商品流程图

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

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

虚拟商品流程图

注意:

虚拟商品作为活动奖品配置到奖品中,是和普通兑换虚拟商品有一些不同点,开发者在对接接口时候要注意。

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

2.活动中奖虚拟商品的充值请求中。 开发者订单号(developBizId)存在为空的情况 。因为活动存在免费抽奖的中奖情况,免费抽奖是没有扣积分请求的,所以不会有开发者订单号。

因此,开发者在对接虚拟商品充值请求时候,不能把扣积分请求的兑吧订单号以及开发者订单号作为虚拟商品充值请求中对应订单号做关联

一、虚拟商品充值接口

接口定义

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

使用前提

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

使用说明

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

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

接口参数说明

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

签名规则可参考文档MD5签名规则。对接过程中出现签名问题可通过签名排查工具进行自排查,其他问题,可参考文档常见问题处理

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

注意:
在活动中奖虚拟商品时候,如果是免费参与的活动中奖虚拟商品,此时是不会有开发者订单号(developBizId)的,这时候开发者订单号是为空的

响应参数:

参数 是否必须 参数类型 限制长度 参数说明
status yes string 255 success成功,fail失败,process处理中
credits no 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"}

二. 虚拟商品通知接口

接口地址:

https://activity.m.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 ""