Error codes

Soft decline

Stripe

not_permitted

The payment isn't permitted.

What does not_permitted mean?

The not_permitted decline is returned when the issuer's rules prevent this specific type of payment on the card. Like transaction_not_allowed, the restriction is card-level and persistent.

Is it a soft or hard decline?

Soft decline. The card may work for other purchase types, but this specific transaction is blocked by policy.

Common root causes

  • Card not approved for recurring charges

  • MCC restrictions on card type

  • Geographic or currency limits

  • Customer-configured spending restrictions

Recommended recovery steps

  1. Do not retry the same card and transaction type

  2. Try a backup payment method

  3. Route customer to update payment with clear messaging

  4. Consider alternate payment rails (ACH, wallets)

How FlyCode handles not_permitted

FlyCode automatically pivots to backup payment methods when a card cannot be used for the requested charge type, keeping subscriptions active without requiring the customer to take action.

What does not_permitted mean?

The not_permitted decline is returned when the issuer's rules prevent this specific type of payment on the card. Like transaction_not_allowed, the restriction is card-level and persistent.

Is it a soft or hard decline?

Soft decline. The card may work for other purchase types, but this specific transaction is blocked by policy.

Common root causes

  • Card not approved for recurring charges

  • MCC restrictions on card type

  • Geographic or currency limits

  • Customer-configured spending restrictions

Recommended recovery steps

  1. Do not retry the same card and transaction type

  2. Try a backup payment method

  3. Route customer to update payment with clear messaging

  4. Consider alternate payment rails (ACH, wallets)

How FlyCode handles not_permitted

FlyCode automatically pivots to backup payment methods when a card cannot be used for the requested charge type, keeping subscriptions active without requiring the customer to take action.

What does not_permitted mean?

The not_permitted decline is returned when the issuer's rules prevent this specific type of payment on the card. Like transaction_not_allowed, the restriction is card-level and persistent.

Is it a soft or hard decline?

Soft decline. The card may work for other purchase types, but this specific transaction is blocked by policy.

Common root causes

  • Card not approved for recurring charges

  • MCC restrictions on card type

  • Geographic or currency limits

  • Customer-configured spending restrictions

Recommended recovery steps

  1. Do not retry the same card and transaction type

  2. Try a backup payment method

  3. Route customer to update payment with clear messaging

  4. Consider alternate payment rails (ACH, wallets)

How FlyCode handles not_permitted

FlyCode automatically pivots to backup payment methods when a card cannot be used for the requested charge type, keeping subscriptions active without requiring the customer to take action.

Understanding This Decline Code

Extended content body

Frequently Asked Questions

What does not_permitted mean?

Can retries fix not_permitted?

No. The restriction is persistent at the card level. Recovery requires an alternate payment method or the customer providing a card that permits the charge type.

How does FlyCode handle not_permitted?

FlyCode routes customers to backup payment methods when a card cannot be used for the requested payment type, keeping subscriptions active where alternative payment data is available.

FlyCode partnered with Stripe, to turn failed payment intro revenue.

With our newest Stripe app, you can stop chasing your customers about their failed payments and recover more payments with zero development work.

With our newest Stripe app, you can stop chasing your customers about their failed payments and recover more payments with zero development work.

Giving Back

Partnering with organizations that promote women in technology and families in need is something we are proud to do.

Text graphic displaying "SPE CODES; NEXT LEVEL" in a bold, stylized font on a solid background.
Logo featuring a stylized text "Catching" with an orange accent, set against a simple background.

2026 FlyCode © All Right Reserved.

Giving Back

Partnering with organizations that promote women in technology and families in need is something we are proud to do.

Text graphic displaying "SPE CODES; NEXT LEVEL" in a bold, stylized font on a solid background.
Logo featuring a stylized text "Catching" with an orange accent, set against a simple background.

2026 FlyCode © All Right Reserved.