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



先完成[通用付款测试配置](https://talivia.com/zh-CN/docs/revenue-guides/testing-payment-providers)，再执行以下 Polar 专项连接与归因检查。

## 连接检查清单 [#连接检查清单]

在 Polar 中为正确的组织创建组织访问令牌，并授予以下权限：

* 读取结账；
* 读取订单；
* 读取组织；
* 读取商品；
* 读取订阅；
* 写入网络回调。

在**网站设置 → 收入 → Polar**中粘贴令牌并选择**连接 Polar**。Talivia 会检测令牌所属组织和生产/测试环境，验证每项权限，创建签名网络回调，导入过去 30 天的订单并同步订阅状态。

无需复制网络回调密钥，也无需创建 OAuth 应用。

## 端到端测试 [#端到端测试]

1. 创建单独的 Talivia 网站，并连接 Polar 测试组织。
2. 从已追踪浏览器会话打开结账。
3. 使用 Polar 测试付款流程完成订单。
4. 确认付款以服务商 **Polar** 出现在 Talivia 中。
5. 打开付款，核对会话、来源、入口页面和金额。
6. 在 Polar 中创建退款，确认同一付款的退款金额已更新。

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

对于结账接口，检查创建的结账，确认 `metadata.talivia_session_id` 等于 `window.talivia.getSessionId()` 返回的值。

对于结账链接和内嵌结账，确认 Polar 成功网址是已追踪页面，并包含：

```text
checkout_id={CHECKOUT_ID}
```

对于订阅或自定义流程，确认 Polar 客户的 `external_id` 与发送给 `window.talivia.identify` 的 `externalCustomerId` 相同。

## 连接失败 [#连接失败]

* \*\*找不到组织：\*\*确认令牌拥有组织读取权限，并且是组织访问令牌。
* \*\*权限错误：\*\*重新创建或更新令牌，授予清单中的全部权限。
* \*\*网络回调错误：\*\*确认已启用写入网络回调并重新连接；Talivia 会修复或重建端点。
* \*\*生产与测试：\*\*Talivia 会自动从令牌检测环境。请将测试和生产环境放在不同 Talivia 网站中，避免混合收入。