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  

Code Message Description How to correct this error
1000001 Incorrect Credentials Incorrect username and/or password This 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.
1000002 Incorrect Signature The signature that was sent does not match the requested format.
1000003 Account Not Active The account is inactive.
1000004 Account Locked The account is locked.
1000005 Insufficient Permissions You do not have permission to make this API call.
1000006 Forbidden Access The API access is disabled for this account.
1000007 Unsupported Version The API version is not supported.
1000008 Temporarily Unavailable The gateway is temporarily unavailable. Please try again later.
1000009 Not Allowed The request was rejected due to IP restriction. Make sure that the IP addresses of your servers are configured for your account.

Validation errors  

Code Message Description
1010001 Method Not Allowed The specified HTTP method is not allowed for this API call.
1010101 Required Parameter Missing A required parameter is missing.
1010201 Invalid Parameter A parameter is in an invalid format.
1010202 Invalid Parameter A parameter value exceeds the maximum number of characters allowed.
1010203 Invalid Parameter A parameter contains non-alphabetic characters.
1010204 Invalid Parameter A parameter contains non-numeric characters.
1010205 Invalid Parameter The specified parameter is expected to be in decimal format, but does not appear to be a valid decimal value.
1010206 Invalid Date The specified parameter does not seem to be a valid date.
1010207 Invalid Time The specified parameter does not seem to be a valid time.
1010208 Invalid IP Address The 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.
1010209 Invalid Email Address The merchant entered an email address that was in an invalid format.
1010301 Invalid Soft Descriptor The soft descriptor contains invalid characters.
1010401 UTF-8 Encoding error The merchant sent parameters which are not UTF-8 encoded.

Checkout process  

Code Message Description How to correct this error
1020001 No route to acquirer The requested payment product is not configured for your account. Please contact your account manager to solve this issue.
1020002 Unsupported ECI The specified ECI is not supported by the gateway.
1020003 Unsupported Payment Product The specified payment product is not valid. Please make sure that you have specified a valid product code.
Code Message Description How to correct this error
3000001 Unknown Order The order was not found.
3000002 Unknown Transaction The transaction was not found.
3000003 Unknown Merchant The merchant account does not exist.
3000101 Unsupported Operation The operation is not supported. Please retry the request with a supported operation.
3000102 Unknown IP Address The IP address cannot be detected. The transaction cannot be processed without a valid IP address.
3000201 Suspicion of fraud The transaction has been rejected by the financial institution due to suspected fraud.
3030001 Fraud Suspicion The transaction has been rejected by HiPay due to suspected fraud.
3040001 Unknown Token The specified token was not found in the Secure Vault.
3010001 Unsupported Currency The currency is not supported. Please retry the request with a supported currency.
3010002 Amount Limit Exceeded The amount exceeds the maximum amount allowed for a single transaction. Please retry the request with a lower amount.
3010003 Max Attempts Exceeded You have exceeded the maximum number of payment attempts for this order.
3010004 Duplicate Order The order has already been processed.
3010005 Checkout Session Expired This session has expired. The order is no longer valid.
3010006 Order Completed The order has already been completed.
3010007 Order Expired The order has expired.
3010008 Order Voided The order has been voided.  

Maintenance operations  

Code Message Description How to correct this error
3020001 Authorization Expired The authorization has expired.
3020002 Amount Limit Exceeded The amount specified exceeds the allowable limit. Please retry the request with a lower amount.
3020101 Not Enabled The Capture feature is not enabled for the merchant. Please contact your account manager to solve this issue.
3020102 Not Allowed You cannot capture this type of transaction.
3020103 Not Allowed You cannot partially capture this type of transaction.
3020104 Permission Denied You do not have permission to capture this transaction You are not the owner of this transaction.
3020105 Currency Mismatch The currency must be the same for Capture and Authorization. Make sure that currencies are the same and retry the request.
3020106 Authorization Completed The authorization has already been completed.
3020107 No More The maximum number of allowable captures has been reached.No more capture for the authorization.
3020108 Invalid Amount The capture amount must be positive. Please retry the request with a positive amount.
3020109 Amount Limit Exceeded The capture amount must be less than or equal to the original transaction amount. Please retry the request with a lower amount
3020110 Amount Limit Exceeded The partial capture amount must be less than or equal to the remaining amount. Please retry the request with a lower amount.
3020111 Operation Not Permitted The transaction is closed.
3020112 Operation Not Permitted This transaction cannot be processed because it has been denied by the Fraud Protection Service. You cannot capture a payment after it has been denied by the Fraud Protection Service.
3020201 Not Enabled The Refund feature is not enabled for the merchant. Please contact your account manager to solve this issue.
3020202 Not Allowed You cannot refund this type of transaction.
3020203 Not Allowed You cannot partially refund this type of transaction.
3020204 Permission Denied You do not have permission to refund this transaction. You are not the owner of this transaction.
3020205 Currency Mismatch The refund must be in the same currency as the original transaction. Make sure that the currencies are the same and retry the request.
3020206 Already Refunded This transaction has already been fully refunded.
3020207 No More The maximum number of allowable refunds has been reached. No more refund for the transaction.
3020208 Invalid Amount The refund amount must be positive. Please retry with a positive amount.
3020209 Amount Limit Exceeded The refund amount must be less than or equal to the original transaction amount. Please retry the request with a lower amount.
3020210 Amount Limit Exceeded The partial refund amount must be less than or equal to the remaining amount. Please retry the request with a lower amount.
3020211 Operation Not Permitted The transaction is closed.
3020212 Too Late You are over the time limit to perform a refund on this transaction.
3020301 Not Enabled The re-authorization feature is not enabled for the merchant. Please contact your account manager to solve this issue.
3020302 Not Allowed Re-authorization is not allowed for this type of transaction.
3020303 Cannot Reauthorize You can only re-authorize the original authorization, not a re-authorization.
3020304 Max Limit Exceeded The maximum number of re-authorizations allowed for the authorization has been reached.
3020401 Not Allowed You cannot void this type of transaction.
3020402 Cannot Void You can only void the original authorization, not a re-authorization.
3020403 Authorization Voided The authorization has already been voided.  

Acquirer’s reason codes 

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