not_permitted
The payment isn't allowed.
| Group | The bank said no |
|---|---|
| Retry | Retry possible, often needs the customer |
| Customer-facing | Safe to explain |
What it means
The payment isn't allowed.
What Stripe's docs suggest
The customer should contact their bank for details. Source
Will a retry work?
Not on Stripe's hard-decline list, so retries can run, but the bank gave no reason, so the customer may need to call their bank or use another card. Source
What to tell the customer
A message you could send: “Your bank declined the payment and didn't tell us why. Please check with your bank, or use a different card through this secure link.”
If this hit a subscription renewal
- The bank won't tell you more, so the customer has to ask, or use another card.
- Email a card-update link and suggest a different card if the problem continues.
- Check whether CVC and address checks passed when the card was saved. Failed checks are a hint.
Similar card-network reason codes
Banks also return a raw network code. These raw codes have a similar meaning to not_permitted. Stripe doesn't publish a one-to-one mapping, so treat this as our guide, not an official match.
| Network | Raw code | Meaning (our wording) |
|---|---|---|
| Visa | 57 | Not allowed for this cardholder |
| Mastercard | 57 | Not allowed for this issuer or cardholder |
Stripe's network decline code tables
Questions
What does not_permitted mean?
The payment isn't allowed.
Can I retry a not_permitted decline?
Not on Stripe's hard-decline list, so retries can run, but the bank gave no reason, so the customer may need to call their bank or use another card. Source
What should I tell a customer about not_permitted?
A message you could send: “Your bank declined the payment and didn't tell us why. Please check with your bank, or use a different card through this secure link.”
Related codes
- approve_with_id
- call_issuer
- card_not_supported
- currency_not_supported
- do_not_honor
- generic_decline
- invalid_account
- invalid_amount
- All decline codes
Checked against Stripe's public docs on November 17, 2026. Codes and guidance can change; always confirm in the official decline code list.