Errors & Error Messages

Tip: Use CTRL + F to search for a specific error message.

Direct Integration Issues

Could Not Communicate With Payment Gateway / Page Timing Out

This is can be caused by one of 3 main issues.

In the majority of cases this is down to port 4430 not being open to outgoing TCP on your server. Your server hosts should be able to open this for you.


To download a port test click here and upload to your server and run in a web browser.


The second cause for this can be in relation to the password being incorrect for the gateway. If you believe this is the issue then you will need to login to the MMS and reset your gateway password (see "Changing Gateway Password" under "Merchant Management System").


The Third cause can be in relation to not properly escaping special characters in the fields passed to the gateway. Ensure the CustomerName, OrderID, OrderDescription all have htmlentites() converting any symbols.


[ASP Classic Users: Please check that the DLL’s are correctly installed]

Error 30 Variable Input Error

Please check that you are using the correct Gateway Details, and not the Merchant Management System login details. (Please see "Gateway Required Resources")

No Routes Found For [Card Type/Currency]

Your Gateway Merchant Account is not set up to accept payments using this card type and/or Currency. You must have a merchant account for the currency that you wish to accept (GBP/USD/EUR). If you need a new route please contact customer.service@paymentsense.com.

Required Gateway Resources

The details that you will require to connect the merchant account to the webshop/external system are:

  1. Gateway MerchantID ("first_six_letters_of_the_company_name" "hyphen" "seven_numerics" eg. TESTPS-1234567). (also known as the merchant ID within the shopping cart integration page) this can be found in the 'Gateway Account Admin' tab, which is beneath 'User Admin' within your Merchant Management System. The gateway ID will be six letters with a hyphen and then some numbers xxxxxx-+++++++ (ECOM GBP). You will have different ones if you have more than one merchant ID.

  2. Gateway Password - (test accounts this is emailed to you when you confirm your email address. Live you would have set this using the link from within the Production account email when you went live).

  3. Port 4430 needs to be open on the merchants server.

  4. Payment Processor Domain needs to be paymentsensegateway.com

Required tag (PaymentMessage.CardDetails.CardName) is missing

CardName has not been submitted.

Required tag (PaymentMessage.CardDetails.CardNumber) is missing

CardNumber has not been submitted.

Required tag (PaymentMessage.CardDetails.ExpiryDate) is missing

Card ExpiryDate has not been submitted.

Required tag (PaymentMessage.CardDetails) is missing

No card details have been submitted.

TransactionDateTime Expired

This message means that either:

The customer has taken too long processing the transaction

Or

The Time and Date is out of Sync on the server hosting the website, so this will need to be checked to ensure that the offset is correct.

Hosted Integration Issues

[Yellow Warning Message] Browser Warning

This is not an error, only a warning that the browser will be navigating from a HTTPS website (SSL secured website) to the HTTP website (unsecured website).

There are two ways to fix this:

  • Get an SSL for the merchant's website (Paymentsense Recommended this option).

  • User the Server Result delivery method (this may require extra implementation).

Error Sending Request

This problem can be caused by a connection with the directory servers as part of the 3D Secure process. This issue is temporary and should be resolved quickly. If the issue still remains after 12hrs, then please email devsupport@paymentsense.com.

Invalid Merchant Details

Within the Merchant Management System please navigate to Account Admin > Gateway Account Admin and un-click the "No external systems will use this account " option. You need to ensure that the correct gateway Merchant ID and Password is being used eg.Gateway MerchantID: (PAYMEN-1234567), Password: (Payment123)[numbers and letters only]

Merchant Doesn’t Exist

The Gateway MerchantID being used is not correct. Please ensure you are using the Gateway MerchantID and not the MerchantID used for logging into the Merchant Management System.

The Gateway MerchantID starts with the first 6 characters of the company name. This can be found in the 'Gateway Account Admin' tab, which is beneath 'User Admin' within your Merchant Management System. The gateway ID will be six letters with a hyphen and then some numbers xxxxxx-+++++++ (ECOM GBP). You will have different ones if you have more than one merchant ID.

Required Gateway Resources

The details that you will require to connect the merchant account to the webshop/external system are:

  • Gateway MerchantID ("first_six_letters_of_the_company_name" "hyphen" "seven_numerics" eg. TESTPS-1234567). (also known as the merchant ID within the shopping cart integration page) this can be found in the 'Gateway Account Admin' tab, which is beneath 'User Admin' within your Merchant Management System. The gateway ID will be six letters with a hyphen and then some numbers xxxxxx-+++++++ (ECOM GBP). You will have different ones if you have more than one merchant ID.

  • Gateway Password - (test accounts this is emailed to you when you confirm your email address. Live you would have set this using the link from within the Production account email when you went live).

  • PreSharedKey - (also known as a secret key) this can be found in your Merchant Management System (MMS) in the 'Account Settings' tab.

  • Hash Method - This is located under the PreSharedKey.

Required Variable MerchantID is missing

The MerchantID variable was not posted to the Hosted Payment Form. You should check the form variables being post to the Hosted Payment Form. This may also be caused by spelling mistakes.

Required Variable: Amount is missing

The Amount variable was not posted to the Hosted Payment Form. You should check the form variables being post to the Hosted Payment Form. This may also be caused by spelling mistakes.

Required Variable: CallbackURL is missing

The CallbackURL variable was not posted to the Hosted Payment Form. You should check the form variables being post to the Hosted Payment Form. This may also be caused by spelling mistakes.

Required Variable: CurrencyCode is missing

The CurrencyCode variable was not posted to the Hosted Payment Form. You should check the form variables being post to the Hosted Payment Form. This may also be caused by spelling mistakes.

Required Variable: HashDigest is missing

The HashDigest variable was not posted to the Hosted Payment Form. You should check the form variables being post to the Hosted Payment Form. This may also be caused by spelling mistakes.

Required Variable: OrderID is missing

The OrderID variable was not posted to the Hosted Payment Form. You should check the form variables being post to the Hosted Payment Form. This may also be caused by spelling mistakes.

Required Variable: TransactionDateTime is missing

The TransactionDateTime variable was not posted to the Hosted Payment Form. You should check the form variables being post to the Hosted Payment Form. This may also be caused by spelling mistakes.

Required Variable: TransactionType is missing

The TransactionType variable was not posted to the Hosted Payment Form. You should check the form variables being post to the Hosted Payment Form. This may also be caused by spelling mistakes.

Security Warning: Hash Digest Does Not Match

There are a number of reasons that can cause this issue. If you are using one of our shopping carts or un-edited sample code:

  • Password does not match the Gateway Password set within the Merchant Management System

  • (please see "Changing the Gateway Password").

  • PreSharedKey does not match that set within the Merchant Management System

  • (please see "Locating the PreSharedKey/Hash Method").

  • Hash Method set for the webshop does not match the Hash Method in the Merchant Management System

  • (please see "Locating the PreSharedKey/Hash Method").

  • or a combination of the above.

If you are using a bespoke system then the issue could be caused by one of the above issues or:

  • The HashDigest being created on the merchants webshop contains variables/values that are different to those being passed to the Hosted Payment Form.

The form was not skinned because the variable MerchantID was not submitted, or invalid

The MerchantID has not been sent to the Hosted Payment Page (please see Required Variable: MerchantID is missing).

TransactionDateTime Expired

This message means that either:

  • The customer has taken too long processing the transaction

  • The Time and Date is out of Sync on the server hosting the website so this will need to be checked to ensure that the offset is correct.

Error Messages

ERROR 1246 or 1247 or 1248 or 1299

Unable to log you in due to Invalid login details. Please check your details and try again. If the error persists please attempt to reset your password and login with the new details.

ERROR 1249

The IP address of the device you are using is not permitted. Please close the browser and try again or try another device. If the issue persists then please email customer.service@paymentsense.com.

The Serialized Data Is Invalid

Please Perform a hard refresh on your browser by holding the CTRL key and tap F5, then attempt to login.

Transaction Messages

3D Secure Status: Attempted

This is sent by the customers banks ACS (3DS Verification page) page. It means that 3D Secure was attempted but could not be completed. This could be due to a time out on the banks side or an issue with the customers banks verification system. The ACS sends back the PaRES (Payment Authorisation Result) with the status set as "A" instead of "Y".

3D Secure Status: Failed

This means that the customer failed the 3D Secure check for their card.

Click here to find out more about 3D Secure.

3D Secure Status: Not Enrolled

The customers bank have not forced them to enroll their card for 3D Secure.

Click here to find out more about 3D Secure.

3D Secure Status: Not Submitted

3D Secure is not active on your account. If you have received an email regarding 3D Secure setup yet the message is still displayed please check it is enabled within the Merchant Management System.

3D Secure Status: Passed

This means that the customer successfully completed the 3D Secure check on their card.

3DS invalid veres from ds

There has been an issue with the 3D Secure set-up on your account. Please contact customer.service@paymentsense.com.

AuthCode: xxxxxxxx

This represents a successful transaction.

Card Declined

This can be caused by 2 main reasons:

  • The customers bank has blocked the card.

  • There are not enough funds available in the account.

For Both of these situations the customer should contact their bank.

Card Declined AVS

The billing address the customer entered does not match the billing address held by their bank.

The AVS Policy looks at the numerical values of Address line 1 and the PostCode.

For Example:


Wrong Format:

Edward Street,

Trdn jdh


Correct Format:

32 Edward Street,

TR14 8PA


Click here to find out more about AVS.

Card Declined CV2

This means that the CV2 for the card that the customer was using for the transaction was incorrect.

The CV2 is the 3 (sometimes 4) digit number found on the back of a bank card.

Card Referred

This is rare but means that the customer's bank was unable to authorise the transaction. The customer will need to contact their card issuer and request that they allow the transaction to go ahead.

CV2 Mandatory

This message occurs when trying to run a recurring/scheduled CrossReference Transaction through a standard merchant account. Please ensure these transactions are run through a recurring merchant account.

If you require a recurring account, please contact customer.service@paymentsense.com.

ERROR

There is an issue with your 3D Secure set-up on your account. Please contact customer.service@paymentsense.com.

FAILED (No ecomm tids for visa delta (“currency code”))

Your account is not set up to accept this card type and currency. Please contact customer.service@paymentsense.com to discuss setting up a new currency.

Invalid Client Pass

This is an issue with your gateway account set-up. Please contact customer.service@paymentsense.com.

Invalid Retailer

There is an issue with your gateway MID and TID.

Please contact our Customer Service team on 0800 103 2959 (or customer.service@paymentsense.com) and let the advisor know that you're getting this error.

Invalid Transaction

There was an issue processing the transaction. Please ask the card holder to contact their card issuer for further information.

Issuer Authentication Expired

These messages appear 2 hours after the transaction was initially carried out. The reason for these issues are due to customers not completing 3D Secure when prompted or the PaRES not being returned to the gateway after 3DS has been completed.

Click here to find out more about 3D Secure.

No Free Tids

This means that the gateway was busy at the time of the transaction. Please wait a few minutes and attempt the transaction again.

Refund Successful

This means that a refund has been processed successfully.

Invalid Card Details

Incorrect card details have been submitted by your customer.

Required Variable: CardName is missing

TheCardName variable was not posted to the Transparent Redirect Page. You should check the form variables being post to the Transparent Redirect Page. This may also be caused by spelling mistakes.

Required Variable: CardNumber is missing

The CardNumber variable was not posted to the Transparent Redirect Page. You should check the form variables being post to the Transparent Redirect Page. This may also be caused by spelling mistakes.

Required Variable: ExpiryDateMonth is missing

The ExpiryDateMonth variable was not posted to the Transparent Redirect Page. You should check the form variables being post to the Transparent Redirect Page. This may also be caused by spelling mistakes.

Required Variable: ExpiryDateYear is missing

The ExpiryDateYear variable was not posted to the Transparent Redirect Page. You should check the form variables being post to the Transparent Redirect Page. This may also be caused by spelling mistakes.

Required Variable: MerchantID is missing

The MerchantID variable was not posted to the Transparent Redirect Page. You should check the form variables being post to the Transparent Redirect Page. This may also be caused by spelling mistakes.