Hosted response codes

Below is a list of the codes and messages you could receive in response to your hosted request.

Code Message Reason
exception.authenticationFailure.noAuth Authentication Failed Authentication Failed
exception.authenticationFailure.noPriv Authorisation Failed Authorisation Failed
exception.cache.invalidResourcePath Invalid Resource Path Resource not found.
exception.config.noCustomerCardDomain No customer-card domain configured Customer-card domain not found for the installation.
exception.config.noReturnUrl No return url provided Return url not configured on customer session.
exception.error.amo CSC Address match only Fraud check fails for "address match only" rule
exception.error.dcr Daily card registrations Fraud check fails for "daily card registrations" rule
exception.error.mcr Max card register Fraud check fails for "max card register" rule
exception.error.ndm CSC No data match Fraud check fails for "no data match" rule
exception.error.nvd Net balance Fraud check fails for "net balance" rule
exception.initialiseHosted.noCustomer Customer not found

No customer found while initializing:

  • a manage cards page, 
  • a transaction
exception.installation.lookup Invalid installation The installation provided is not valid.
exception.landing.invalidFlow Invalid flow provided No flow specified or it is invalid.
exception.manageCards.noRegisteredCards No cards registered

Exception for customer having no cards registered.

exception.manageCards.noRegisteredCards.message Currently you have no registered cards which are available for manage cards. Response message when there are no cards registered.
exception.manageCards.noValidCards No cards active Customer has no card active.
exception.payout.noValidCards No valid cards for withdrawal

Exception when performing a PAYOUT and no cards available.

exception.payout.noValidCards.message Currently you have no registered cards which are available for withdrawal.

Response message when performing a PAYOUT and no cards available.

exception.permission.denied Permission Denied

Exception's message thrown when session details are not valid.

exception.permission.denied.message You do not have permission to perform that action Response message for "permision denied" exception.
exception.resumeFailure.invalidSession Session invalid for resumption When trying to resume a not susspended session.
exception.resumeFailure.noSession No session found

When:

  • trying to resume a session that doesn't exist,
  • it was a problem with retrieving the session,
  • session was already expired or
  • session was not found
exception.skin.installation Skin specified in installation not valid

The skin status is not "VALID" or initializing the resources from the skin has failed.

exception.skin.lookup No skin configured No skin is configured for the current merchant.
exception.skin.merchant.lookup No merchant configured When trying to get the skin for the merchant, if the merchant was not found.
exception.skin.request Skin specified in request not valid

When trying to get the skin for the merchant, if:

  • the skin id is not provided
  • skin is not found
  • provided skin is not the merchant's skin
exception.config.url.not.valid Callback URL is not valid When the callback URL is not a valid URL
exception.request.contentType Content type {0} not supported. Content type application/json required. When the provided content type is not valid. Content type application/json required.
exception.invalid.email Email address provided is not valid When the email address provided in the request is not in a valid format.

Hosted validation response codes

Code Message Reason
validation.transaction.pan Must be 3 or 4 digits When a pan is invalid (null or empty, invalid format or length)
validation.transaction.issueNumber Issue number must be between 0 and 9 Issue number validation on payment or update card
validation.transaction.card.selection Invalid card selection If there are no available cards or a problem occurred in the card selection.
validation.transaction.card.billingAddress Max number of permitted characters is 255 Displayed for an address' element who exceeds the maximum permitted number of characters (e.g. billing address' lines, city, country)
validation.transaction.amount.range Value must be in range If the range restriction is applied and the amount specified is not in the range.
validation.transaction.amount.other The amount you entered must be greater than zero Amount is filled with the "other" string and the "other amount" field is null.
validation.transaction.amount.invalidnumber The amount you entered must be numeric The entered amount is not numeric.
validation.transaction.amount.invalidcsc When a pan is invalid (null or empty, invalid format or length) If the filled csc does not have 3 or 4 digits.
validation.transaction.amount.csc Please provide the CSC number of your credit/debit card. The csc was not specified.
validation.transaction.amount You must enter an amount The amount is missing.
Range.cardRegistration.cardNickname Invalid nickname length. Max number of permitted characters is 20. Max size limit validation for card nickname.
NotEmpty.cardRegistration.cardNickname Please enter a nickname for your card. This will help you quickly identify your card. Not empty validation for card nickname.
NotEmpty.cardRegistration.cardHolder Cardholder name cannot be blank Validation error for card holder name on card registration page
NotBlank.cardRegistration.cardNickname Please ensure nickname consists of more than just spaces. Not blank validation for card nickname.
label.error.maxCardsLimitReached You've reached the maximum number of cards allowed. Error label on "cannot add new card" page.
label.error.cannotDeleteCard You don't have permission to delete cards. Error label on "cannot delete card" page
Invalid.cardRegistration.cardNickname Invalid characters. Only latin alphanumeric characters, spaces and . - '' permitted. Characters-set limitations validation for card nickname.