Error codes

The error codes listed below do not indicate the success or failure of transactions.

To check the transaction status, you must:

• Wait for the callback

• Check the transaction status by OPERATION_ID

• Check the transaction status by merchantRequestId

HTTP Code	msgType	msgCode	msgText
200	ERROR	b_terminal_not_found	@Payment terminal not found
	ERROR	b_merchant_not_found	@Merchant not found
	ERROR	b_reverse_transaction_failed	@Failed to reverse transaction
	ERROR	b_payment_invalid_refund_amount	@Payment invalid refund amount
	ERROR	b_phys_transaction_not_found	@Phys transaction not found
	ERROR	b_cannot_process_logic_transaction	@Cannot process logic transaction
	ERROR	b_authorize_transaction_failed	@Failed to authorize transaction
	ERROR	b_initiate_transaction_failed	@Failed to initiate transaction
	ERROR	b_payment_logic_transaction_not_found	@Payment logic transaction not found
	ERROR	b_explicit_payment_execution_not_supported	@Payment type doesn't support explicit execution
	ERROR	b_payment_not_found	@Payment not found
	ERROR	b_operation_not_found	@Operation not found
	ERROR	b_payment_refund_not_supported	@Payment type doesn't support refund
200	ERROR	b_invalid_request	Invalid request
200	ERROR	b_unsupported_payment_system	Payment system is not supported
200	ERROR	b_validation_card_expiration_date_and_security_code	Value must consist of 7 digits.
200	ERROR	b_invalid_pan_format	Incorrect format of the full card number
200	ERROR	b_payment_invalid_refund_status	@Payment invalid refund status
200	ERROR	b_validation_card_expiration_date	Value must consist of 4 digits
200	ERROR	b_encryptor_failed_decrypt_message	Failed to decrypt message
200	ERROR	b_virtual_device_not_found	Virtual device not found
200	ERROR	b_refresh_token_absent	Refresh token is missing
200	ERROR	b_err_missing_recipient_id	recipientItn or recipientPassport is not specified. One of the parameters is mandatory.
200	ERROR	b_err_invalid_itn_format	Invalid format of recipientItn. Must contain only 10 digits.
200	ERROR	b_overload_error	@Overload error
400	ERROR	b_duplicate_field_value	Value {data} must be unique
400	ERROR	b_request_is_not_correct	Request is not in the correct format
400	ERROR	b_error_parse_json	JSON parse error: {info}
400	ERROR	b_txn_not_allowed	@transaction type is not allowed for this Merchant
400	ERROR	b_failed_to_get_apple_pay_session	@Failed to get apple pay session
400	ERROR	b_user_merchant_request_mismatch	@User's merchant ID doesn't match the merchant ID from request
401	ERROR	b_expired_token	@Token Expired
	ERROR	b_unknown_device	@Unknown Device
401	ERROR	b_used_token	Used token
401	ERROR	b_auth_token_expired	Authentication token expired
401	ERROR	b_previous_auth_token_expired	@Previous Auth Token Expired
404	ERROR	b_service_unavailable	@Service '{service}' unavailable
404	ERROR	payment_operation_not_found	@Payment operation is not found.
404	ERROR	b_hpp_order_not_found	@The HPP order not found
404	ERROR	b_merchant_balances_not_found	@Balance not found.
500	ERROR	b_hpp_order_expired	@The HPP order is expired
500	ERROR	b_unknown_error	Unknown error
503	ERROR	b_server_is_overloaded	@Server is overloaded (must retry the request later)

Example Error Response

{
    "requestId": "29a36a0a-5926-11ed-9b6a-0242ac120002",
    "serviceId": "api-gateway",
    "msgCode": "b_used_token",
    "msgType": "ERROR",
    "msgText": "@Used Token Alert!",
    "isLocalized": false,
    "msgAttrs": {},
    "errorCauses": []
}