Response codes

This section describes why transactions sometimes fail.

Find the result code for a transaction using the Dashboard:

  1. In the left navigation menu, click Transactions.
  2. Use the search bar or filters to find the transaction that failed, then select it.
  3. The transaction's status, result code, and result description appear at the top of the details panel that appears.
Failed transaction with result code and description.

Failed transaction with result code and description.

📘

The content below does not provide an exhaustive list of transaction failure reasons.

000.400.000: Transaction succeeded (please review manually due to fraud suspicion)

Description: The bank processed the transaction but we have flagged it for risk reasons.

000.400.030: Transaction partially failed (please reverse manually due to failed automatic reversal)

Description: One of the systems processing the transaction was down. In some cases, if the banks' automatic reversal fails, they must manually reverse the transaction.

What to tell your customer?
One of the systems processing the transaction was down. We are working with the acquiring and issuing banks to refund your funds.

100.100.101: invalid creditcard, bank account number or bank name

Description: The transaction failed because:

  • Credit card number, bank account number, or bank name entered incorrectly.
  • Credit card not activated for online transactions.
Try again or contact your bank.

100.100.303: card expired

Description: The transaction failed because the card is expired. The customer should try again with a valid card.

100.100.700: invalid cc number/brand combination

Description: Your customer might be entering all the digits found on the reverse side of their card, instead of only the last three digits for Visa and Mastercard or the last four digits for Amex and Diners. Remember that by default, Amex is not activated unless you have specifically requested it. If you receive this error frequently, Peach Payments recommends showing an image of what a CVV is and clearly specifying to customers during the checkout the amount of digits they need to enter.

What to tell your customer?
Your transaction failed because:

  • Credit card number, CVV, or CVC entered incorrectly.
  • The credit card is not activated for online transactions.
  • The credit card type is not accepted.
Provide the issuing bank of the credit card and the country of issue of the credit card for further assistance.

100.150.200: registration does not exist

Description: No stored card was found for that token.

100.150.202: registration is already deregistered

Description: The stored card was deleted.

100.150.203: registration is not valid, probably initially rejected

Description: The card registration was rejected or did not pass 3-D Secure and therefore the token is invalid.

100.150.203: registration is not valid, probably initially rejected

Description: When the customer tried to register their card for the payment, incorrect or no data was provided which results in the registration being rejected by the issuing bank.

What to tell your customer?
The initial registration phase of the transaction failed, meaning:

  • The registering of the card contained no account holder data.
  • The issuing bank was offline for the initial period of the transaction.
  • Did not pass 3-D Secure resulting in the token not being valid.
Try the transaction again, and if it does not succeed, contact your bank for assistance.

100.300.300: invalid reference id

Description: An example of this is if a refund does not reference a successful debit.

100.300.400: missing or invalid channel id

Description: Your merchant credentials are not correct in the transaction request.

100.350.100: referenced session is REJECTED (no action possible).

Description: An example of this is if you try to refund a rejected debit transaction.

100.380.401: User Authentication Failed

Description: Wrong OTP. This result code signifies that the bank's system was unable to authenticate the user.

What to tell your customer?
Your transaction failed because:

  • You entered the OTP incorrectly.
  • There was a field or system error with the OTP.
Your bank was unable to authenticate you and process the transaction. Try again or contact your bank to find out if there is an issue with the OTP system.

100.380.501: Risk management transaction timeout

Description: The customer probably did not enter their OTP or they might not have been shown the 3-D Secure page because their browser or an extension might have blocked it, or because of an issue with the bank's 3-D Secure server. If the card is 3-D Secure enabled, the customer should receive an OTP during the authentication phase of the payment. The customer's bank handles OTP generation and sending. Peach Payments is not aware of and does not control the 3-D Secure authentication process. The customer's bank also authenticates the payment if the correct OTP is provided and when completed, sends Peach Payments a successful payment response. Note that Peach Payments does not know upfront whether a card is enabled for 3-D Secure.

What to tell your customer?
You might not have entered the OTP in time, your bank card is not enabled for online transactions, or there could be an issue with the bank's 3-D Secure server or transaction approval server. Try again if you know your bank card is activated for online transactions or contact your bank.

100.390.107: Transaction rejected because cardholder authentication unavailable

Description: The transaction failed as it was rejected by the issuing bank:

  • The card holder or issuing bank is not enrolled for 3-D Secure.
  • 3-D Secure card authentication was unsuccessful, for example, if the card holder is not enrolled for 3-D Secure.
  • Card or issuing bank is not 3-D Secure ready.
The customer must contact their bank to check if they are enrolled for 3-D Secure, alternatively they must check themselves if their card is enrolled for 3-D Secure.

100.390.109: Transaction rejected because of VISA status 'U' or AMEX status 'N' or 'U' in 3DSecure program

Description: The bank's 3-D Secure system was experiencing downtime and the transaction could not be processed. Check the Peach Payments status page to see if any systems are down. If they are, ask the customer to wait for the system to come online to continue with their transaction.

100.390.111: Communication Error to Scheme Directory Server

Description: The issuing bank, acquiring bank, or a third-party involved in the transaction process was experiencing downtime. Check the Peach Payments status page to see if any banks or third parties are down. If they are, ask the customer to wait for the system to come online to continue with their transaction.

100.390.112: Technical Error in 3D system

Description: There is an error with the 3-D Secure process at the bank. It could be that their 3-D Secure system is down.

What to tell your customer?
There might be an issue with your bank's 3-D Secure server, check in with your bank.

100.396.101: Cancelled by user

Description: The user started a transaction and then cancelled it or Checkout.

100.396.103: Previously pending transaction timed out

Description: The registration transaction (RG) was not authenticated and timed out. The debit transaction references the registration token so might also fail.

What to tell your customer?
See the explanation for 800.100.152.

100.396.104: Uncertain status - probably cancelled by user

Description: The user started a transaction and then cancelled it or Checkout.

100.400.304: invalid input data

Description: The user started a transaction and then cancelled it or Checkout.

200.100.302: invalid Request/Transaction/Payment/Presentation tag (not present or [partially] empty)

Description: Your merchant credentials are not correct in the transaction request.

600.200.202: Channel/Merchant not configured for this payment type

Description: An example of this is if a customer tries to pay with a payment method, for example, an American Express card, when American Express is not configured for your Peach Payments account.

What to tell your customer?
The payment method that you attempted is not supported, please select another payment method and try again.

600.200.400: Unsupported Payment Type

Description: An example of this error is if you try to execute a payment type (such as rebill) that is not supported for that payment method.

600.200.500: Invalid payment data. You are not configured for this currency or sub type (country or brand)

Description: An example of this is if a customer tries to process an American Express card when American Express is not configured for your Peach Payments account, or if cards issued in a particular country are blocked

700.400.100: cannot capture (PA value exceeded, PA reverted or invalid workflow?)

Description: The pre-authorisation that you are capturing was already captured, you are capturing more than the pre-authorised amount, or you are capturing a reversed pre-authorisation.

700.400.200: cannot refund (refund volume exceeded or tx reversed or invalid workflow?)

Description: The transaction that you are refunding was already refunded or reversed, or you are refunding a value greater than the original amount.

700.400.300: cannot reverse (already refunded|reversed, invalid workflow or amount exceeded)

Description: The transaction that you are refunding was already refunded or reversed, or you are refunding a value greater than the original amount.

700.400.520: refund needs at least one successful transaction of type (CP or DB or RB or RC)

Description: You are trying to refund a transaction that was unsuccessful.

700.400.570: cannot reference a waiting/pending transaction

Description: You are trying te execute a transaction based on a transaction that is still processing, for example, you are trying to refund a transaction, but the debit is not complete.

700.400.700: initial and referencing channel-ids do not match

Description: An example of this is if you try to refund a transaction on a different channel from the original debit, or try to capture and authorise on different channels.

800.100.100: transaction declined for unknown reason

Description: The customer tried to do a transaction but no data or incorrect data was provided for registration, resulting in the transaction being rejected by the issuing bank.

What to tell your customer?
The transaction was declined for an unknown reason (800.100.100 - an error message from your bank). Contact your bank for more information on this failure.

800.100.151: transaction declined (invalid card)

Description: This could occur because:

  • The customer's card might have expired.
  • The card is not registered for online transactions.
The customer should check with their bank why the transaction failed as this is an issue between the customer and their issuing bank.

800.100.152: Transaction declined by authorization system

Description: The risk system of the issuing bank (customer's bank) declined the transactions for account-related reasons, for example:

  • Account closed - customer must contact their bank.
  • Do not honor - customer must contact their bank.
  • Identification required - FICA required; customer must contact their bank.
  • No card record - customer must contact their bank or recheck the card number.
  • No credit account - customer must contact their bank or recheck the card number.
  • No savings account - customer must contact their bank or recheck the card number.
  • Retry the transaction.
  • Refer to card issuer - customer must contact their bank.
  • Suspected malfunction - customer must contact their bank.
  • Violation of law - prohibited.

What to tell your customer?
Your transaction was declined for one of the following account-related reasons:

  • Your bank card or virtual card might not be enabled for online transactions.
  • Another reason which only your bank can communicate with you. Contact your bank as more information on the failed transaction can only be communicated to you by your bank. This information is privy only to the customer and their bank.

800.100.153: transaction declined (invalid CVV)

Description: Card might not be enabled for online transactions or the customer is using the wrong CVV or CVC numbers.

What to tell your customer?
Your transaction has been declined because either an invalid CVV or CVC number was entered or one wasn't entered. If you entered your CVV or CVC correctly and still had your transaction declined, contact your bank and inform them that you are unable to complete e-commerce transactions.

800.100.155: transaction declined (amount exceeds credit)

Description: The risk system of the issuing bank (customer's bank) declined the transactions for account-related reasons, for example:

  • The customer has likely exceeded their available credit limit (not enough funds available).
  • Most banks allow their customers to set their own limits in their banking app. When these limits are set, if the transaction exceeds the limit, the transaction fails.

What to tell your customer?
The transaction failed because of insufficient funds on your card. It is likely that you have exceeded your available funds or the limits set on your banking app.

800.100.157: transaction declined (wrong expiry date)

Description: The transaction failed because the customer entered the wrong card expiry date (printed on the customer's bank card). The customer should double-check their card details before retrying the transaction.

What to tell your customer?
Your transaction was declined because the card number, expiry date, or CVV or CVC was entered incorrectly. Double-check the numbers above and try again.

800.100.158: transaction declined (suspecting manipulation)

Description: There is a limit set by the customer's issuing bank, for example:

  • The customer is attempting and failing multiple transactions by inputting bad data such as a wrong CVV, expiry date, or re-trying transactions in quick succession.
  • The customer's issuing bank suspects fraudulent behaviour or transacting out of the usual transactional categories. As a protective measure, they might fail the transaction.
The customer must contact their issuing bank to learn why the transaction failed.

800.100.162: transaction declined (limit exceeded)

Description: The limit set by the customer's bank has been exceeded. The customer must check their daily limit on their banking app and confirm that their transaction will not take them over the limit.

What to tell your customer?
This transaction failed because you exceeded your limit. This error means that the transaction will bring your bank balance below the limit set by your bank or you have exceeded your transaction limit for that day. Check your daily limit and ensure that you have enough funds in your account to continue with the transaction.

800.100.165: transaction declined (card lost)

Description: Transaction declines occur when the customer's card issuer or bank does not authorise the transaction for reasons such as possible fraud, invalid account information, or a lost or stolen card. In such instances, the customer must contact their bank or card issuer immediately to take corrective measures.

What to tell your customer?
We have checked the transaction and the result code received is "transaction declined". In this case, you must contact your bank to find out why the transaction was declined.

800.100.168: transaction declined (restricted card)

Description: The customer's card issuer declined the transaction as the credit card has some restrictions. The customer must check with their issuing bank what the issue is.

What to tell your customer?
You must contact your issuing bank to learn why this transaction was declined.

800.100.169: transaction declined (card type is not processed by the authorization center)

Description: Transaction failed because:

  • The bank card is not enabled for online transactions.
  • The bank card type is foreign registered and not Visa or Mastercard.
  • There could be an issue with the bank's 3-D Secure server or transaction approval server.
The customer should try again if they know their bank card is activated for online transactions or they should contact their bank for further assistance.

800.100.170: transaction declined (transaction not permitted)

Description: This is a failure with the issuing bank and the cardholder must find out from their bank what caused the transaction to fail.

What to tell your customer?
The transaction was declined by your issuing bank. This means that the issuing bank could not process the transaction because of some rules applied to their system. Contact your bank, as further detail on the failed transaction can only be communicated to you by your bank. This information is privy only to the customer and their bank.

800.100.171: transaction declined (pick up card)

Description: The transaction was rejected by the customer's bank because either:

  • The card has been flagged as a pick up card. In this case, the customer must contact their card issuer (the customer's bank) to learn why the card was flagged as a pick up card.
  • The bank has cancelled the card and the customer might not be aware of this as they might have flagged the card as lost or stolen.

What to tell your customer?
The transaction failed with a "Transaction declined (Pick up card)" error. This could mean one of the following:

  • The card could have been lost and picked up and reported to the bank.
  • Depending on the bank, these cards are normally held for a period and "locked", that is, they fail until the customer signs the card out of the bank's possession.
  • The bank has cancelled the card and you might not be aware of this as they might have flagged the card as lost or stolen.
You must contact your issuing bank in order for them to inform you why this card was flagged as a pick up card.

800.100.174: transaction declined (invalid amount)

Description: The customer is trying to do online payments but is exceeding the amount they are allowed to transact with. The customer must check their daily limits for online transactions and then try again.

What to tell your customer?
The transaction failed with an invalid amount error, indicating that you exceeded your daily limit. Check your daily limit for online transactions with your bank or in your bank app before retrying.

800.100.203: Insufficient Funds

Description: The customer's card has insufficient funds for the transaction. They must check if they have enough funds in their account before trying again.

What to tell your customer?
Check if you have enough funds for the transaction.

800.110.100: duplicate transaction

Description: The issuing bank has identified that the transaction reference, unique ID, or RRN of the transaction is the same as an earlier transaction. Peach Payments must raise this with the acquiring bank of the merchant who can investigate and indicate why the transaction has been flagged as a duplicate.

800.120.103: maximum number of transactions per email already exceeded

Description: The transaction is rejected if it fails velocity checking for the email ID in risk management.

What to tell your customer?
You have transacted too many times in a limited amount of time. Allow some time to elapse before transacting again.

800.140.112: maximum number of registrations of email per credit card number exceeded

Description: When the risk setting is enabled, only one email registration is allowed per card number. This error occurs when trying to register a card and email that was already registered. The customer should either use their registered email or use a new email when registering with an email.

What to tell your customer?
You might have tried to register or transact with a different email on the same card number. This is usually a setting that is enabled on the merchant's website or for their business. Use one email per card number.

800.160.120: Invalid payment data for configured Recurring Transaction Dispatching Type

Description: The API parameters are incorrect for recurring or one-click transactions.

800.700.100: transaction for the same session is currently being processed, please try again later.

Description: A duplicate request was made while another request is still being processed.

900.100.100: unexpected communication error with connector/acquirer

Description: The issuing bank, acquiring bank, or a third-party involved in the transaction process was experiencing downtime. Check the Peach Payments status page to see if any banks or third parties are down. If they are, ask the customer to wait for the system to come online to continue with their transaction.

900.100.202: invalid transaction flow, the requested function is not applicable for the referenced transaction.

Description: An example of this is if the payment method does not support refunds. For example, when an InstantEFT by Peach Payments transaction cannot be refunded from the Peach Payments Dashboard or when a partial refund is triggered on a payment method that does not support refunds. To perform the refund, you must do a manual EFT refund from your bank account to your customer's bank account. For more information on which payment methods support refunds, see the Payment methods section.

900.100.300: timeout, uncertain result

Description: The acquiring bank or a third-party involved in the transaction process was experiencing downtime. Check the Peach Payments status page to see if any banks or third parties are down. If they are, ask the customer to wait for the system to come online to continue with their transaction.

900.100.400: timeout at connectors/acquirer side

Description: The payment request timed out on the payment provider's end. One reason why this occurs is if the customer does not approve the payment provider's authentication request.

900.300.600: user session timeout

Description: Customer session timed out before the customer approved the payment request.

📘

See the error code documentation for a full list of response codes.