This document summarizes some common error_msg (or related error information) and their meanings to help you quickly locate the root cause and suggested actions when an error occurs.

Note: If you encounter an error that is not listed below, please first check the order status and gateway response. If the issue persists, contact HaiPay support.

Return failure reason / error_msg	Actual cause / suggestion
Order remains in “processing” status	The recipient needs to log in to their email and click the “confirm receipt” link before the funds can be credited.
NULL	No specific error message returned by the gateway (unknown exception). Please check the order status first; if still abnormal, contact HaiPay support.
Manual processing failed	Manual processing failed. Try again later; if multiple retries still fail, contact HaiPay support.
银行退单 (Bank returned the transfer)	The recipient account is invalid or restricted (e.g., closed, frozen). Ask the recipient to confirm the account status or use another account.
HttpStatus:500	Communication timeout or server-side error. Check the order status; if retrying still fails, contact HaiPay support.
创建收款人失败:is invalid length or format.	Parameter length or format is invalid (e.g., name, ID number, account, etc.). Validate all fields against the API documentation and retry.
HttpStatus:502	Communication timeout or gateway failure. Check the order status; if retrying still fails, contact HaiPay support.
The account cannot be registered with the given information. Please try registering using a different bank account.	The account information does not meet the issuer’s requirements. The account is invalid or not supported. Use a different valid bank account.
java.net.SocketTimeoutException: Read timed out	Read timeout. Check the order status and retry if necessary; if this happens frequently, contact HaiPay support.
创建转帐方式失败:java.net.SocketTimeoutException: Read timed out	Read timeout when creating the payout method. Check the order status and retry if necessary; if frequent, contact HaiPay support.
转账 (Transfer)	The gateway only returns a vague description like “transfer” and no clear cause. Check the order status and bank statement, or contact HaiPay support.
java.net.SocketTimeoutException: connect timed out	Connection timeout. Check the order status and retry if necessary; if the network is normal but this repeats, contact HaiPay support.
Illegal request!	Illegal request or parameter validation/signature failed. Check all request parameters, signature rules, and encoding formats.
The account status does not allow the requested action.	The account status does not allow this operation (e.g., frozen, restricted). The account is invalid. Ask the recipient to contact the bank or use another account.
Server unknown error	Unknown server error or timeout. Check the order status first; if still abnormal, capture the full response and contact HaiPay support.
The information entered does not match our records. Please try again.	Account or identity information does not match bank records. Ask the recipient to double-check name, account, ID information, etc.; if the issue persists, contact HaiPay support.
创建转帐方式失败:Account ID Invalid entry.	Recipient account ID is invalid (account does not exist or is entered incorrectly). The account is invalid; use or correct another account.
付款账号金额不足 (Insufficient funds in the payer account)	The payer account has insufficient balance. Top up the account before initiating the payout, or check for reserved/held amounts.
查询不到付款订单	No payout order record was found. Confirm that the order number is correct and try again; if funds were deducted but the order cannot be found, contact HaiPay support.
可用地址信息不足	Recipient address information is incomplete or does not meet channel requirements. Provide full address info (country, city, detailed address, etc.) and retry.
查询不到付款订单，手动回调	The system could not find the payout order (or query failed), and a manual callback to the merchant has been triggered. Use the merchant portal and final fund status as the source of truth; contact HaiPay support if you have questions.