Public preview
Adds industry-specific transaction details and purchase data for cards and Klarna Public preview
What’s new
Adds fields for card and Klarna payments to specify industry-specific transaction details:
- Car rentals: payment_details.car_rental_data
- Lodging: payment_details.lodging_data
- Flights: payment_details.flight_data
You can provide additional transaction details for Klarna payments payment_method_options.klarna.supplementary_purchase_data to specify train, bus, ferry trips, round-trips, insurance, vouchers, marketplace sellers, and event reservations.
When this functionality was first released with the 2025-11-17.preview API version, data passed to the payment_details.car_rental_data, payment_details.lodging_data, and payment_details.flight_data parameters wasn’t saved to PaymentIntent objects. We resolved this issue, and no changes to your integration code are required—the new data persistence logic applies automatically to all API requests using the 2025-11-17.preview API version and later. You can now retrieve the industry metadata you’ve submitted through the Payment Intents API and receive it in events.
Impact
Include these optional fields when creating or updating a PaymentIntent using supported payment methods. This data helps payment processors better understand transactions, and can lead to more accurate risk scoring and improved approval rates.
You must provide industry-specific transaction details for certain merchant category codes to comply with card network requirements and to avoid potential cost downgrades. For Klarna, this additional context can improve how payments are assessed through Klarna’s risk assessment systems.
Changes
| Parameters | Change | Resources or endpoints |
|---|---|---|
| car_rental_data flight_data lodging_data | Added | Charge#capture. payment_details Charge#update. payment_details PaymentIntent#capture. payment_details + 6 more PaymentIntent#confirm. payment_details PaymentIntent#create. payment_details PaymentIntent#update. payment_details PaymentIntent#confirm. payment_method_options. klarna PaymentIntent#create. payment_method_options. klarna PaymentIntent#update. payment_method_options. klarna |
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-11-17. preview
- 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.