Balanceless Response & Error Codes

Status Codes

Status Code	HTTP Code	Description
200	OK	Balances list retrieved successfully.
200	OK	Balance created successfully.
200	OK	Balances details retrieved successfully.
200	OK	Balance updated successfully.
200	OK	Successfully retrieved cards linked to the Balance.
200	OK	Successfully retrieved card details.
200	OK	Card updated successfully.
200	OK	The card details link was successfully generated.
200	OK	Transfer was successful.
200	OK	Successfully retrieved transactions.
201	Created	Card was created successfully.
204	No Content	Balance was successfully blocked. Blocking of cards linked to this Balance has been initiated.
204	No Content	Balance was successfully unblocked. Unblocking of cards linked to this Balance has been initiated.
204	No Content	Balance was successfully closed. Closing of cards linked to this Balance has been initiated.
204	No Content	The card was successfully blocked.
204	No Content	The card was successfully unblocked.
204	No Content	The card was successfully closed.
204	No Content	The Card details link was successfully deleted.
400	Bad Request	Bad Request. Refer to the Validation Error Codes Guide for a list of possible error codes.
401	Unauthorized	Unauthorized access, authentication required.
403	Forbidden	Forbidden, you don’t have permission to access this resource.
404	Not Found	Resource not found.
409	Conflict	Logical error. Refer to the relevant Error Codes Guide for details.
500	Internal Server Error	An internal server error occurred. Retry if retryable=true.

Error Codes and Descriptions for 409 response code:

Error	Description
AUTO_CLOSURE_BEFORE_VALID_TO	The autoClosureDate is earlier than validTo.
AUTO_CLOSURE_EXCEEDS_MAX_ALLOWED	The autoClosureDate exceeds the configured maximum date.
AUTO_CLOSURE_IN_THE_PAST	The autoClosureDate is earlier than the current time.
AVAILABLE_BALANCE_MIN_GREATER_THAN_MAX	The provided minimum available balance is greater than the maximum.
CARD_CREATION_LIMIT_REACHED	The maximum number of card creations has been reached.
CARD_MODEL_NOT_ALLOWED	The card model is not supported by the provided card type.
CARD_TYPE_UNAVAILABLE	The card type provided is not available.
CLOSURE_END_DATE_BEFORE_START_DATE	Closure end date is before the start date.
CREATION_END_DATE_BEFORE_START_DATE	Creation end date is before the start date.
CURRENCY_NOT_ALLOWED	The selected currency is not permitted for this operation.
CUSTOM_REFERENCE_NOT_UNIQUE	Custom reference provided is not unique.
DEFAULT_WALLET_CLOSURE_NOT_ALLOWED	Default wallet not allowed for closure.
DESTINATION_INSTRUMENT_BLOCKED	Destination instrument is currently blocked.
DESTINATION_INSTRUMENT_NOT_FOUND	Destination instrument was not found.
DESTINATION_INSTRUMENT_TYPE_NOT_ALLOWED	Destination instrument type is not allowed.
DESTINATION_SAME_AS_SOURCE	Source and destination instruments cannot be the same.
END_DATE_BEFORE_START_DATE	End date is earlier than start date.
FOREX_NOT_SUPPORTED_FOR_TRANSACTION	Forex is not supported for this transaction.
INSTRUMENT_NOT_EMPTY	The instrument is not empty.
INSTRUMENT_STATE_INVALID	Invalid instrument state.
LINK_NOT_FOUND_OR_EXPIRED	No active or valid link found for the card reference.
MAX_DATE_RANGE_31_DAYS	Date range exceeds the maximum of 31 days.
NAME_NOT_UNIQUE	The provided name is not unique.
NOT_ENOUGH_FUNDS	Insufficient funds for the operation.
RANGE_START_DATE_OLDER_THAN_1_YEAR	Range start date is older than 1 year.
RANGE_START_DATE_OLDER_THAN_1_YEAR	Start date is older than one year.
SOURCE_INSTRUMENT_BLOCKED	Source instrument is currently blocked.
SOURCE_INSTRUMENT_NOT_FOUND	Source instrument was not found.
SOURCE_INSTRUMENT_TYPE_NOT_ALLOWED	Source instrument type is not allowed.
SPEND_LIMIT_NOT_ALLOWED	The specified spend limit is not supported.
SPEND_LIMITS_NOT_AVAILABLE	Spend limits are not configured.
TOO_MANY_TRANSACTIONS	Transaction count has exceeded the allowed limit.
TRANSFER_AMOUNT_TOO_LARGE	The transfer amount exceeds the allowed limit.
TRANSFER_AMOUNT_TOO_SMALL	The transfer amount is below the allowed minimum.
TRANSFER_CURRENCY_DIFFERENT_FROM_SOURCE_AND_DESTINATION	Transfer currency differs from source or destination currency.
TRANSFER_CURRENCY_MISMATCH	Transfer attempted across mismatched wallet currencies.
UNKNOWN_ERROR	An unknown error occurred. Contact support.
VALID_FROM_AFTER_OR_EQUAL_TO_VALID_TO	The validFrom must be earlier than validTo.
VALID_FROM_IN_THE_PAST	The validFrom is earlier than the current time.
VALID_TO_EXCEEDS_AUTO_CLOSURE_OR_EXPIRY_DATE	The validTo exceeds the expiry date or autoClosureDate.
VALIDITY_PERIOD_INCOMPLETE	Only one of validFrom or validTo was provided; both must be provided or both omitted.