Error Codes

Error Codes Table

Describes each code, its technical description, functional meaning, possible causes, and examples if applicable.

Code	Technical Description	Functional Meaning	Possible Causes	HTTP Status
U001	INSUFFICIENT_FUNDS	Insufficient funds	The card or account balance does not cover the transaction amount	402 Payment Required
U002	CARD_EXPIRED	Expired card	The payment method has expired and is no longer valid	402 Payment Required
U003	INVALID_CARD	Invalid card	Incorrect card details, mistyped number, or non-existent card	402 Payment Required
U005	AUTHENTICATION_FAILED	Authentication failed	Error during 3DSecure validation or user verification process	401 Unauthorized
U006	PAYMENT_LIMIT_EXCEEDED	Payment limit exceeded	The requested amount exceeds the allowed limit (Not yet implemented)	-
P001	UNEXPECTED_ERROR	Unexpected error or service unavailable	Network failures, provider internal errors, timeouts, invalid signatures, etc.	503 Service Unavailable
X001	OTHERS	Validation or format error	Missing data, invalid field formats, incorrect currency or CVV	400 Bad Request
X002	SYSTEM_FAILURE	Internal system failure	Any unmapped or general system error	500 Internal Server Error