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
Do not retry the same card and transaction type
Try a backup payment method
Route customer to update payment with clear messaging
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
Do not retry the same card and transaction type
Try a backup payment method
Route customer to update payment with clear messaging
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
Do not retry the same card and transaction type
Try a backup payment method
Route customer to update payment with clear messaging
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.

