支付重试功能

1. 全新的“支付重试（Payment Retries）”功能有哪些变化？

为了减少用户操作阻力并提高转化率，用户很快就能直接在我们的支付失败页面上重试失败的交易，而无需重新发起整个购买流程。

2. 我们需要进行任何开发工作来支持此功能吗？

不需要。此功能会自动对所有 Codapay、Codashop 和 Coda Webstore 的用户开放，您这边无需进行任何开发工作。

3. 我们会收到每一次失败重试尝试的通知回调（Notify Callback）吗？

不会。为了避免向您的系统发送过多垃圾请求，Coda 仅在以下两种情况下发送回调通知：

• 成功 (Success)： 如果任何一次重试成功，我们将返回成功状态。

• 最终失败 (Definitive Failure)： 如果交易最终确定失败（例如，用户超过了重试次数限制、支付会话超时，或所有重试均失败），我们将返回最新的失败交易状态。

4. 如果用户正在尝试重试，查询 API（Inquiry API）会返回什么状态？

如果您查询某个交易 ID 的状态，并且该用户仍有剩余的重试次数（且时间限制未过期），查询 API 将返回 Pending（待处理） 状态。

5. 用户可以重试多少次，有多长时间进行重试？

默认情况下，用户最多可以重试 5 次，并且在首次交易失败后的 60 分钟内可以尝试重新支付。完成单次实际交易的规定时间保持不变（具体取决于所选的支付渠道）。

6. 当支付失败时，用户会看到什么页面？

用户会看到一个支付失败页面，上面有基于具体失败原因的错误提示文案（例如：“钱包余额不足，请充值后重试”），以及一个 “重试支付 (Retry payment)” 按钮。他们也可以选择返回到您的游戏或商品页面。注意：因欺诈或其他封禁原因导致支付失败的用户，将不被允许重试支付。

7. 用户在重试时可以切换支付渠道(Payment Channels)吗？

在初始阶段不可以。切换支付渠道的功能将在稍后的阶段推出，目标是在 2026 年底前上线。在推出该功能时，我们将分享更多详细信息及其技术影响。

8. 这会对我们的每日交易报告和结算产生什么影响？

结算 (Settlement) 和订单核算 (Order Accounting) 将继续使用交易 ID（Transaction ID）。您的每日、每周、每月和自定义日期交易报告也将继续使用交易 ID。

• 为了让商户能够追踪单次的“重试尝试 (attempts)”，我们将在商户后台 (Publisher Portal) 中增加一份新报告。您可以通过以下路径查看：“Transactions（交易）”选项卡 > “More filters（更多筛选条件）” > “Payment details（支付详情）” > “All transaction attempts（所有交易尝试）”。

9. 转化率（Conversion rate）报告的计算会有什么变化？

没有任何变化。转化率仍将按此公式计算：Successful Transactions（成功交易数）/ Initiations（发起笔数）。

10. 当我们收到 "Pending"（待处理）状态时该怎么处理？

当您收到 Pending 状态时，切勿发放游戏内物品，也不要将订单标记为失败。请等待最终的 Webhook 通知，或者使用查询 API（Inquiry API）轮询以获取最终的决定性状态。