Adds customer and payment method details to the Refunds API
What’s new
Adds three new readable properties to the Refunds object:
- customer : The ID of the customer associated with the refund. You can expand this property to retrieve the full Customer object.
- customer_account : The ID of the account associated with the refund.
- payment_method : The ID of the payment method associated with the refund. You can expand this property to retrieve the full PaymentMethod object.
These properties are returned on all /v1/refunds endpoints and are available for both linked and unlinked card refunds.
Impact
You can now retrieve customer and payment method details directly from a Refund object without making additional API calls. To access the full object details, pass customer, customer_account, or payment_method in the expand array of your request.
Changes
| Parameters | Change | Resources or endpoints |
|---|---|---|
| customer customer_account payment_method | 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: 2026-07-29. dahlia
- 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.
Related changes
- Adds the ability to update shipping options, consent collection, and future usage support on Payment Links
- Adds the ability to indicate that you don’t intend to reuse Samsung Pay and the related setting payment method types
- Adds support for new banks to FPX payments
- Adds the related setting as a supported network for funding instructions
- Adds the allowed payment method types parameter to Payment Intents and Setup Intents
- Adds MB WAY support to the hosted invoice page
- Adds card network details to the Dispute object
- Adds the ability to list Payment Records
