Transaction errors

If you're a developer, see our Github repository on how to handle transaction errors.

Errors are either originating from the issuing bank (the bank that issued the card) or from Paylike.

An error originating from an issuing bank is returned when either the customer makes a mistake e.g. by entering the wrong card number or due to the issuing bank rejecting the transaction because e.g. the card has been stolen.

In general, you can not resolve errors from the issuing bank, but must instruct the customer to solve it themselves or have them contact their issuing bank.

Errors originating from Paylike is generally caused by you, the merchant. It can be due to a programming error, missing HTTPS, your account not being approved or a rule enforced by Paylike (e.g. 3-D Secure required, transaction size limit or similar). If you are not able to resolve the error yourself, get in touch.

Quality of errors from issuing banks

The payment system (Visa/Mastercard) is an old system with thousands of issuing banks and in-between processors. Therefore, the quality of the errors we see from the issuing banks and the card network is, unfortunately, quite poor.

Many errors (30-40 %) are therefore mapped to error 8, which is a generic “card was rejected”. This can mean a myriad of things and in general the only way to investigate such an error is to have the cardholder ask their issuing bank for the specific reason as they've send this generic one as a response.

Errors from issuing banks

Error 2: Invalid card

Have the customer check all card details. If the problem persists, have the customer contact their bank.

Error 3: Invalid card number

Have the customer check the card number. If the problem persists, have the customer contact their bank.

Error 4: Invalid CVC (security code)

Have the customer check the CVC (security code), typically found on the back of the card. If the problem persists, have the customer contact their bank.

Error 5: Invalid expire date

Have the customer check the expiry month and year is correct and not overdue. If the problem persists, have the customer contact their bank.

Error 6: The card has expired

The card has expired or the customer added an invalid expiry date. Have the customer try again or try another card.

Error 7: Insufficient funds

There are not enough funds available to cover the purchase. Have the customer try another card or add funds to their account. If the customer has enough funds on the account, the error is most likely due to a card threshold or limit, e.g. daily spending limit. Such limit can often be changed in the customer's eBanking solution. If the problem persists, have the customer contact their bank.

Error 17: Please enter the card number

The customer didn't enter their card number, ask the customer to try again.

Error 18: Please enter the card expiry month

The customer didn't enter their card expiry month, ask the customer to try again.

Error 19: Please enter the card expiry year

The customer didn't enter their card expiry month, ask the customer to try again.

Error 20: Please enter the card CVC (security code)

The customer didn't enter the card CVC (security code) which is typically found on the back of your card, ask the customer to try again.

Error 25: Card amount limit exceeded

The amount limit on the card has been reached. Have the customer contact their bank to reset or increase the limit.

Error 29: Invalid card number or card not supported

The card brand is not supported. If the customer is using a supported payment method please have the customer verify the card number. If the customer is not using a supported payment method, unfortunately, we can't process the transaction.

Error 32: Invalid card number

Have the customer check their card number is correct and make sure 3-D Secure is supported.

If the problem persists, have the customer contact your bank.

Error 8: The card was rejected

The card has been rejected by the customer's bank. Instruct the customer to contact their bank and ask why the card was rejected.

The card may be rejected for a myriad of reasons, ranging from something simple as the card not being enabled for online use, the transaction being caught in the issuing bank's fraud filter. However, it's most likely the issuing bank or card network responding with a generic error instead of a more specific one, e.g. error 10 for a stolen card.

Paylike is not able to provide a more specific reason. The customer must contact their bank to get a more specific reason and ask their bank to help them resolve the issue.

Error 9: The card is restricted

The card is restricted. Instruct the customer to contact their bank and ask why the card is restricted.

Error 10: Card lost or stolen

The card has been blocked and listed as lost or stolen. The customer should contact their bank to resolve this.

Please note, as the card has been marked as lost or stolen, the card details may be in the hands of a criminal and you should therefore be careful if you suspect this. Do not e.g. allow the customer to pay without 3-D Secure.

Error 11: The transaction was rejected

The transaction was rejected for an unknown reason, possibly due to suspicion of fraud.

Errors from Paylike

Error 15: Missing amount, please contact us

When creating the transaction, no amount is sent to Paylike. Ensure your application is sending the correct amount. If you are using one of our plugins or SDK, contact us.

Error 14: Invalid amount, please contact us

When creating the transaction, an invalid amount is sent to Paylike. Ensure your application is sending the correct amount. If you are using one of our plugins or SDK, contact us.

Error 16: Missing currency, please contact us

When creating the transaction, no currency is sent to Paylike. Ensure your application is sending the correct currency. If you are using one of our plugins or SDK, contact us.

Error 1: Invalid currency, please contact us

When creating the transaction, an invalid currency is sent to Paylike. Ensure your application is sending the correct currency. If you are using one of our plugins or SDK, contact us.

Error 22: The amount is above the limit, please contact us

When creating the transaction, the amount sent to Paylike is above the limit of a maximum 9 digits. Ensure your application is sending the correct amount. If you are using one of our plugins or SDK, contact us.

Error 12: An error occurred, please try again or contact us.

This error is typically due to a temporary interruption of service at one of our upstream processors*. Try again 1-3 times, if the error persists, contact us.

* Some have restrictions on their Paylike account, e.g. a limited number of countries they can accept cards from. If you are aware of such a restriction, please check if the transaction is rejected due to it, e.g. check on binlist.net if the country the card is issued in outside the list of countries you can accept cards from.

Error codes are Paylike specific

The error codes we expose are Paylike's own and not e.g. “global” error codes from Visa or Mastercard. Therefore, you are not able to look up these error codes elsewhere.