本文档汇总了部分常见的 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 支持。