Talivia 使用文档
Talivia 使用文档
首页数据看板
简介安装团队获取更新
Stripe
Yolfi
Dodo Payments
LemonSqueezy
LemonSqueezy 结账链接LemonSqueezy 结账接口LemonSqueezy 返回网址备用方案LemonSqueezy 订阅与续费测试与排查 LemonSqueezy
Polar
手动付款接口测试付款集成
集成
人工智能代理与模型上下文协议llms.txtllms-full.txt
收入LemonSqueezy

LemonSqueezy 订阅与续费

在订阅注册、续费、失败和生命周期变化中保留归因。

查看 Markdown 原文

首次订阅结账应使用与单次订单相同的 Talivia 会话字段。标准结账链接可自动添加,也可通过结账接口设置 checkout_data.custom.talivia_session_id。

LemonSqueezy 会在首次订单和订阅网络回调中包含该自定义数据。Talivia 会保存 LemonSqueezy 客户与订阅关系,因此后续续费即使没有新的浏览器结账也能保持关联。

Talivia 维护的事件

托管网络回调会处理:

  • 订阅创建与更新;
  • 取消、恢复、暂停、解除暂停和到期;
  • 成功、失败和恢复的订阅付款;
  • 订阅付款退款。

成功的续费账单会成为新的收入付款。付款失败只更新订阅状态,不创建已付收入;退款会减少原始付款的净收入。

保持客户关系稳定

请勿在每次续费或套餐变更时创建新的 LemonSqueezy 客户。保持服务商客户编号和订阅编号稳定,Talivia 才能复用首次结账建立的归因。

续费未归因时,请先确认首次结账包含 meta.custom_data.talivia_session_id,再确认后续事件使用同一 LemonSqueezy 客户和订阅。

LemonSqueezy 返回网址备用方案

无法使用结账元数据时,通过已追踪的返回页面匹配订单。

测试与排查 LemonSqueezy

验证 LemonSqueezy 连接、网络回调事件和 Talivia 归因。