自有虚拟商品充值

虚拟商品定义

由开发者自己平台直接向用户提供充值的奖品,如:会员等级,虚拟礼品,游戏点数,虚拟货币等。

如果要使用虚拟商品充值,需开发虚拟商品充值接口和回调兑吧的接口。

虚拟商品兑换流程图:

虚拟商品流程图

一、虚拟商品充值接口

接口定义:

用户中奖之后,兑吧会通过该接口向开发者发起一个虚拟商品的充值请求,开发者需在收到请求后处理该订单,为用户充值。

使用前提:

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

在 兑吧后台 - 配置 - 更多配置 填写虚拟商品充值接口地址

兑吧服务端处理流程:

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

  1. 发送请求后,如果开发者响应充值“成功”/“失败”,则订单直接处理为”成功“/“失败”。 如果开发者响应“处理中”或者无响应,兑吧会标记该订单为“待回调”状态,等待开发者通知接口回调。

  2. 如果兑吧5分钟内没有收到开发者的通知回调请求(见 :二、通知接口),则订单进入异常超时状态,兑吧会把该条超时订单显示在兑吧后台的异常超时订单页面,运营人员可以手动操作成功/失败。

  3. 即使充值接口直接响应成功/失败,也依然需要发送回调通知,以防网络波动导致的充值响应未收到。

接口参数说明:

输入参数:

参数 是否必须 参数类型 限制长度 参数说明
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 MD5签名,详见签名规则
description no string 255 文案描述(来源活动的名称)
account no string 255 用户兑换虚拟商品时输入的账号,只有在打开虚拟商品账号输入开关时,才会传输此参数。

响应参数:

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

响应示例:

成功:

{status:"success",credits:"0", supplierBizId:"no123456"}

处理中:

{status:"process ",credits:"0" , supplierBizId:"no123456"}

失败:

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

二. 虚拟商品通知接口:

接口地址:

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

使用情景:

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

使用前提:

兑吧完成虚拟商品通知接口,供开发者调用。

使用说明:

兑吧发起虚拟商品充值请求后,如未收到开发者响应或响应为“process”,兑吧会一直等待开发者回调通知。

若超过5分钟未收到通知,则进入异常超时订单列表,供运营人员登录兑吧后台人工处理。

回调通知“success=true”,则订单成功,进入成功处理流程;通知“success=false”,则订单失败,订单进入失败流程。

若开发者发出了回调通知,却没有收到兑吧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 credits为0
timestamp yes long 20 1970-01-01开始的时间戳,毫秒。
sign yes string 255 签名

响应参数:

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

响应示例:

成功:ok

失败:(除ok以外任何响应)

results matching ""

    No results matching ""