invalid_billing_agreementThe billing agreement is invalid

Stripe's invalid_billing_agreement decline means the customer's billing agreement is invalid. Stripe says retries won't succeed. What to do instead.

Type
Local payment method codes
Hard decline
Not on Stripe's list
Share the reason
Yes

What does invalid_billing_agreement mean?

The customer's payment method is invalid because its billing agreement is invalid.

What to tell the customer

Ask the customer to set up their payment method again.

Example wording
Your saved payment method can no longer be charged. Please set it up again, or choose a different payment method.

Should you retry invalid_billing_agreement?

No. Stripe says retries won't succeed. Stripe Billing doesn't retry failed local payment method payments unless you turn that on in your retry settings.

Where invalid_billing_agreement shows up

For local payment methods, the PaymentIntent's last_payment_error.decline_code is invalid_billing_agreement, and Stripe reports the Charge's outcome.reason as invalid_billing_agreement.

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 invalid_billing_agreement, and follow up from there.

Related decline codes

All Stripe decline codes