issuer_not_availableThe bank couldn't be reached

Stripe's issuer_not_available decline means the card issuer couldn't be reached. Stripe says to try again. When to involve the customer.

Next step
Retry may work
Hard decline
Not on Stripe's list
Share the reason
Yes

What does issuer_not_available mean?

Stripe couldn't reach the card issuer, so the payment couldn't be authorized.

What Stripe says to do

Attempt the payment again. If it still can't be processed, the customer needs to contact their card issuer.

What to tell the customer

Nothing yet. Retry first, and only contact the customer if it keeps failing.

Example wording
We couldn't reach your bank to complete the payment. Please try again in a moment.

Should you retry issuer_not_available?

Yes. Stripe's next step is another attempt. It isn't on Stripe's hard decline list, so Stripe Billing retries follow your Smart Retries or custom schedule.

Before any retry, check the charge's outcome.advice_code. try_again_later means the issuer allows a retry, do_not_try_again means don't use the card again for this transaction, and confirm_card_data means some card details need checking.

Where issuer_not_available shows up

On a failed PaymentIntent, read last_payment_error.decline_code. On the Charge, the same code is in outcome.reason. Card declines usually come with the error code card_declined and the reason in decline_code.

Get failed payments in Slack

ChargeBell posts a Slack alert when a Stripe payment fails, with the amount, the customer, and Stripe's decline message. Open the payment from the alert to see its decline code, such as issuer_not_available, and follow up from there.

Related decline codes

All Stripe decline codes