虚拟商品充值

虚拟商品定义

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

如果要使用虚拟商品充值,需开发虚拟商品充值接口和虚拟商品通知接口。

一、虚拟商品充值接口

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

开发者处流程:

开发者虚拟商品充值接口对接配置好后,运营可创建虚拟商品,其中标识符由开发者提供,当用户中奖后,兑吧会根据开发者填写的接口地址发送虚拟商品充值请求,开发者根据请求参数中的用户id(uid)以及标识符(params)给用户进行发放奖品。

兑吧服务端处理流程:

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

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

  2. 如果兑吧5分钟内没有收到开发者的通知回调请求(见 :二、通知接口),则订单进入异常超时状态,兑吧会把该条超时订单显示在兑吧后台的异常超时订单页面,可手动标记成功或者失败(开发者手动标记后,不会重复发送虚拟商品充值请求,因此开发者需先确定用户虚拟商品的发放情况,再进行人工手动处理成功或者失败)。

二、虚拟商品通知接口

使用说明:

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

若超过5分钟未收到通知,则进入异常超时订单列表,异常订单可通过回调通知进行处理,告知兑吧最终订单充值状态,也可在兑吧后台的异常超时订单页面进行手动标记成功或者失败(开发者手动标记后,不会重复发送虚拟商品充值请求,因此开发者需先确定用户虚拟商品的发放情况,再进行人工手动处理成功或者失败)。

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

若开发者发出了回调通知,却没有收到兑吧ok响应时,通知接口需重试 5 次,每次间隔 10 分钟。

三、虚拟商品领奖流程图

results matching ""

    No results matching ""