Error messages

Should an error occur, here is a list of all the possible related codes and messages as well as an indication on how to correct it.

Configuration errors  

CodeMessageDescriptionHow to correct this error
1000001Incorrect CredentialsIncorrect username and/or passwordThis error can be caused by an incorrect API username or an incorrect API password. Make sure that all these values are correct. For your security, HiPay Enterprise does not report exactly which value might be erroneous.
1000002Incorrect SignatureThe signature that was sent does not match the requested format. 
1000003Account Not ActiveThe account is inactive. 
1000004Account LockedThe account is locked. 
1000005Insufficient PermissionsYou do not have permission to make this API call. 
1000006Forbidden AccessThe API access is disabled for this account. 
1000007Unsupported VersionThe API version is not supported. 
1000008Temporarily UnavailableThe gateway is temporarily unavailable.Please try again later.
1000009Not AllowedThe request was rejected due to IP restriction.Make sure that the IP addresses of your servers are configured for your account.

Validation errors  

CodeMessageDescription
1010001Method Not AllowedThe specified HTTP method is not allowed for this API call.
1010101Required Parameter MissingA required parameter is missing.
1010201Invalid ParameterA parameter is in an invalid format.
1010202Invalid ParameterA parameter value exceeds the maximum number of characters allowed.
1010203Invalid ParameterA parameter contains non-alphabetic characters.
1010204Invalid ParameterA parameter contains non-numeric characters.
1010205Invalid ParameterThe specified parameter is expected to be in decimal format, but does not appear to be a valid decimal value.
1010206Invalid DateThe specified parameter does not seem to be a valid date.
1010207Invalid TimeThe specified parameter does not seem to be a valid time.
1010208Invalid IP AddressThe merchant entered an IP address that was in an invalid format. The IP address must be in a format such as 123.456.123.456.
1010209Invalid Email AddressThe merchant entered an email address that was in an invalid format.
1010301Invalid Soft DescriptorThe soft descriptor contains invalid characters.
1010401UTF-8 Encoding errorThe merchant sent parameters which are not UTF-8 encoded.

Checkout process  

CodeMessageDescriptionHow to correct this error
1020001No route to acquirerThe requested payment product is not configured for your account.Please contact your account manager to solve this issue.
1020002Unsupported ECIThe specified ECI is not supported by the gateway. 
1020003Unsupported Payment ProductThe specified payment product is not valid.Please make sure that you have specified a valid product code.
CodeMessageDescriptionHow to correct this error
3000001Unknown OrderThe order was not found. 
3000002Unknown TransactionThe transaction was not found. 
3000003Unknown MerchantThe merchant account does not exist. 
3000101Unsupported OperationThe operation is not supported.Please retry the request with a supported operation.
3000102Unknown IP AddressThe IP address cannot be detected. The transaction cannot be processed without a valid IP address. 
3000201Suspicion of fraudThe transaction has been rejected by the financial institution due to suspected fraud. 
3030001Fraud SuspicionThe transaction has been rejected by HiPay due to suspected fraud. 
3040001Unknown TokenThe specified token was not found in the Secure Vault. 
3010001Unsupported CurrencyThe currency is not supported.Please retry the request with a supported currency.
3010002Amount Limit ExceededThe amount exceeds the maximum amount allowed for a single transaction.Please retry the request with a lower amount.
3010003Max Attempts ExceededYou have exceeded the maximum number of payment attempts for this order. 
3010004Duplicate OrderThe order has already been processed. 
3010005Checkout Session ExpiredThis session has expired. The order is no longer valid. 
3010006Order CompletedThe order has already been completed. 
3010007Order ExpiredThe order has expired. 
3010008Order VoidedThe order has been voided. 

Maintenance operations  

CodeMessageDescriptionHow to correct this error
3020001Authorization ExpiredThe authorization has expired. 
3020002Amount Limit ExceededThe amount specified exceeds the allowable limit.Please retry the request with a lower amount.
3020101Not EnabledThe Capture feature is not enabled for the merchant.Please contact your account manager to solve this issue.
3020102Not AllowedYou cannot capture this type of transaction. 
3020103Not AllowedYou cannot partially capture this type of transaction. 
3020104Permission DeniedYou do not have permission to capture this transactionYou are not the owner of this transaction.
3020105Currency MismatchThe currency must be the same for Capture and Authorization.Make sure that currencies are the same and retry the request.
3020106Authorization CompletedThe authorization has already been completed. 
3020107No MoreThe maximum number of allowable captures has been reached.No more capture for the authorization. 
3020108Invalid AmountThe capture amount must be positive.Please retry the request with a positive amount.
3020109Amount Limit ExceededThe capture amount must be less than or equal to the original transaction amount.Please retry the request with a lower amount
3020110Amount Limit ExceededThe partial capture amount must be less than or equal to the remaining amount.Please retry the request with a lower amount.
3020111Operation Not PermittedThe transaction is closed. 
3020112Operation Not PermittedTransaction Declined (Transaction not permitted) 
3020201Not EnabledThe Refund feature is not enabled for the merchant.Please contact your account manager to solve this issue.
3020202Not AllowedYou cannot refund this type of transaction. 
3020203Not AllowedYou cannot partially refund this type of transaction. 
3020204Permission DeniedYou do not have permission to refund this transaction.You are not the owner of this transaction.
3020205Currency MismatchThe refund must be in the same currency as the original transaction.Make sure that the currencies are the same and retry the request.
3020206Already RefundedThis transaction has already been fully refunded. 
3020207No MoreThe maximum number of allowable refunds has been reached. No more refund for the transaction. 
3020208Invalid AmountThe refund amount must be positive.Please retry with a positive amount.
3020209Amount Limit ExceededThe refund amount must be less than or equal to the original transaction amount.Please retry the request with a lower amount.
3020210Amount Limit ExceededThe partial refund amount must be less than or equal to the remaining amount.Please retry the request with a lower amount.
3020211Operation Not PermittedThe transaction is closed. 
3020212Too LateYou are over the time limit to perform a refund on this transaction. 
3020301Not EnabledThe re-authorization feature is not enabled for the merchant.Please contact your account manager to solve this issue.
3020302Not AllowedRe-authorization is not allowed for this type of transaction. 
3020303Cannot ReauthorizeYou can only re-authorize the original authorization, not a re-authorization. 
3020304Max Limit ExceededThe maximum number of re-authorizations allowed for the authorization has been reached. 
3020401Not AllowedYou cannot void this type of transaction. 
3020402Cannot VoidYou can only void the original authorization, not a re-authorization. 
3020403Authorization VoidedThe authorization has already been voided. 

Acquirer’s reason codes 

CodeMessageDescription
4000001DeclinedThe transaction has been declined by the acquirer.
4000002DeclinedThe payment has been refused by the financial institution.
4000003Insufficient FundsThe customer’s account does not have sufficient funds.
4000004Technical ProblemThere was a problem processing this transaction.
4000005Communication FailureThis transaction cannot be processed.
4000006Acquirer UnavailableThis transaction cannot be processed because the acquirer is temporarily unavailable.
4000007Duplicate TransactionThe transaction has already been processed.
4000008Payment cancelled by the customerThe transaction has been cancelled by the customer.
4000009Invalid transactionThe transaction type is not valid.
4000010Please call the acquirer support call numberAn issue occurred with the acquirer: please contact your HiPay account manager.
4000011Authentication failed. Please retry or cancel.The authentication requested by the payment method has failed.
4000012No UID configured for this operationThe payment method used for this transaction is not supported on current account configuration.
4010101Refusal (No Explicit Reason)The transaction has been declined by the card issuer with no given explanation.
4010102Issuer Not AvailableThe authorization centre of the card issuer is not operational at this time.
4010103Insufficient FundsThe cardholder does not have enough funds to make this payment.
4010201Transaction Not PermittedThe transaction is not permitted for this type of card.
4010202Invalid Card NumberThe transaction failed due to an invalid credit card number.
4010203Unsupported CardThe type of card is not supported or is unknown.
4010204Card ExpiredThe transaction has been declined because the expiry date on the card used for payment has already passed.
4010205Expiry Date IncorrectThe transaction has been declined because the expiry date entered for the card used for payment is incorrect.
4010206CVC RequiredThe transaction cannot be processed because no Card Verification Code was provided.
4010207CVC ErrorThe transaction has been declined because the CVC entered does not match the credit card.
4010301AVS FailedThe transaction has been refused because the AVS response returned an “N” value and the merchant account is not able to accept such transactions.
4010302Retain CardThe bank put a hold on purchases due to an issue with the cardholder’s account.
4010303Lost or Stolen CardThe card has been blocked by the card issuer because the cardholder reported it as being lost or stolen (potential fraud).
4010304Restricted CardThe credit card is blacklisted by the card association.
4010305Card Limit ExceededThe transaction would exceed the monthly limit of the card.
4010306Card BlacklistedThe card has been rejected by the bank’s fraud system.
4010307Unauthorized IP address countryThe IP address country used is not authorized.
4010309Card not in authorizer’s databaseThe credit card number is not in an authorized cards database.
40103103DS required but not usedThe transaction requires 3DS authentication but the credit card is not enrolled.
4010312Soft Declined The authorization was declined by the issuer because the transaction was not authenticated