Processors

Stripe declined payment: why cards get declined and what to do

Stripe says a payment fails for one of three reasons: the card issuer declines it, Stripe's Radar blocks it, or the request itself is invalid. Which one it is decides what you do next.

By Mike Akop, founderChecked 3 min read

On this page
  1. Three kinds of failure
  2. Reading the code
  3. What to do at the counter
  4. Worked example
  5. What to avoid
  6. How a second way to take cards helps
  7. Common questions
  8. Sources

In short

  • Most declines come from the customer's bank, and only the bank can explain them.
  • Stripe tells you not to share detail for fraud-type codes, and to present them like a generic decline.
  • A blocked payment never reaches the bank, so it is not the bank's decision.

Three kinds of failure

Stripe's declines page says there are three reasons a payment fails. An issuer decline means the customer's bank or card provider said no, based on signals such as spending habits, balance and card data. A blocked payment means Stripe Radar stopped a high risk payment without asking the bank. An invalid request means the payment details sent to Stripe were wrong. You can see the type in the Dashboard on the payment.

Decline codeStripe's meaningStripe's next step
insufficient_fundsNot enough money on the cardCustomer uses another payment method
incorrect_cvcSecurity code wrongCustomer tries again
expired_cardCard has expiredCustomer uses another card
generic_declineUnknown reason, or Radar blocked itCustomer contacts the issuer
offline_pin_requiredCard needs a PINInsert the card and enter PIN

Reading the code

Stripe publishes a list of decline codes with a suggested next step. Many say the customer needs to contact their card issuer. Some are simple: wrong CVC or card number means try again, expired card means use another card, insufficient funds means use another method. For codes such as fraudulent, lost_card and stolen_card, Stripe says not to report detail to the customer and to present it the same way as a generic decline. For generic_decline, Stripe says the reason is unknown, or that Radar or Adaptive Acceptance blocked it.

What to do at the counter

  1. Look at the payment in the Dashboard to see whether it was an issuer decline or a block.
  2. If the issuer declined, ask the customer to call the number on the back of the card, or offer another card.
  3. If a card was tapped, hold it to the reader until it reads. Stripe notes some cards need a PIN or insertion, and offline_pin_required means exactly that.
  4. If the payment was blocked by a rule you set, and you recognize the customer, see our Stripe Radar page.

Worked example

Example: a $150 boutique purchase declines with generic_decline. The customer insists the card is fine. In the Dashboard the outcome says blocked, not issuer declined, so the bank never saw it. The customer may even see a pending hold on their statement. Stripe says that for some card types the issuer's authorization can appear on the statement, though Stripe has not charged the amount, and it typically drops off within a few days. The owner offers another card and reviews the rule later. Details are invented for illustration.

What to avoid

  • Do not tell a customer their card is stolen or fraudulent. Stripe advises against sharing that detail.
  • Do not keep retrying the same card many times. Stripe mentions retry penalties on some pricing plans and says failed retries skew your decline-rate numbers.
  • Do not blame the reader before checking the code.

How a second way to take cards helps

MazalPOS payments run through your store's own Stripe account, so Stripe's declines and risk checks apply the same way. When a card fails at the register you can take cash, another card, or send a pay link (3% fee), and the sale stays on one ticket. Refunds can be done from the register, manager phone or back office. See payments.

Common questions

Stripe says it is an issuer decline, a Radar block, or an invalid request. The payment details in the Dashboard show which.

Stripe says the card was declined for an unknown reason, or Radar or Adaptive Acceptance blocked it.

For fraud-related codes Stripe says no, present it like a generic decline.

No. Card approval depends on the bank and Stripe. MazalPOS gives you other ways to complete the sale.

Sources

Checked on 2026-11-08. Rules and prices change, so confirm on the official page before you act.

Stripe Radar blocking good customers: what to doStripe card reader not connecting or Tap to Pay not working: what to checkStripe chargeback: what to do when a customer disputes a payment

Written by Mike Akop, founder of MazalPOS. We build and support the register, online store and staff app that stores from Las Vegas to Honolulu run on. Questions? Talk to a real person.

Not sure where to start?

Talk to a real
person today.

Tell us how your store works and we will show you MazalPOS with your own products.

14 days free. No card. Cancel anytime.

More like this

Stripe Radar blocking good customers: what to doStripe

Stripe Radar scores every payment and blocks the ones it rates highest risk, sometimes wrongly. You can review the payment, add a trusted value to an allow list, and test any rule before you turn it on.

Stripe card reader not connecting or Tap to Pay not working: what to checkStripe

Most Stripe reader trouble is the network: the reader and the app device must be on the same Wi-Fi, and the reader must pass its Stripe connectivity test. For Tap to Pay on iPhone, the phone model, iOS version and how the card is held matter.

Stripe chargeback: what to do when a customer disputes a paymentStripe

When a customer disputes a payment, Stripe takes the amount plus a dispute fee from your balance right away. You usually have 7 to 21 days to answer, and you get one chance to submit evidence.

Stripe account closed or restricted: what to do nextStripe

Stripe can close or restrict an account when a business breaks its rules or falls on its restricted list. Stripe emails the reason, shows a red Dashboard banner, and links a form to ask for a second look.

Stripe fees explained: what a sale really costsStripe

Stripe's pricing page lists 2.9% + 30 cents for online cards and 2.7% + 5 cents for in-person Terminal cards, plus extras for manual entry, international cards, disputes and instant payouts. Check the page before you rely on any number.

Stripe funds on hold: why your payout is delayed and what to doStripe

Stripe can delay a payout for a new account, a risky charge, a negative balance, missing verification, or a reserve. Check your Dashboard and email first, because most causes show up there.