A decline code is generated for all transactions, successful or not. It is crucial for understanding the transaction outcome, assisting merchants and customers. It helps pinpoint the cause of a failed transaction, allowing the merchant to help the customer resolve the issue.
Recommendations for handling this decline code would be to kindly ask the user to re-enter a valid card number or try using a different card for the transaction.
Here is an example of a decline code in a JSON API response from Solidgate for an unsuccessful transaction:
|
|
In this example, the decline code “2.08” represents an invalid card number. The associated decline message is also included in the response, providing merchants with the necessary information to address the issue with the customer.
General decline
These errors reflect declined transactions stemming from bank refusals, order time-outs, compliance issues, or authentication failures.
0.01 General decline
Kindly ask the user to try to pay a couple more times. The chances are high that the next attempt will be successful.
0.02 Order expired
Encourage the user to reattempt the transaction using the same card.
0.03 Illegal operation (violation of law)
Advise the user to use an alternative card.
1.01 Authentication failed
Kindly ask the user to try to pay a couple more times. The chances are high that the next attempt will be successful.
Validation errors
These errors indicate that invalid transaction data can typically be resolved by correcting the input data.
2.01 Invalid Data/Order not found
“Invalid data” code message is used for validation errors, with the reason for the validation triggering specified in the body (object error) of the response.
The problem typically indicates that the information provided in the transaction request is incorrect or incomplete. This can happen for a variety of reasons, such as an incorrect card number or expiration date, an invalid security code, or an incorrect billing address.
Invalid data can also indicate that a required field is missing, such as the cardholder’s name or the transaction amount.
Also, the code message “Order not found” is used as a decline on orders in case of API response to request on non-existent order.
RecommendationsKindly contact Solidgate Support for assistance.
2.02 Invalid Amount
Review the order amount against acquiring bank limits. Adjust or split as needed. For further queries or assistance, contact Solidgate Support.
2.03 Invalid Currency
Kindly contact Solidgate Support. More likely, we will be able to suggest a solution for you.
2.05 Order not found
To troubleshoot this error, it’s recommended to check the order status and the order number, to make sure the order is not cancelled or already processed. Also, it’s important to double-check the order number to make sure it is accurate, as a typo or transposition error could also result in this error. Additionally, it might be useful to check if the order number is not expired.
If the error persists, kindly contact Solidgate Support for assistance.
2.06 Invalid CVV2 code
If it is the first occasion - kindly ask the user to try one more time.
If CVV code error is recurring for the same user - potential card fraud. Act accordingly to your policies.
2.07 Request Is empty
If this error occurs, it is important to check that all required fields for the payment request are properly filled out, and that the customer’s payment method is valid and up-to-date. Additionally, checking for any issues on the application or website that is sending the payment request, and ensuring that the payment processor is functioning properly.It is also possible that the customer’s session has expired or, they have navigated away from the payment page before submitting the payment, so it is important to check that the customer is still on the payment page and their session is still active.
2.08 Invalid card number
Politely ask the user to double-check and re-enter the valid card number. If the problem continues, recommend using an alternative card.
2.09 Invalid expiration date
Kindly ask the user to check the expiration date and, if expired - use another card.
If the user insists that the card expiration date is yet to be, kindly contact Solidgate Support.
2.10 Invalid 3DS flow on the merchant side
Kindly ask a user to recall the step-by-step payment flow and forward information received to Solidgate Support.
2.11 Invalid 3DS flow on the bank side
Kindly ask the user to try one more time or suggest to the user to use another card.
2.12 Invalid 3DS flow
Kindly ask the user to try one more time or suggest to the user to use another card.
2.13 Invalid IP
The merchant must pass a valid IP address in the request.
2.14 Subscription Error
product_id
.
Recommendations
Please note, the user as customer_account_id
can have only one active subscription within the same subscription product_id
.
Check the customer_account_id
of the user who is trying to make a purchase and their active subscriptions.
Make sure that you are using the correct product_id
within your request, as it is an obligatory parameter for the subscription flow that specifies the subscription product.
2.15 SCA require 3D authentication
Retry the transaction with the appropriate 3D authentication process. If you’re unsure how to do this or if the issue persists, please contact Solidgate Support for further guidance.
2.16 Subscription is locked
If an order is still processing, it will not allow “retrofitting” the creation of a subscription and creating another order until the status of the previous one arrives or a certain lock time has passed.
2.17 Coupon is not active
Kindly ask the user to double-check the coupon code and try again, or suggest using an alternative, active coupon.
Transaction declines
Transaction declines arise from factors like card limits, insufficient funds, or fraud concerns, often necessitating bank contact or alternative payment methods.
3.01 Card is blocked
Inform the user that their card has been blocked by the issuing bank, likely due to a triggered limit. Encourage the customer to contact their bank’s support service to request removal of the limit, and suggest trying the payment again, as many banks have dynamic rules based on a scoring system, and repeated attempts can increase the likelihood of successful transactions.
3.02 Insufficient funds
Kindly suggest to the user another card or top-up the current one. Additionally, merchants could allow users to split the payment across multiple cards.
3.03 Payment amount limit excess
Inform the user that the card’s payment or credit limit has been reached, which may be due to various factors such as online payment limits, daily transaction limits, or 3DS authorization limits. Advise the user to contact their issuing bank’s support to inquire about and potentially remove any restrictions. Additionally, suggest that the user try the transaction again, as some banks use dynamic scoring systems where multiple attempts could increase the likelihood of success.
3.04 The transaction is declined by the issuer
Inform the user that the transaction was blocked by their card issuer, likely due to one of the card limits being triggered. Suggest that they contact their bank’s support service to remove the relevant limit or attempt the transaction again, as repeated attempts may increase the likelihood of approval.
3.05 Call your bank
Inform the user that the issuing bank is likely blocking the transaction due to one of the card limits being triggered. Encourage the customer to contact their bank’s support service to inquire about any possible limits and request their removal if necessary. Suggest that the user try the transaction again, as repeated attempts may increase the likelihood of success due to some banks using a dynamic scoring system.
3.06 Debit card not supported
Advise the customer to use a different type of card, such as a credit card, for this transaction. Ensure that the payment gateway settings and merchant configurations are correctly set up to accept the supported card types.
3.07 Card brand is not supported
Kindly ask the user to use another card, the one specified in your payment form.
3.08 Do not honor
Encourage the customer to contact their card issuer for more information. It’s likely that the next attempt may be successful once the issue has been addressed with the issuer.
3.09 3D-Secure authentication required
Kindly ask the user to try one more time or suggest to the user to use another card.
3.10 Suspected Fraud
Advise the customer to contact their card issuer for more information. It’s possible that the next attempt will be successful after the issue has been resolved with the issuer.
3.11 Recurring payment cancelled
Kindly ask the user (the customer) why they have blocked subscription payments. If this action was not taken by the customer, they will need to contact their card issuer for more information.
3.12 Closed User Account
Kindly ask the user (the customer) why they have blocked transactions. If the customer did not initiate this action, they will need to contact their card issuer for more information.
Fraud and anti-fraud
These errors indicate transactions flagged for potential fraud due to blacklisted cards, stolen cards, or triggered antifraud rules, requiring merchants to display a general decline and conduct further investigation or recommend customers to try again.
4.01 Card is in a black list
Show general decline to the customer. It is best to check the customer for fraudulent activity.
4.02 Stolen card
Show general decline to the customer. It is best to check the customer for fraudulent activity and block if necessary.
4.05 PSP antifraud
Show general decline to the customer. It is best to check the customer for fraudulent activity and block if necessary.
4.07 Trusted antifraud system
Show general decline to the customer. It is best to check the customer for fraudulent activity and block if necessary. Otherwise, kindly suggest to the customer to try one more time.
4.09 Antifraud service
Show general decline to the customer. It is best to check the customer for fraudulent activity and block/unblock if necessary. Otherwise, kindly suggest to the customer to try one more time.
Card blocked or restricted
These errors pertain to transactions blocked due to lost or restricted cards, requiring merchants to offer alternative payment options and check for potential fraud.
4.03 Restricted card
For merchants dealing with restricted cards, it’s important to suggest alternative payment methods to the user. Avoid immediate transaction reattempts unless the cardholder confirms the restriction has been removed. Ensure accurate transaction data and do not alter it to bypass restrictions. Consider implementing a system to identify and manage transactions that might be subject to country-based restrictions.
4.04 Lost card
Show general decline to the customer. It is best to check the customer for fraudulent activity and block if necessary.
Data or card verification
These errors relate to address mismatches, failed 3D verification, and issues with card tokens, requiring merchants to verify customer information, check for fraud, and consult support as needed.
4.08 AVS mismatch
Kindly ask the user to enter a valid billing address. If AVS mismatch is recurring for the same user - potential card fraud. Act accordingly to your policies.
5.01 3D secure verification failed
Show a general decline message to the customer. Check for potential fraudulent activity and take appropriate action if necessary. If no concerns arise, encourage the customer to retry the transaction, as verification failures can sometimes be temporary.
5.02 Invalid Card Token
Ask the customer to retry the transaction or use a different card. If the issue persists, please contact Solidgate Support for further assistance.
7.01 Card token not found
More likely card is expired. Kindly check exp. date, available in order details - logs, via Solidgate hub. Otherwise, please contact Solidgate Support.
Connection or processing issues
These errors relate to transaction issues and connection errors; solutions include retrying, using a different card, or contacting the bank.
5.03 Application error
Advise the customer to retry the transaction or use an alternative card. If the issue persists, contact Solidgate Support for assistance.
5.08 Invalid transaction
Kindly ask the customer to try one more time or to use another card. If another card is not an option - kindly suggest contacting the bank.
6.01 Unknown decline code
Encourage the customer to attempt the transaction again or to use an alternative card. If neither option is viable, advise the customer to consult their bank for more information.
6.02 Connection error
Request the customer to retry the transaction or consider using a different card.
Merchant configuration or activation errors
These errors are related to merchant configuration and API communication issues; resolution steps include contacting Solidgate Support or ensuring proper API method usage.
5.04 Merchant is not configured correctly
Verify the merchant’s settings and configurations. If necessary, consult the payment gateway documentation or contact Solidgate Support for assistance.
5.05 Merchant is not activated yet
Ensure that the merchant account has been activated. If the account status is unclear, please contact Solidgate Support for verification and assistance.
5.09 Merchant not found
Verify that the merchant identifier provided in the transaction request is correct. If the identifier is correct but the merchant still cannot be found, consult the acquirer’s documentation or contact Solidgate Support for further investigation.
5.10 Processor does not support requested API method
Ensure that communication with the gateway occurs through supported API methods.
5.12 Account is blocked
Determine the reason for the account being blocked by reviewing account activity, compliance documents, or communication with the payment processor or acquiring bank. Resolve any issues as required, and then request that the account be unblocked. If you need further assistance or clarification, please contact Solidgate Support.
Restrictions or duplicate transactions
Errors are due to IP blocks, duplicate transactions, API limits, or routing issues; recommend fraud checks, preventing duplicates, adhering to API limits, and proper routing.
4.06 Blocked by Country/IP
Show general decline to the customer. It is best to check the customer for fraudulent activity and block if necessary. Otherwise, kindly suggest to the customer to try one more time.
5.06 Duplicate order
Prevent a failure when sending a request and a duplicate order is created.
5.07 Exceeded API calls limits
Send a request without exceeding a certain number of times.
5.11 Invalid routing
The Manufacturers Identification code (MID) where the token is located is enabled and the recurrence cascade (MOTO) is configured.
Payment system errors
For errors arising from payment method inconsistencies, cascade disruptions, token generation failures, or SCA engine issues, please seek assistance from Solidgate Support.
7.02 Google payment error
Verify the payment details provided by the customer and ensure they are using a supported payment method within Google Pay. If the issue persists, contact Solidgate Support for further assistance.
7.03 Smart cascade decline
Verify that the tokens used in the cascade process are correctly generated and configured. If you’re unsure how to do this or if the error persists, please contact Solidgate Support for further assistance.
7.04 3DS cascade to 2D
Ensure that the merchant account supports both 3D Secure and 2D transaction flows. If the error persists, contact Solidgate Support for further investigation.
7.05 Apple online payment error
Verify the payment details provided by the customer and ensure they are using a supported payment method within Apple Pay. If the issue persists, contact Solidgate Support for further assistance.
7.06 Token generation error
Confirm that the payment details provided by the customer are accurate and complete. If the error continues, contact Solidgate Support for further assistance.
7.07 SCA engine error
scheme_transaction_id
(taken from the first PSP transaction) is empty.
Recommendations
Please contact Solidgate Support.
- General decline
- Validation errors
- 2.01 Invalid Data/Order not found
- 2.02 Invalid Amount
- 2.03 Invalid Currency
- 2.05 Order not found
- 2.06 Invalid CVV2 code
- 2.07 Request Is empty
- 2.08 Invalid card number
- 2.09 Invalid expiration date
- 2.10 Invalid 3DS flow on the merchant side
- 2.11 Invalid 3DS flow on the bank side
- 2.12 Invalid 3DS flow
- 2.13 Invalid IP
- 2.14 Subscription Error
- 2.15 SCA require 3D authentication
- 2.16 Subscription is locked
- 2.17 Coupon is not active
- Transaction declines
- 3.01 Card is blocked
- 3.02 Insufficient funds
- 3.03 Payment amount limit excess
- 3.04 The transaction is declined by the issuer
- 3.05 Call your bank
- 3.06 Debit card not supported
- 3.07 Card brand is not supported
- 3.08 Do not honor
- 3.09 3D-Secure authentication required
- 3.10 Suspected Fraud
- 3.11 Recurring payment cancelled
- 3.12 Closed User Account
- Fraud and anti-fraud
- Card blocked or restricted
- Data or card verification
- Connection or processing issues
- Merchant configuration or activation errors
- Restrictions or duplicate transactions
- Payment system errors