# 测试与排查 LemonSqueezy (https://talivia.com/zh-CN/docs/revenue-guides/lemonsqueezy/testing-and-troubleshooting)



先用[通用付款测试配置](https://talivia.com/zh-CN/docs/revenue-guides/testing-payment-providers)分离测试与生产收入，再完成以下 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 重新连接。

## 付款未归因 [#付款未归因]

* \*\*标准链接或浮层：\*\*按[结账链接](https://talivia.com/zh-CN/docs/revenue-guides/lemonsqueezy/checkout-links)配置，并确认结账从已追踪页面开始。
* \*\*服务器创建的结账：\*\*按[结账接口](https://talivia.com/zh-CN/docs/revenue-guides/lemonsqueezy/checkout-api)配置，并确认包含 `checkout_data.custom.talivia_session_id`。
* \*\*无法添加元数据：\*\*配置[返回网址备用方案](https://talivia.com/zh-CN/docs/revenue-guides/lemonsqueezy/return-url)。

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