> For the complete documentation index, see [llms.txt](https://docs.coda.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coda.co/https-coda-payments.gitbook.io-zhong-wen-coda-private-technical-documentation/codapay/codapay-jie-ru-chang-jian-wen-ti/zhi-fu-chong-shi-gong-neng.md).

# 支付重试功能

#### 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）轮询以获取最终的决定性状态。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.coda.co/https-coda-payments.gitbook.io-zhong-wen-coda-private-technical-documentation/codapay/codapay-jie-ru-chang-jian-wen-ti/zhi-fu-chong-shi-gong-neng.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.