兑换结果通知接口

API文档

常见问题

接口说明

该接口由开发者开放给橙券积分商城

不管兑换行为最终成功还是失败，橙券积分商城都会向开发者发出通知，汇报兑换结果。

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

无论接受到的结果如何，只要开发者收到该请求，请返回{ "code": 200, "message": "请求通过", "data": { "credits": 100 }}，如果响应不是此结构JSON或者code不为200，橙券积分商城会在24小时内最多重试8次通知。

通知时间间隔为：2m、10m、10m、30m、1h、1h、6h、15h。

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

重复通知处理

由于网络具有不稳定的特性，当橙券积分商城向开发者服务器发送成功/失败通知时，有可能存在橙券积分商城发送了通知，开发者收到了通知并进行了处理。

若此时出现网络故障，开发者响应橙券积分商城失败，橙券积分商城没有收到开发者的响应，橙券积分商城会认为开发者没有收到通知，于是进行重复通知。

此时开发者收到通知后，务必先确认此订单是否已经处理过。如果已经处理过，则忽略此通知，并响应此结构JSON { "code": 200, "message": "请求通过", "data": { "credits": 100 }}。 如果此时开发者忽略订单是否已经被处理过，而直接进行处理，将导致开发者反复向用户返还积分，导致损失！