Free tools / Stripe decline codes / approve_with_id
Stripe decline code: approve_with_id
approve_with_id 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 "Approve with ID". Here is what it means, whether a retry can succeed, who can fix it, and what to tell the customer.
- Decline code
- approve_with_id
- Type
- Temporary refusal
- Who can fix it
- The bank — usually clears with time
- Will a retry help?
- Likely: let Smart Retries run
What it means
The payment could not be authorized without identification; for online payments this is effectively a transient decline.
Temporary refusal. The bank said no without a lasting reason. A later retry, such as one scheduled by Stripe's Smart Retries, often succeeds; a gentle reminder helps.
Should you retry?
Likely: let Smart Retries run. Yes, on Stripe's schedule. The refusal is temporary by nature, so a later attempt, such as one scheduled by Smart Retries, can succeed. Stop and ask for another card if it keeps failing.
Recommended action
Who can fix it: The bank — usually clears with time. Retry. If it persists, the customer should contact their bank.
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 could not approve this payment. Please try again. If it fails again, contact your bank.
Customer email template
Neutral wording for this situation. Replace {name}, {product}, {link} and {company}.
Hi {name},
Your bank declined our latest payment for {product}. This can be temporary, and we may try again automatically over the next few days. If it keeps failing, your bank can tell you why. You can also update or confirm your 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