测试与排查 Dodo Payments
验证 Dodo 环境、托管网络回调、付款、退款和归因。
先使用通用付款测试配置分离测试与生产收入，再完成以下 Dodo 专项检查。
连接测试账户
在 Dodo 测试环境中创建拥有写入权限的接口密钥，并连接到测试 Talivia 网站。Talivia 会识别密钥属于测试环境还是正式环境，然后调用相应接口验证商户、导入可用历史并创建网络回调。
Talivia 中没有 Dodo 环境选择器。如果当前 Dodo 密钥没有环境前缀，Talivia 会在各服务商环境中验证，并保存验证成功的连接。
最小测试矩阵
| 场景 | Talivia 预期结果 |
|---|---|
| 从已追踪页面点击付款链接 | 付款匹配到来源会话 |
| 通过接口创建结账会话 | 通过 metadata.talivia_session_id 匹配付款 |
| 浮层或内嵌结账 | 与其底层结账会话结果相同 |
| 未访问网站而直接打开链接 | 付款记录为未归因 |
| 全额或部分退款 | 保留原始付款并减少净收入 |
| 重复网络回调 | 不重复创建付款或退款 |
连接失败
- **两个环境都拒绝密钥：**从 Dodo 复制新接口密钥后重试。
- **禁止创建网络回调：**为密钥启用写入权限。
- **找不到商户：**确认密钥所属 Dodo 账户有可用的商户或品牌。
重新连接会更新 Talivia 网络回调网址对应的托管端点。账户或环境改变时，Talivia 会导入新历史并删除之前的托管端点。
没有出现付款
在 Dodo 网络回调设置中，确认 Talivia 端点已启用，并且 payment.succeeded 投递返回成功响应。退款更新需要 refund.succeeded。
若缺少投递，请重新连接 Dodo，让 Talivia 修复网络回调并取回签名密钥。若投递被拒绝，请确认事件来自连接密钥所在的同一 Dodo 环境。
付款未归因
- **付款链接：**通过运行 Talivia 追踪器的页面上的普通链接打开。
- **结账会话、浮层或内嵌结账：**后端创建结账会话时，将当前会话加入
metadata.talivia_session_id。 - **共享原始链接：**买家从未访问已追踪网站时，付款未归因属于预期结果。
请勿将 Talivia 会话编号用于身份验证。它只是一个不透明的归因值。