Enhance transactions with Klarna’s Supplementary Purchase Data to improve customer experience, optimize risk management, and unlock upselling opportunities.
Supplementary Purchase Data refers to additional data points that provide additional context related to a transaction to improve outcomes and customer experience. While these data points are technically optional, they are often required to enhance underwriting and fraud assessment, as well as to improve the customer's post-purchase experience.
This information supports different use cases and may include data associated to specific industries or business models such as airline, marketplaces, as well as data related to the transaction (line items, subscriptions and on demand transactions) or even custom data.
The supplementary data shared with Klarna will support multiple use cases and add value in different fronts such as:
The following table list the supplementary_purchase_data
shared with Klarna will support multiple use cases and add value in different fronts such as:
Supplementary Purchase Data | Details |
---|---|
purchase_reference | Used for storing the customer-facing order number. It will be displayed to customers on the Klarna app and other communications channels between the customer and Klarna. It will also be included in settlement reports for the purpose of reconciliation. For Acquiring Partners, this is the reference your Partners share for their customer orders. |
customer | This represents who the customer is according to the merchant. These data points may be used by Klarna to simplify the authenticate /sign-up on the Klarna Purchase Journey and during fraud assessment. |
shipping | Shipping information for the purchase. This data is used for fraud detection and customer communication: This shipping array also support:
|
line_items | Applicable for any Partners, represents essential detailed information such as the name, quantity, and unit price of a purchase. |
customer.customer_accounts customer.customer_device | Applicable for any segment, if a Partner supports registered checkout to complete a purchase. |
travel_reservations | Applicable for any Partner that offers travel services including flights,bus, train, ferry, car rental. See specific Merchant Category Codes required to provide this information on Restricted businesses. |
lodging_reservations | Supplementary lodging details, such as hotel booking details. See specific Merchant Category Codes required to provide this information on Restricted businesses. |
insurances | Applicable for any Partner that offers any type of standalone insurance policy. |
vouchers | Applicable for any Partner that offers to buy coupons or vouchers that are later exchanged for a service. |
event_reservations | Applicable for any Partner that offers tickets to access for events, such as a concert or a sporting event. See specific Merchant Category Codes required to provide this information on Restricted businesses. |
ondemand_service | Applicable to any Partner that enables registration of the payment method to complete purchases faster on-demand. See details on Tokenized Payments. |
subscriptions | Applicable to any Partner that offers subscriptions to their customers. See details on Tokenized Payments. |
in_store_services | Applicable for any segment, if the transaction is done in a physical store. |
marketplace_seller_details | Applicable when enabling marketplace services and processing transactions for sub-seller. |
Line items stand at the crossroads of Klarna's operations and are crucial in enhancing Klarna's fraud detection, underwriting capabilities, and customer experience. By breaking down transactions into individual units, they provide detailed insights that streamline dispute resolution and efficient interaction within the Klarna app, while reducing customer support errands.
The purchase_reference
field is a required identifier used throughout the payment process to support various partner and customer-facing activities. This parameter should correspond to the Partners customer-facing order reference. Ensuring this parameter is both consistently applied and understandable to end consumers is helpful in minimizing errands and ensuring customer satisfaction. Below are some key use cases:
purchase_reference
in all touchpoints with the consumer, ensuring clear communication and understanding within the Klarna App, email communications, and push notifications regarding order status.purchase_reference
provides all involved parties with an aligned understanding of the order being discussed, reducing the chances for confusion or human error for both customers and customer service agents.purchase_reference
may act as a fallback to ensure continuity and traceability within the transaction.Purchase reference plays a key role in supporting visibility and alignment between all parties, and drives increased customer satisfaction.
Acquiring Partners must map existing fields in their payment API with the fields defined in the supplementary_purchase_data
object of the Payment Authorize API.
Sample Authorize Payment request with supplementary_purchase_data
{
"currency": "EUR",
"request_payment_transaction": {
"amount": 2079,
"payment_transaction_reference": "payment-transaction-reference-36ac766a-[...]"
},
"supplementary_purchase_data": {
"purchase_reference": "merchant-purchase-reference-deafb375-6fe4-4856-8087-36d8296d1dc7",
"line_items": [
{