Error Codes

Quick reference for common error codes and their meanings

When calling Checus payment services, if the request fails, the system will return the following error codes. Please locate the problem based on the error code and description, and correct it promptly.

Type	Error Code	Description	Explanation
Request Processing	APPLY_SUCCESS	Application Successful	Only indicates successful request acceptance, please use status field to determine transaction status
System Exception	SYSTEM_ERROR	System Error	Checus system internal exception
		UNEXPECTED_ERROR	Unknown Error	Abnormal status, please contact technical support
Signature/Permission	SIGN_VERIFY_FAILED	Signature Verification Failed	Signature error, need to check signature logic and key configuration
		AUTHENTICATE_FAILED	Authentication Failed	Authentication process not passed
		AUTH_FAILED	Authorization Invalid or Failed	Unable to complete user authorization
		AUTH_EXPIRED	Authorization Expired	Authorization code timeout or invalid
Request Timeout/Rejection	REQUEST_TIMEOUT	Request Timeout	Request did not respond within specified time
		PAYMENT_REJECTED	Request Rejected	Usually intercepted by system due to risk control or non-compliant parameters
		ISSUER_PAYMENT_REJECTED	Third Party Payment Rejected	Usually rejected by issuing bank/payment channel
Merchant/Contract	MERCHANT_INVALID	Merchant Invalid	Merchant information not registered or status abnormal
		MERCHANT_APP_INVALID	Merchant APP Invalid	app_id does not exist or not authorized
		CONTRACT_INVALID	Contract Invalid	No valid contract between merchant and payment method
		ONBOARD_ERROR	Merchant Not Completed Registration	Merchant has not completed registration process
		DECLINED_BY_MERCHANT_BLACKLIST	Merchant Blacklist Intercepted	Intercepted by risk control policy
Order	ORDER_NOT_EXIST	Order Does Not Exist	Order queried or operated is invalid
		ORDER_CLOSED	Order Closed	Order has been cancelled or automatically closed due to timeout
		ORDER_REPEAT	Duplicate Order	Please confirm if duplicate order number was submitted
Payment Method/Account	PAYMENT_METHOD_NOT_EXIST	Payment Method Does Not Exist	Payment method specified in request is invalid
		PAYMENT_METHOD_SUSPEND	Payment Method Unavailable	This method is temporarily closed or disabled
		ACCOUNT_INVALID	Account Invalid	User bank account abnormal
		BALANCE_INSUFFICIENT	Insufficient Balance	Insufficient balance in merchant or user account
		ACCOUNT_BLOCKED	Account Blocked	User or merchant account abnormal
Payment Method/Account	PARTICIPANT_INVALID	Split Payment Participant Invalid	Sub-account information error
Amount/Currency	COUNTRY_INVALID	Country Information Invalid	Country code error or not supported
		CURRENCY_INVALID	Currency Invalid	Unsupported currency
		AMOUNT_LIMIT	Amount Exceeds Limit	Exceeds supported amount range
		AMOUNT_LIMIT_MINIMUM	Amount Below Minimum Limit	Below supported minimum amount
		AMOUNT_LIMIT_MAXIMUM	Amount Above Maximum Limit	Exceeds supported maximum amount
Amount/Currency	AMOUNT_INVALID	Amount Format Error	Invalid amount format
Verification/Verification Code	OTP_VERIFY_LIMIT	OTP Verification Limit Exceeded	Exceeds OTP verification attempt limit
		OTP_VERIFY_FAILED	OTP Verification Failed	Incorrect verification code entered
		OVER_VERIFY_LIMIT	Too Many Verification Attempts	Risk control triggered
		PIN_VERIFY_LIMIT	PIN Verification Limit Exceeded	Multiple errors triggered limit
		PIN_INVALID	PIN Code Invalid	User input error
Barcode/QR Code	BARCODE_REFRESH_LIMIT	Barcode Refresh Too Frequent	Refresh request too frequent
		BARCODE_REFRESH_FAILED	Barcode Refresh Failed	Channel or system exception
Bank Card Information	CARD_INVALID	Card Number Invalid	Card number format or content illegal
	CARD_EXPIRE_DATE_INVALID	Card Expiry Date Invalid	Card expired or format error
		CARD_HOLDER_NAME_INVALID	Cardholder Name Invalid	Does not match card information
		CVV_INVALID	CVV Code Error	Security code invalid
		UNSUPPORT_CARD	Unsupported Card Type	Current channel does not support this card
Contact/Identity	PHONE_NUM_INVALID	Phone Number Invalid	Mobile number format incorrect
		ID_NUM_INVALID	ID Number Invalid	ID format or content error
		EMAIL_INVALID	Email Address Error	Email format non-compliant
		DOCUMENT_INVALID	Document Invalid	Uploaded file does not meet specifications
		DATE_INVALID	Date Format Error	Date field filled illegally
		PAYEE_NAME_INVALID	Payee Name Invalid	Does not match account opening information
		REMARK_INVALID	Remark Invalid	Unsupported remark content
Payment Status	PAYMENT_PROCESSING	Payment Processing	Processing in progress, please wait for final result
		PAYMENT_FAILED	Payment Failed	Channel or user side failure
		PAYMENT_CANCELED	User Canceled Payment	User actively canceled on third-party page
Refund	REFUND_FAILED	Refund Failed	Refund operation not successful
		REFUND_NO_INVALID	Refund Number Invalid	Refund record queried does not exist
		REFUND_INSUFFICIENT_BALANCE	Insufficient Balance for Refund	Merchant account has insufficient balance