# Adds refund reference tracking for Klarna, PayPal, and Afterpay Clearpay ## What’s new Adds the [reference](https://docs.stripe.com/api/refunds/object.md?api-version=2026-10-28.endive#refund_object-destination_details-klarna-reference) and [reference_status](https://docs.stripe.com/api/refunds/object.md?api-version=2026-10-28.endive#refund_object-destination_details-klarna-reference_status) properties to [destination_details](https://docs.stripe.com/api/refunds/object.md?api-version=2026-10-28.endive#refund_object-destination_details) on the [Refund](https://docs.stripe.com/api/refunds/object.md?api-version=2026-10-28.endive) object for [Klarna](https://docs.stripe.com/payments/klarna.md), [PayPal](https://docs.stripe.com/payments/paypal.md), and [Afterpay Clearpay](https://docs.stripe.com/payments/afterpay-clearpay.md) payments. These read-only properties appear in responses when you [create](https://docs.stripe.com/api/refunds/create.md?api-version=2026-10-28.endive) or [retrieve](https://docs.stripe.com/api/refunds/retrieve.md?api-version=2026-10-28.endive) a Refund. They also appear in [refund.created](https://docs.stripe.com/api/events/types.md?api-version=2026-10-28.endive#event_types-refund.created) and [refund.updated](https://docs.stripe.com/api/events/types.md?api-version=2026-10-28.endive#event_types-refund.updated) events. The `reference` property contains the refund reference ID assigned by the payment method provider. The `reference_status` property indicates whether the reference is `pending`, `available`, or `unavailable`. These properties use the same refund reference pattern already supported for payment methods such as BLIK, P24, and iDEAL. ## Impact Use the `reference` and `reference_status` properties in `destination_details` to retrieve reference information for Klarna, PayPal, and Afterpay Clearpay refunds through the API, without contacting Stripe support. For these payment methods, `refund.updated` events also include these properties. ## Changes #### REST API | Parameters | Change | Resources or endpoints | | --- | --- | --- | | `reference`, `reference_status` | Added | [Refund.destination_details.afterpay_clearpay](/api/refunds/object?api-version=2026-10-28.endive#refund_object-destination_details-afterpay_clearpay), [Refund.destination_details.klarna](/api/refunds/object?api-version=2026-10-28.endive#refund_object-destination_details-klarna), [Refund.destination_details.paypal](/api/refunds/object?api-version=2026-10-28.endive#refund_object-destination_details-paypal) | #### Ruby | Parameters | Change | Resources or methods | | --- | --- | --- | | `reference`, `reference_status` | Added | [Refund::DestinationDetail::AfterpayClearpay](/api/refunds/object?api-version=2026-10-28.endive#refund_object-destination_details-afterpay_clearpay), [Refund::DestinationDetail::Klarna](/api/refunds/object?api-version=2026-10-28.endive#refund_object-destination_details-klarna), [Refund::DestinationDetail::Paypal](/api/refunds/object?api-version=2026-10-28.endive#refund_object-destination_details-paypal) | #### Python | Parameters | Change | Resources or methods | | --- | --- | --- | | `reference`, `reference_status` | Added | [Refund.DestinationDetail.AfterpayClearpay](/api/refunds/object?api-version=2026-10-28.endive#refund_object-destination_details-afterpay_clearpay), [Refund.DestinationDetail.Klarna](/api/refunds/object?api-version=2026-10-28.endive#refund_object-destination_details-klarna), [Refund.DestinationDetail.Paypal](/api/refunds/object?api-version=2026-10-28.endive#refund_object-destination_details-paypal) | #### PHP | Parameters | Change | Resources or methods | | --- | --- | --- | | `reference`, `reference_status` | Added | [Refund.destination_details.afterpay_clearpay](/api/refunds/object?api-version=2026-10-28.endive#refund_object-destination_details-afterpay_clearpay), [Refund.destination_details.klarna](/api/refunds/object?api-version=2026-10-28.endive#refund_object-destination_details-klarna), [Refund.destination_details.paypal](/api/refunds/object?api-version=2026-10-28.endive#refund_object-destination_details-paypal) | #### Java | Parameters | Change | Resources or methods | | --- | --- | --- | | `reference`, `referenceStatus` | Added | [Refund.destination_details.afterpay_clearpay](/api/refunds/object?api-version=2026-10-28.endive#refund_object-destination_details-afterpay_clearpay), [Refund.destination_details.klarna](/api/refunds/object?api-version=2026-10-28.endive#refund_object-destination_details-klarna), [Refund.destination_details.paypal](/api/refunds/object?api-version=2026-10-28.endive#refund_object-destination_details-paypal) | #### Node.js | Parameters | Change | Resources or methods | | --- | --- | --- | | `reference`, `reference_status` | Added | [Refund.destination_details.afterpay_clearpay](/api/refunds/object?api-version=2026-10-28.endive#refund_object-destination_details-afterpay_clearpay), [Refund.destination_details.klarna](/api/refunds/object?api-version=2026-10-28.endive#refund_object-destination_details-klarna), [Refund.destination_details.paypal](/api/refunds/object?api-version=2026-10-28.endive#refund_object-destination_details-paypal) | #### Go | Parameters | Change | Resources or methods | | --- | --- | --- | | `Reference`, `ReferenceStatus` | Added | [RefundDestinationDetailsAfterpayClearpay](/api/refunds/object?api-version=2026-10-28.endive#refund_object-destination_details-afterpay_clearpay), [RefundDestinationDetailsKlarna](/api/refunds/object?api-version=2026-10-28.endive#refund_object-destination_details-klarna), [RefundDestinationDetailsPaypal](/api/refunds/object?api-version=2026-10-28.endive#refund_object-destination_details-paypal) | #### .NET | Parameters | Change | Resources or methods | | --- | --- | --- | | `Reference`, `ReferenceStatus` | Added | [Refund.DestinationDetails.AfterpayClearpay](/api/refunds/object?api-version=2026-10-28.endive#refund_object-destination_details-afterpay_clearpay), [Refund.DestinationDetails.Klarna](/api/refunds/object?api-version=2026-10-28.endive#refund_object-destination_details-klarna), [Refund.DestinationDetails.Paypal](/api/refunds/object?api-version=2026-10-28.endive#refund_object-destination_details-paypal) | ## Upgrade #### REST API 1. [View your current API version](https://docs.stripe.com/workbench/guides.md#view-api-versions) 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](https://docs.stripe.com/api-versions.md#how-versions-are-specified-in-requests) to include `Stripe-Version: 2026-10-28.endive` 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Ruby 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 2. Upgrade your Ruby SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Python 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 2. Upgrade your Python SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### PHP 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 2. Upgrade your PHP SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Java 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 2. Upgrade your Java SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Node.js 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 2. Upgrade your Node SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Go 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 2. Upgrade your Go SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### .NET 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 2. Upgrade your .NET SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). ## Related changes - [Adds payment intent data configuration when updating Checkout Sessions](https://docs.stripe.com/changelog/endive/2026-10-28/adds-payment-intent-data-configuration-when-updating-checkout-sessions.md) - [Adds Open USD (OUSD) as a supported token currency for crypto payments](https://docs.stripe.com/changelog/endive/2026-10-28/ousd-token-currency.md) - [Adds support for requesting Scalapay Payment Links](https://docs.stripe.com/changelog/endive/2026-10-28/scalapay-payment-method-support-payment-links.md) - [Adds the evidence submission method property to Disputes](https://docs.stripe.com/changelog/endive/2026-10-28/evidence-submission-method-property-disputes.md) - [Adds the ability to specify the intended submission method for Disputes](https://docs.stripe.com/changelog/endive/2026-10-28/adds-intended-submission-method-for-disputes.md) - [Adds invoice settings parameters for Checkout Sessions and Payment Links subscriptions](https://docs.stripe.com/changelog/endive/2026-10-28/invoice-settings-parameters-checkout-sessions-payment-links-subscriptions.md) - [Adds support for submitting evidence to appeal dispute decisions](https://docs.stripe.com/changelog/endive/2026-10-28/evidence-submission-appeal-dispute-decisions.md) - [Adds support for specifying card-on-file usage when saving or charging cards](https://docs.stripe.com/changelog/endive/2026-10-28/card-on-file-usage-indicators-support.md) - [Adds RTP and FedNow as US bank transfer network types for cash balance transactions](https://docs.stripe.com/changelog/endive/2026-10-28/rtp-fednow-support-us-bank-transfer-network-types.md) - [Adds webhook events and error messages for the Standalone 3DS API](https://docs.stripe.com/changelog/endive/2026-10-28/standalone-3ds-error-messages-and-webhook-events.md) - [Adds validation for Smart Disputes availability when submitting a dispute](https://docs.stripe.com/changelog/endive/2026-10-28/smart-disputes-availability-validation.md)