Free tools / Stripe decline codes / service_not_allowed
Stripe decline code: service_not_allowed
service_not_allowed is one of the decline codes Stripe returns when a card payment fails, in last_payment_error.decline_code on the PaymentIntent or outcome.reason on the Charge. Stripe's label for it is "Service not allowed". Here is what it means, whether a retry can succeed, who can fix it, and what to tell the customer.
- Decline code
- service_not_allowed
- Type
- Card not allowed
- Who can fix it
- The customer — needs to act
- Will a retry help?
- No: do not retry
What it means
Stripe gives no reason and says the customer should contact their bank; the network response means the bank does not allow this service for the card.
Card not allowed. The card cannot be used for this kind of payment (online, recurring or international), or the bank restricted it. Retrying the same card will not help; the customer has the restriction lifted or uses another card.
Should you retry?
No: do not retry. No. The bank will refuse the same card as is, or Stripe or the network asked not to try again. Retrying wastes an attempt and can breach the card networks' reattempt rules. Change what is wrong, or ask for another card.
Recommended action
Who can fix it: The customer — needs to act. Do not retry as is. The customer should contact their bank or use another card.
What to tell the customer
Short and neutral, ready for a checkout error, a billing page or a support reply. No placeholders — ready to paste.
Your bank does not allow this payment on this card. Please contact your bank, or pay with another card.
Customer email template
Neutral wording for this situation. Replace {name}, {product}, {link} and {company}.
Hi {name},
Your bank reported that the card on file can't be used for this payment for {product}. You can ask your bank to allow it, or pay with another card here: {link}
Thanks,
{company}Stripe's documentation
Stripe lists this code, with its advice for the customer, in its decline codes reference. The data on this page was last checked against it on 12 November 2026.
Related decline codes
Codes that behave the same way, to read next.
Handling many failed payments? See how FlowMRR helps you prioritize failed Stripe payments by revenue at risk.
Try FlowMRR free