> For the complete documentation index, see [llms.txt](https://docs.supefina.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.supefina.net/huan-ying-shi-yong-supefina-de-api-wen-dang/dai-fu/ba-xi/dai-fu-shi-bai-yuan-yin-shuo-ming.md).

# 代付失败原因说明

#### 注意：

<sub>代付请求超时仅代表未能在预定时间内获得响应，这并不意味着业务失败。遇到超时情况时，商户应采取以下标准流程：</sub>\ <sub>首先将相关订单标记为挂起状态，随后等待至少2分钟后通过查询接口检索订单状态。切勿在超时后立即尝试重新提交请求，这可能导致重复交易。</sub>\ <sub>因未遵循上述规定流程而造成的任何资金损失，将由责任方全权承担，我司概不负责。</sub>

<table><thead><tr><th width="331">Msg</th><th width="429.818115234375">释义</th><th width="592">建议处理办法</th></tr></thead><tbody><tr><td>Maximum amount exceeded</td><td>超出最大金额</td><td>请检查订单金额是否超过最大限制，或更换其他收款账号</td></tr><tr><td>Minimum amount exceeded</td><td>超出最小金额</td><td>请检查订单金额是否超过最低限制，或更换其他收款账号</td></tr><tr><td>Pix not found</td><td>pix号码不存在</td><td>验证用户账号信息是否正确</td></tr><tr><td>Settlement timeout</td><td>用户银行波动导致的拉单超时失败</td><td>建议稍后重试，或更换其他收款账号</td></tr><tr><td>Account blocked</td><td>用户收款账户被冻结</td><td>建议更换银行账户</td></tr><tr><td>The transaction was rejected by the settlement bank</td><td>该交易被银行拒绝。</td><td>建议用户联系银行确认具体拒绝原因，或更换其他收款账号</td></tr><tr><td>SPI error</td><td>用户银行波动导致的拉单超时失败</td><td>建议稍后重试，或更换其他收款账号</td></tr><tr><td>Declined by beneficiary bank</td><td>被收款银行拒绝</td><td>建议用户联系银行确认具体拒绝原因，或更换其他收款账号</td></tr><tr><td>The transaction was failed due to error on settlement bank</td><td>该交易因结算银行错误而失败</td><td>建议用户联系银行确认具体失败原因，或更换其他收款账号</td></tr><tr><td>Pix format error</td><td>账号错误/格式错误</td><td>检查pix是否正确，或者更换其他收款账号</td></tr><tr><td>Cash-outs are not allowed for legal entities</td><td>法律实体不允许进行现金提取。</td><td>更换其他收款账号</td></tr><tr><td>Settlement failed</td><td>用户银行波动</td><td>请稍后重试，或者更换其他收款账号</td></tr><tr><td>Pix key not exists</td><td>Pix密钥不存在</td><td>请检查收款账号和收款账号吧类型是否不匹配，或者更换其他收款账号</td></tr><tr><td>Invalid account uuid</td><td>无效的uuid</td><td>检查uuid是否正确，或者更换其他收款账号</td></tr><tr><td>account blacklist intercept</td><td>账号被禁用</td><td>更换其他收款账号</td></tr><tr><td>idNumber blacklist intercept</td><td>cpf账号被禁用</td><td>更换其他收款账号</td></tr><tr><td>account blacklist risk control intercept</td><td>账号被风控</td><td>更换其他收款账号</td></tr><tr><td>Account unavailable</td><td>账户不可用</td><td>更换其他收款账号</td></tr><tr><td>Internal server error</td><td>服务器错误</td><td>请稍后重试</td></tr><tr><td>Query dict limit</td><td>因发送无效账号过多，pix查询暂时受限</td><td>请稍后重试</td></tr><tr><td>Account closed</td><td>收款账户已关户</td><td>更换其他收款账号</td></tr><tr><td>Bank system occurred error</td><td>银行系统发生错误</td><td>请稍后重试</td></tr><tr><td>Receipt account exceeds limit</td><td>收款账户超出限额</td><td>更换其他收款账号</td></tr><tr><td>Transação não autorizada</td><td>银行风控</td><td>更换其他收款账号</td></tr><tr><td>title: Limite de consultas excedido, detail: Limite de consultas excedido</td><td>受央行pix限制导致代付失败，失败订单重新提交即可</td><td>请稍后重试</td></tr></tbody></table>


---

# 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.supefina.net/huan-ying-shi-yong-supefina-de-api-wen-dang/dai-fu/ba-xi/dai-fu-shi-bai-yuan-yin-shuo-ming.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.