PAYMENT SCENARIOS
...
Declines
Card declines
5 min
learn about card declines and how to lower your decline rate card payments can fail for a variety of reasons some of the most common are insufficient customer funds if a customer has insufficient customer funds or credit, the card issuer declines the transaction to help minimize declines due to insufficient funds, consider adding a buy now, pay later (bnpl) option incorrect card data if a customer enters an incorrect card number, cvv, or expiration date, the card issuer might decline the transaction in these cases, request your customer to re enter their card information fraudulent activity if a card issuer suspects fraudulent activity, which can be triggered by large purchases or a large volume of transactions over a short period of time, they might decline payments your customer must resolve this issue by communicating with their issuing bank and confirming their identity card declines when your customer’s card issuer receives a charge, their automated systems and models decide whether to authorize it these tools analyze signals such as spending habits, account balance, and card data including expiration date, address information, and cvc if the card issuer declines a payment, stripe shares some of the decline information we receive this information is available in the dashboard and through the api sometimes, issuers provide specific explanations, such as an incorrect card number or low funds we show these as decline codes card issuer’s categorize most declines as generic (generic decline), making the exact decline reason unclear if the card information is correct, request your customer to contact their card issuer to understand why a transaction was declined for privacy and security reasons, card issuers discuss the specifics of a decline only with their cardholders reduce card declines you can typically resolve card issuer declines resulting from inaccurate card details (such as an incorrect card number or expiration date) by asking your customers to correct the error or use a different card or payment method for example, checkout provides feedback to the customer when a card declines and allows them to try again to avoid declines that stem from suspected fraudulent activity, request your customers to provide their cvc and postal code during checkout the impact of other data that you gather, such as the full billing address, might vary by card brand and country if you continue to see elevated decline rates, stripe recommends collecting extra customer information you can also implement 3d secure to authenticate payment, which can lower decline rates in countries that support it for a clear insight into why the card issuer declined the card during generic or do not honor declines, examine the associated data for example, if cvc or address verification service (avs) checks fail when your customer adds a card, request your customer to verify both of these details before initiating another charge if you notice that a customer is using a card issued in one country while operating from an ip address in another, it might be a legitimate decline due to possible unauthorized card use however, exceptions can occur, particularly when customers are traveling internationally and use their cards from various locations card type restrictions some customers find that their card has restrictions on the types of purchasable items fsa or hsa cards are often limited to certain types of businesses (for example, healthcare providers), so card issuer’s decline any other type of purchase additionally, some card issuers might not allow purchases from certain countries or outside of their own in either case, your customer must contact their card issuer to inquire about potential restrictions geographic location impacts if your customers use cards issued in a different country than where you registered your stripe account, they might see an increased rate of declines to resolve this, your customer must contact their issuing bank to authorize the charge if you have a global customer base with concentrations in various locations, you might want to set up stripe accounts in larger markets, or in regions that encounter higher decline rates this allows you to process charges locally declined card retries when a payment gets declined, stripe offers a reason for the decline and briefly suggests a resolution path if you’re a stripe billing user, you can create a custom retry schedule for subscriptions if you upgrade to billing scale, use smart retries to choose the best times to retry failed payment attempts we recommend a maximum of four retries for charges that permit retries card issuers might see creating additional retries as potential fraud, which can result in increased declines for legitimate charges manage declines programmatically there are several ways to programmatically handle declines retrieve the last payment error decline code property from the paymentintent object to see why the card issuer declined the payment attempt iterate over the paymentintent’s attempted charges and inspect the failure message use webhooks to monitor paymentintent status updates for example, the payment intent payment failed event triggers when a payment attempt is unsuccessful you might also need to manage additional payment failure situations such as when your customer is present (on session) or absent (off session) during your checkout process as you develop your integration, stripe advises treating all possible api exceptions, including unexpected errors on session declines if your customer is present in your website or application’s checkout flow, prompt them to try their payment method again or ask for a new payment method off session declines if your customer isn’t available to make a payment or update a payment method, notify them (for example, send them an email or in app notification) to visit your website or application if your business is affected by regulations like strong customer authentication, payment attempts might also require authentication and fail with an authentication required decline code for more information on handling these scenarios, see off session payments with saved cards