Stripe | Financial Infrastructure to Grow Your Revenue

Stripe | Financial Infrastructure to Grow Your Revenue

4466 articles

Adds customer and payment method details to the Refunds API


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

ParametersChangeResources or endpoints
customer customer_account payment_methodAddedRefund

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: 2026-07-29. dahlia
  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 .
  4. In Workbench, perform the upgrade . You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.

Last verified 2026-09-24

Is this helpful?