有赞新零售社区

发帖
API使用问题»积分冻结&消费接口是同步进行吗

[API调用-会员/营销] 积分冻结&消费接口是同步进行吗

有赞逸离 02-17 407 浏览 5 评论 | 只看楼主 [打印]
已有赞商场做核心商场系统,通过api接口增加客户积分,在三方系统上面产生订单,三方系统生成订单前就需要先调积分查询接口,订单生成时就需要调积分冻结接口,支付成功后就需要调积分消耗接口,订单取消就要调积分解冻接口,那这个积分冻结&消费接口有啥用
用手机打开
收藏 ··· 回复
    邮箱1261544955@qq.com

      尊敬的有赞用户 您好,我们已收到您的问题,并已安排相关技术支持正在处理中,请耐心等待。您可以关注之前预留的邮箱1261544955@注意问题解决进度提醒邮件。

        尊敬的开发者😘

        积分冻结&消费接口的核心作用是保证积分操作的原子性和事务性,主要用途如下:

        一、积分冻结接口作用

        预占机制:在订单生成阶段先锁定用户积分(如积分兑换场景需冻结全量积分,积分抵现场景冻结部分积分)
        防止超兑:避免用户同时在多个设备操作导致积分超额使用
        状态隔离:冻结后的积分会从可用积分剥离,既不能重复使用也不会计入可用余额
        二、积分消费接口作用

        最终扣减:在支付成功后才会真正扣除积分(冻结是预扣,消费是终扣)
        事务保障:只有冻结成功的积分才能被消费,形成完整的事务闭环
        状态转换:将积分从冻结状态转为已消耗状态,完成积分生命周期管理
        对比说明:
        您当前的三方系统调用顺序是符合最佳实践的,但要注意:

        如果直接调扣减接口而不用冻结接口,在支付失败时会产生积分丢失风险
        有赞的冻结接口是扩展点,会与交易状态机联动(如自动触发解冻/消费)
        当使用有赞积分商城时,必须通过扩展点对接才能保证积分数据一致性
        相关文档:
        冻结用户积分 https://doc.youzanyun.com/detail/API/0/3073
        消耗用户积分 https://doc.youzanyun.com/detail/API/0/3072

        • 我理解一下,目前的冻结&消费积分接口,是冻结+消耗两个动作,这个接口是在订单生成时调用吗?
          该接口调用成功后,如果订单尚未支付,就会消耗积分吗?
        • 阿文 回复 有赞逸离 02-18
          先冻结 如果订单完成了 在调用消耗接口。你可以在订单生成时调用冻结接口,此时用户的积分相当于被锁定了,但是还没有真正消耗。如果用户退款你需要调用取消冻结积分的接口。

        1跳至
        您需要登录后才可以回帖 登录 | 立即注册

        本版积分规则

        复制链接
        新浪微博
        QQ空间
        微信扫码
        • 回复

        • 评分

        客服工作时间是9:00-18:00,客服妹子当前不在线,若不能及时回复请谅解。试试右上角的搜索吧,论坛有丰富的经验贴、公告贴,相信一定能够帮到您~

        复制成功