测试与排查 LemonSqueezy
验证 LemonSqueezy 连接、网络回调事件和 Talivia 归因。
先用通用付款测试配置分离测试与生产收入,再完成以下 LemonSqueezy 检查。
连接测试模式
- 在测试模式下创建或选择 LemonSqueezy 商店。
- LemonSqueezy 处于测试模式时创建接口密钥。
- 将该商店编号和接口密钥连接到测试 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 是否包含会话。