service_not_allowed
The bank declined for an unshared reason.
| Group | The bank said no |
|---|---|
| Retry | Retry possible, often needs the customer |
| Customer-facing | Safe to explain |
What it means
The bank declined for an unshared reason.
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 service_not_allowed. 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 | 58 | Not allowed at this terminal |
| Mastercard | 58 | Not allowed for this acquirer or terminal |
Stripe's network decline code tables
Questions
What does service_not_allowed mean?
The bank declined for an unshared reason.
Can I retry a service_not_allowed 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 service_not_allowed?
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.