> ## Documentation Index
> Fetch the complete documentation index at: https://doc.haipay.net/llms.txt
> Use this file to discover all available pages before exploring further.
# 错误返回说明（历史导航 V20260623）
> 历史文档。汇总常见错误返回信息与排查建议，帮助快速定位订单异常、网关返回和接口报错原因。
本文档汇总了部分常见的 `error_msg`（或相关错误信息）及其含义，便于排查问题时快速定位实际原因和处理建议。
> 说明：如遇下表未覆盖的错误，请优先根据订单状态、网关返回信息进行排查，必要时联系 HaiPay 支持。
## 美元代付
| 返回失败原因 / error\_msg | 实际原因 / 处理建议 |
| :- | :- |
| 订单一直是支付中的 | 需要收款人登录其邮箱，点击确认收款链接后才能最终收到钱。请提醒收款人尽快在邮箱中完成确认操作。 |
| NULL | 网关未返回具体错误文案，可能为未知异常。请先检查订单状态，如仍异常请联系 HaiPay 支持处理。 |
| Manual processing failed | 手工处理失败，可稍后重试；如多次重试仍失败，请联系 HaiPay 支持。 |
| 银行退单 | 收款账户无效或存在限制（如销户、冻结等），建议让收款人确认账号状态或更换其他收款账户。 |
| HttpStatus:500 | 通讯超时或服务端异常。请先查询订单状态，若重新发起仍失败，请联系 HaiPay 支持。 |
| 创建收款人失败:is invalid length or format. | 参数格式或长度不符合要求（例如姓名、证件号、账号等）。请校验参数是否符合文档要求后重试。 |
| HttpStatus:502 | 通讯超时或网关故障。请先查询订单状态，若重新发起仍失败，请联系 HaiPay 支持。 |
| The account cannot be registered with the given information. Please try registering using a different bank account. | 账户信息不符合发卡行要求，账户无效或不支持当前业务。请更换其他有效的银行账户。 |
| java.net.SocketTimeoutException: Read timed out | 读取超时。请查询订单状态，必要时可重新发起；若多次出现，请联系 HaiPay 支持。 |
| 创建转帐方式失败:java.net.SocketTimeoutException: Read timed out | 创建转账方式时读取超时。请查询订单状态，必要时重新发起；若多次出现，请联系 HaiPay 支持。 |
| 转账 | 网关仅返回“转账”或类似模糊描述，无法定位具体原因。请结合订单状态、银行流水进一步排查，或联系 HaiPay 支持。 |
| java.net.SocketTimeoutException: connect timed out | 建立连接超时。请查询订单状态，必要时重新发起；若网络环境正常且多次出现，请联系 HaiPay 支持。 |
| Illegal request! | 请求参数非法或签名等校验不通过。请检查请求参数、签名规则、编码格式等是否与文档一致。 |
| The account status does not allow the requested action. | 账户当前状态不允许此类操作（如冻结、受限等），账户无效。请让收款人联系发卡行或更换其他收款账户。 |
| Server unknown error | 服务器未知错误或超时。请先检查订单状态，如仍异常请截图完整响应并联系 HaiPay 支持。 |
| The information entered does not match our records. Please try again. | 账户或身份信息与银行记录不一致。请让收款人核对姓名、账号、证件信息等；如多次失败，可联系 HaiPay 支持协助排查。 |
| 创建转帐方式失败:Account ID Invalid entry. | 收款账户 ID 无效（账户不存在或录入错误），账户无效。请更换或修正收款账户后重试。 |
| 付款账号金额不足 | 付款账户余额不足。请先补足资金后再发起代付，或检查是否存在冻结/保留金额。 |
| 查询不到付款订单 | 暂未查询到对应付款订单记录。请确认订单号是否正确，可稍后重试；如仍查询不到且资金已扣减，请联系 HaiPay 支持。 |
| 可用地址信息不足 | 收款方地址信息不完整或不满足要求。请补充完整地址信息（如国家、省市、详细地址等）后重试。 |
| 查询不到付款订单，手动回调 | 系统未查到订单（或查询异常），已通过人工方式回调商户。请以商户后台及最终资金状态为准，如有疑问请联系 HaiPay 支持。 |
## 越南代付
| 返回失败原因 / error\_msg | 实际原因 / 处理建议 |
| :- | :- |
| 付款账号金额不足 | 联系我们 |
| 出款失败渠道已退回 | 联系我们 |
| 查询不到付款订单 | 联系我们 |
| Your account balance is insufficient | 联系我们 |
| Unexpected end of file from server | 出现这个错误重新下单吗 |
| The amount of the arrival nearly supports the integer | 联系我们 |
| System error | 联系我们 |
| syntax error | 联系我们 |
| SSLHandshakeException: Remote host closed connection during handshake | 联系我们 |
| refund | 核对账号信息 |
| please input correct account name，account name： | 名字错误 |
| NULL | 联系我们 |
| Manual processing failed | 联系我们 |
| get match outbound fee configs from clear service failed | 联系我们 |
| error\_msg | 联系我们 |
| ConnectException: Connection timed out (Connection timed out) | 检查订单状态 |
| Beneficiary account can not receive payment | 联系我们 |
| Bank account is not valid | 核对账号信息 |
| \The gateway did not receive a timely response from the upstream server or application.\
Powered by Tengine\ | 联系我们 |
| \