Stripe | Financial Infrastructure to Grow Your Revenue

Stripe | Financial Infrastructure to Grow Your Revenue

5282 articles

Failed invoice payments now return an HTTP error


Breaking changes

Failed invoice payments now return an HTTP error Breaking changes

What’s new

Updates the Pay invoice call to return an error when the charge isn’t successful. Previously, the API would return a 200 status and set the invoice’s paid property to false.

Impact

The Pay invoice call now returns an error for unsuccessful charges, improving error handling and consistency.

Upgrade

  1. View your current API version in Workbench.
  2. If you use an SDK, upgrade to the corresponding SDK version for this API version.
  • If you don’t use an SDK, update your API requests to include Stripe-Version: 2013-02-11
  1. Upgrade the API version used for webhook endpoints .
  2. Test your integration against the new version.
  3. If you use Connect, test your Connect integration .

Learn more about Stripe API upgrades.

Last verified 2026-09-25

Is this helpful?