扣积分接口

API文档

常见问题

接口说明

该接口由开发者开放给兑吧

当用户发起兑换请求后，兑吧将会创建一个订单，并发送一条该用户对应的扣积分请求给开发者。

这个请求会包含用户id，兑吧订单号，消耗的积分数，兑换类型等等信息。开发者收到该请求后，请自行在系统中创建订单，并记录请求中的相关信息，同时执行用户积分扣除行为。

如果扣除成功，写入成功的参数和开发者系统的订单号，返回这个响应给兑吧。

如果扣除失败，写入失败的参数，并带上失败原因。兑吧收到失败响应后会将这个兑换订单标记为失败，并转告用户失败原因。

扣积分行为可能会发生超时的情况，对于这种情况，兑吧会将订单标记为失败，并进行失败通知。

扣积分超时处理方式

兑吧向开发者发起扣积分请求时，兑吧设置超时时间为15秒，由于开发者服务器响应过慢，或者网络异常等原因，可能会出现超时情况。 针对超时情况，兑吧将该订单标记为失败，并向开发者发出失败通知。 如果开发者已经扣积分成功了，当收到通知时，需要对用户积分进行回滚。

因为扣积分请求超时，兑吧并没有收到开发者的订单号，因此在发送失败通知时，不会携带bizId数据。 开发者在接受兑吧通知时，请以兑吧订单号orderNum进行处理，而不要根据bizId进行处理！