> 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/payout/payout-chang-jian-wen-ti/api-gong-neng-yu-cuo-wu-chu-li.md).

# API 功能与错误处理

需要有关 API 功能和错误处理的帮助吗？了解如何检查交易状态并快速高效地排查常见问题。

<mark style="color:purple;">**API功能与错误处理**</mark>

1. 如何检查我的Payout交易状态？

* **Webhook通知**：与我们设置[Webhook URL](/https-coda-payments.gitbook.io-zhong-wen-coda-private-technical-documentation/payout/api-shuo-ming/payout-ding-dan-zhuang-tai-hui-tiao-tong-zhi.md)。我们将通过 Webhook 向您发送有关交易状态更新的通知。
* **检查状态API**：使用我们的[检查状态API](/https-coda-payments.gitbook.io-zhong-wen-coda-private-technical-documentation/payout/api-shuo-ming/payout-ding-dan-zhuang-tai-hui-tiao-tong-zhi.md)获取交易的最新状态。此方法提供每笔交易当前状态的实时更新。
* **Coda后台**：登录[Coda后台](https://portal.coda.co/)并前往并前Payout部分。在此处，您可以一目了然地查看所有交易的状态。

***

2. 如果遇到401 Unauthorized错误，该怎么办？

* 确保JWT token的<kbd>iat</kbd>值為有效且在生成后的5分钟内。

***

3. Payout API是否返回渠道订单ID？我可以使用交易ID来查询状态吗？？

* 返回的ID是Coda Payout ID（类似于Codapay的交易ID）。您可以使用我们的状态查询API来验证请求状态。

***

4. 我可以使用我自己的payout请求ID来查询状态吗？

* 商户生成的请求ID可能与其他ID重复。请使用Coda交易号进行准确的状态查询，因为Coda生成的Payout ID可以确保唯一性。

***

5. Balance API的值是实时的吗？

* 是的，在Coda端配置后是实时的。否则，每日更新一次。

***

6. Webhook通知的间隔是多少？

* Webhook会在状态更新时立即触发。


---

# 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/payout/payout-chang-jian-wen-ti/api-gong-neng-yu-cuo-wu-chu-li.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.