Adds industry-specific transaction details and purchase data for cards and KlarnaPublic 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_, payment_, and payment_ 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. 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.