Locating Stripe Decline Codes in Quipli
When a customer's card payment is declined by Stripe, admin users can see the decline code directly within the Quipli admin console. Follow these steps to locate the decline code:
Navigate to the order in the Quipli admin console.
Scroll down to the "Invoices" section of the order.
Under "Payment History," locate the "Status" column. The decline code will be displayed here.
All Stripe Decline Codes and Their Resolutions
Stripe decline codes provide insight into why a payment could not be processed. Here is a comprehensive list of potential decline codes that can occur within Quipli, their meanings, and recommended next steps:
requires_action
Description: The transaction requires authentication.
Next Steps: Retry the payment with the required authentication flow, such as 3D Secure. When the customer's card requires 3D authentication, then they will receive the below email.
When they click "Order Details" from the email, they will then be directed to the page pictured below and they need to click "Confirm Payment." Once they click this, then the payment status within the "Payment History" section of the order screen will change from "Requires Action" to "Succeeded" (if successful).
do_not_honor
Description: The card was declined for an unknown reason.
Next Steps: Contact the card issuer for more information.
approve_with_id
Description: The payment can’t be authorized.
Next Steps: Remove the card and add a new one
call_issuer
Description: The card was declined for an unknown reason.
Next Steps: Remove the card and add a new one
card_velocity_exceeded
Description: The customer has exceeded the balance, credit limit, or transaction amount limit on their card.
Next Steps: Contact the card issuer to increase the limit or use a different card
duplicate_transaction
Description: A similar transaction was submitted recently.
Next Steps: Verify if a recent payment exists.
incorrect_cvc
Description: The CVC number is incorrect.
Next Steps: Retry with the correct CVC.
incorrect_pin
Description: The PIN is incorrect.
Next Steps: Retry with the correct PIN.
insufficient_funds
Description: The card has insufficient funds.
Next Steps: Use an alternative payment method.
invalid_amount
Description: The payment amount is invalid.
Next Steps: Ensure the amount is correct and within the allowed limit.
invalid_cvc
Description: The CVC number is incorrect.
Next Steps: Retry with the correct CVC.
invalid_expiry_month
Description: The expiration month is invalid.
Next Steps: Retry with the correct expiration date.
invalid_expiry_year
Description: The expiration year is invalid.
Next Steps: Retry with the correct expiration date.
issuer_not_available
Description: The card issuer couldn’t be reached.
Next Steps: Retry the payment. If it fails, contact the card issuer.
new_account_information_available
Description: The card, or account the card is connected to, is invalid.
Next Steps: Contact the card issuer for more information.
no_action_taken
Description: The card was declined for an unknown reason.
Next Steps: Contact the card issuer for more information.
not_permitted
Description: The payment isn’t permitted.
Next Steps: Contact the card issuer for more information.
offline_pin_required
Description: The card was declined because it requires a PIN.
Next Steps: Retry with a PIN.
online_or_offline_pin_required
Description: The card was declined as it requires a PIN.
Next Steps: Retry with a PIN.
pin_try_exceeded
Description: The allowable number of PIN tries was exceeded.
Next Steps: Use another card or method of payment.
processing_error
Description: An error occurred while processing the card.
Next Steps: Retry the payment.
reenter_transaction
Description: The payment couldn’t be processed by the issuer.
Next Steps: Retry the payment.
restricted_card
Description: The customer can’t use this card.
Next Steps: Use another card.
revocation_of_authorization
Description: The card was declined for an unknown reason.
Next Steps: Contact the card issuer.
service_not_allowed
Description: The card was declined for an unknown reason.
Next Steps: Contact the card issuer.
stop_payment_order
Description: The card was declined for an unknown reason.
Next Steps: Contact the card issuer.
transaction_not_allowed
Description: The card was declined for an unknown reason.
Next Steps: Contact the card issuer.
try_again_later
Description: The card was declined for an unknown reason.
Next Steps: Retry the payment later.
withdrawal_count_limit_exceeded
Description: The customer has exceeded the balance or credit limit available on their card.
Next Steps: Use an alternative payment method.
For the below codes, the card will become disabled permanently in the system. To resolve the issue, you must remove the card and add a new card.
revocation_of_all_authorizations
Description: The card was declined for an unknown reason.
Next Steps: Remove the card and add a new one
security_violation
Description: The card was declined for an unknown reason.
Next Steps: Remove the card and add a new one
stolen_card
Description: The payment was declined because the card is reported stolen.
Next Steps: Remove the card and add a new one
card_not_supported
Description: The card does not support this type of purchase.
Next Steps: Remove the card and add a new one
do_not_try_again
Description: The card was declined for an unknown reason.
Next Steps: Remove the card and add a new one
currency_not_supported
Description: The card does not support the specified currency.
Next Steps: Remove the card and add a new one
expired_card
Description: The card has expired.
Next Steps: Remove the card and add a new one
fraudulent
Description: The payment is suspected to be fraudulent.
Next Steps: Remove the card and add a new one
generic_decline
Description: The card was declined for an unknown reason.
Next Steps: Remove the card and add a new one
incorrect_number
Description: The card is a prepaid card and does not have any funds on it
Next Steps: Remove the card and add a new one
invalid_account
Description: The card or account is invalid.
Next Steps: Remove the card and add a new one
invalid_number
Description: The card is a prepaid card and does not have any funds on it
Next Steps: Remove the card and add a new one
lost_card
Description: The payment was declined because the card is reported lost.
Next Steps: Remove the card and add a new one
merchant_blacklist
Description: The payment was declined due to merchant restrictions.
Next Steps: Remove the card and add a new one
pickup_card
Description: The card can’t be used for this payment.
Next Steps: Remove the card and add a new one