测试与排查 Polar

先完成通用付款测试配置，再执行以下 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 成功网址是已追踪页面，并包含：

checkout_id={CHECKOUT_ID}

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

连接失败

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