兑换结果通知接口

API文档

常见问题

接口说明

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

不管兑换行为最终成功还是失败,兑吧都会向开发者发出通知,汇报兑换结果。

如果兑换成功,开发者在系统内标记此订单为成功状态即可。如果兑换失败,需判断是否已完成扣积分操作。若已完成,开发者需要将该订单标记为失败,并将之前扣积分接口预扣的积分返还给用户。

无论接受到的结果如何,只要开发者收到该请求,请返回 ok 字符串(不含双引号),如果响应为非 ok 字符串,兑吧会在24小时内最多重试 8 次通知。
通知时间间隔为:2m、10m、10m、1h、2h、6h、15h。

注:出于网络异常的可能性,兑吧可能会对开发者进行重复通知,开发者务必确保一笔订单不进行重复处理,否则将产生严重bug,详细原因参考下述:重复通知处理

重复通知处理

由于网络具有不稳定的特性,当兑吧向开发者服务器发送成功/失败通知时,有可能存在兑吧发送了通知,开发者收到了通知并进行了处理。
若此时出现网络故障,开发者响应兑吧失败,兑吧没有收到开发者的响应,兑吧会认为开发者没有收到通知,于是进行重复通知。
此时开发者收到通知后,务必先确认此订单是否已经处理过。如果已经处理过,则忽略此通知,并响应ok。 如果此时开发者忽略订单是否已经被处理过,而直接进行处理,将导致开发者反复向用户返还积分,导致损失!

请勿限制通知等待时长

有部分订单:如实物类订单,需等待发货之后才会确认订单成功,此类订单可能会隔比较长时间才发订单结果通知。如果限制了通知等待时长会导致部分订单接收不到结果。

results matching ""

    No results matching ""