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

测试与排查 LemonSqueezy

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

查看 Markdown 原文

先用通用付款测试配置分离测试与生产收入,再完成以下 LemonSqueezy 检查。

连接测试模式

  1. 在测试模式下创建或选择 LemonSqueezy 商店。
  2. LemonSqueezy 处于测试模式时创建接口密钥。
  3. 将该商店编号和接口密钥连接到测试 Talivia 网站。

Talivia 会检测接口密钥模式,并使用匹配的 test_mode 值创建网络回调;无需另选环境。

最小测试矩阵

场景Talivia 预期结果
单次订单一笔包含订单金额和币种的付款
注册订阅首次付款及一个有效订阅
订阅续费一笔关联到同一客户的新付款
续费失败或恢复订阅状态改变且不重复计算收入
全额或部分退款保留原始付款并减少净收入
重复网络回调不重复创建付款或订阅

连接失败

  • 确认接口密钥能够读取输入的商店编号。
  • 确认两个值来自同一 LemonSqueezy 环境。
  • LemonSqueezy 返回 401 或 403 时创建新接口密钥。
  • 更换密钥后重新连接;Talivia 会创建新的签名网络回调并删除之前的托管端点。

没有出现付款

打开 LemonSqueezy 的设置 → 网络回调,找到所连接商店的 Talivia 端点。确认投递成功,而且事件属于 Talivia 支持的类型,例如 order_created、subscription_payment_success、order_refunded 或 subscription_payment_refunded。

若端点缺失或 test_mode 错误,请用目标环境的接口密钥从 Talivia 重新连接。

付款未归因

  • **标准链接或浮层:**按结账链接配置,并确认结账从已追踪页面开始。
  • **服务器创建的结账:**按结账接口配置,并确认包含 checkout_data.custom.talivia_session_id。
  • **无法添加元数据:**配置返回网址备用方案。

前两种流程可在网络回调中检查 meta.custom_data.talivia_session_id 是否包含会话。

LemonSqueezy 订阅与续费

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

Polar

选择 Polar 结账流程,并把订单、订阅和退款归因到 Talivia 流量。