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.