API Error Codes

When a request fails, the Payment Gateway returns one of the codes below. Use the numeric code for programmatic handling and the error name for logging and support enquiries.

Code	Error name	Description
1	ORDER_ALREADY_EXISTS	An order with the same identifier already exists.
2	ORDER_NOT_FOUND	No order was found for the supplied identifier.
3	ORDER_ALREADY_CANCELLED	The order has already been cancelled.
4	NO_COMPATIBLE_SERVICES_FOUND	No service compatible with the request could be found.
5	CAN_NOT_PROCESS_REQUEST	The request could not be processed.
6	REQUISITES_NOT_FOUND	The requested requisites do not exist.
7	REQUISITES_ALREADY_EXISTS	Requisites with the same details already exist.
8	CAN_NOT_CREATE_NEW_REQUISITES	New requisites could not be created.
9	TERMINAL_NOT_FOUND_EXCEPTION	The specified terminal (X-Terminal-Id) was not found.
10	PAYMENT_ALREADY_EXISTS	A payment with the same identifier already exists.
11	MAX_NUMBER_OF_PAYMENTS_FOR_ORDER_EXCEEDED	The order has reached its maximum number of payments.
12	PAYMENT_NOT_FOUND	No payment was found for the supplied identifier.
13	UNKNOWN_STRATEGY	The requested processing strategy is not recognized.
14	PROCESSING_IMPOSSIBLE	The payment cannot be processed in its current state.
15	CAN_NOT_CANCEL_PAYMENT	The payment cannot be cancelled.
16	CAN_NOT_CONFIRM_PAYMENT	The payment cannot be confirmed.
17	CAN_NOT_FINISH_AUTHENTICATION	Authentication (3DS) could not be completed.
18	REFUNDS_NOT_ALLOWED	Refunds are not allowed for this payment.
19	PAYMENT_PARAMS_NOT_FOUND	The required payment parameters were not found.
20	REFUND_ERROR	An error occurred while processing the refund.
21	VALIDATION_ERROR	One or more request fields failed validation.
22	INCORRECT_PAYMENT_STATE	The payment is not in a valid state for this operation.
23	INTERNAL_SYSTEM_ERROR	An unexpected internal error occurred.
24	EXTERNAL_SYSTEM_ERROR	An error was returned by an external system.
26	INVALID_PAYMENT_FORM_DOMAIN	The payment form domain is invalid.
27	BAD_CREDENTIALS	The supplied authentication credentials are invalid.
28	LIMIT_VIOLATION	The operation exceeds a configured limit.
29	TRANSFER_NOT_FOUND	No transfer was found for the supplied identifier.
30	INCORRECT_TRANSFER_STATE	The transfer is not in a valid state for this operation.
31	TOKEN_NOT_FOUND	The specified payment token does not exist.
32	TOKEN_PROCESS_NOT_ALLOWED	The requested operation is not allowed for this token.
33	CAN_NOT_CANCEL_TRANSFER	The transfer cannot be cancelled.
34	TRANSFER_ALREADY_EXISTS	A transfer with the same identifier already exists.
35	INVALID_TOKEN_TYPE	The supplied token type is invalid.

info

Code 25 is not currently in use. If you receive a code that is not listed here, treat it as an unexpected error and contact Payment Gateway Integration Support.