Adds a field explaining why refunds are pending
What’s new
Adds the pending_reason field to the Refunds API. The new field describes why the refund is pending, returning possible values of:
- processing : The refund is processing.
- insufficient _ funds : The balance of the Stripe account is insufficient to cover the refund.
- charge _ pending : The payment being refunded hasn’t settled yet.
Impact
If the status of a refund is pending, you can inspect the pending_reason field to understand why and take necessary actions to resolve it.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| pending_reason | Added | Refund |
Upgrade
- View your current API version in Workbench.
- 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: 2025-04-30. basil
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
- In Workbench, perform the upgrade . You can roll back the version for 72 hours.
Learn more about Stripe API upgrades.