Adds QR code support for Klarna payments with Terminal readers
What’s new
Adds support for QR code-based Klarna payments on Terminal smart readers. When you process a Klarna payment on a Terminal reader, Stripe generates a QR code that customers scan to complete their payment using the Klarna mobile app.
This update adds the klarna_display_qr_code next action type for the Payment Intents API. When a Klarna payment requires customer interaction on Terminal, the PaymentIntent returns this next action with:
- QR code data and image URLs (PNG and SVG formats) for display on the Terminal reader
- An expiry timestamp for the QR code
The Klarna payment method details hash now also includes the reader and location fields when the payment originates from a Terminal reader. This helps provide more context about the location of the in-person transaction.
Impact
You can accept Klarna payments in person using Terminal smart readers with QR code functionality. When customers choose Klarna as their payment method on your Terminal reader, they receive a QR code to scan with their mobile device, allowing them to complete the payment flow through the Klarna app while remaining in your physical location. This feature requires the Terminal reader to support QR code display capabilities. If QR code generation isn’t available, the payment flow falls back to the standard redirect URL method.
To use this feature, ensure your Terminal integration handles the klarna_display_qr_code next action type and can display the provided QR code images on compatible Terminal readers.
Changes
| Parameters | Change | Resources or endpoints |
|---|---|---|
| location reader | Added | PaymentAttemptRecord. payment_method_details. klarna Charge. payment_method_details. klarna PaymentRecord. payment_method_details. klarna |
| klarna_display_qr_code | Added | PaymentIntent. next_action |
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-04-22. dahlia
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
Learn more about Stripe API upgrades.