自有虚拟商品充值

一.接口说明

自有虚拟商品定义

自有虚拟商品是指开发者自身系统发放的虚拟类商品，商品包含：虚拟卡券，虚拟礼品，游戏点卡，虚拟货币，积分奖励，电子券等。商品是有开发者自己接口或者平台给用户发放。

二.使用方式

如果开发者需要在兑吧商城发放虚拟商品用来做普通商品兑换，或者作为活动奖品给用户发放。就需要先对接虚拟商品充值接口。通过虚拟商品充值接口给用户发放自身系统的虚拟商品。

1.接口说明

如果要使用虚拟商品充值，必需对接虚拟商品充值接口。虚拟商品充值接口用于请求开发者服务器为用户完成充值。

2.接口响应

1.同步响应充值结果

如果开发者充值接口可实时响应充值结果（成功or失败），可以只对接虚拟商品充值接口。

2.异步响应充值结果

如果开发者虚拟式商品充值是异步完成，需要接口想要处理中（process），同时需要额外对接虚拟商品通知接口，开发者服务器在充值后异步通知兑吧充值结果（流程图红框部分）。 注意：如果响应超时或者响应异常，兑吧也会将订单状态标记为处理中，同样需要调用虚拟商品通知接口。

三.虚拟商品充值流程图

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

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

四.注意：

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

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

2.请不要把虚拟商品充值请求的兑吧订单号和活动扣积分请求中的开发者订单号进行关联。

活动中奖虚拟商品的充值请求中，开发者订单号（developBizId）存在为空的情况 。当活动存在免费抽奖的情况时，免费抽奖是没有扣积分请求的，所以不会有开发者订单号。

3.接口充值超时响应处理

兑吧等待超过5分钟没有收到充值通知响应(通知接口)，则进入异常超时流程，兑吧会把该条订单标记为异常订单，在后台异常订单页面，提供手动操作行为。 充值结果成功，则标记订单成功，走成功兑换流程。充值结果失败则选择订单失败。