mobile_device_authentication_required
The bank wants the payment confirmed on the customer's phone or wallet.
| Group | Authentication needed |
|---|---|
| Retry | Needs the customer |
| Customer-facing | Safe to explain |
What it means
The bank wants the payment confirmed on the customer's phone or wallet.
What Stripe's docs suggest
Ask the customer to tap their mobile device again to retry. Source
Will a retry work?
A retry only works once the customer completes the bank's authentication step.
What to tell the customer
A message you could send: “Your bank needs you to confirm this payment. Please open this secure link to approve it.”
If this hit a subscription renewal
- The customer has to be present to approve the payment. Send them a link to a page where they can complete it.
- Explain plainly that their bank asked them to confirm the payment.
- Retries without the customer won't succeed.
Similar card-network reason codes
Banks also return a raw network code. These raw codes have a similar meaning to mobile_device_authentication_required. 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 | 1A | Extra customer authentication required |
Stripe's network decline code tables
Questions
What does mobile_device_authentication_required mean?
The bank wants the payment confirmed on the customer's phone or wallet.
Can I retry a mobile_device_authentication_required decline?
A retry only works once the customer completes the bank's authentication step.
What should I tell a customer about mobile_device_authentication_required?
A message you could send: “Your bank needs you to confirm this payment. Please open this secure link to approve it.”
Related codes
Checked against Stripe's public docs on November 17, 2026. Codes and guidance can change; always confirm in the official decline code list.