Klarna Direct

Payments on restricted businesses

Submit the supplementary purchase data Klarna requires for restricted business categories. Specific Merchant Category Codes (MCCs) trigger additional reservation or seller details that must be present on both the Payment Request and the authorize call.

Overview

Some business categories (defined by their Merchant Category Code, or MCC) are subject to additional regulatory and compliance requirements. When the Partner's account is configured with one of these MCCs, extra fields must be included inside supplementary_purchase_data on both createPaymentRequestAPI and authorizePaymentAPI so Klarna can underwrite, authorize, and report on the transaction in compliance with applicable rules.
This page lists the MCCs in scope and the data points Klarna expects for each category. The Partner's checkout, backend, or order management system must be able to populate these fields whenever a transaction falls under one of these categories.
The assigned MCC is set during Klarna onboarding and reflects the goods or services the Partner sells. When operating across multiple categories or unsure which MCC applies to the account, contact Klarna Support.

Required supplementary data per MCC

The table below lists the MCCs that require additional supplementary_purchase_data fields and which fields to provide.
Goods and ServicesMCCsRequired supplementary_purchase_data fields
Airlines (card network classification)3000–3308, 4511travel_reservations
Automobile/vehicle rentals (card network classification)3351–3441travel_reservations
Hotels and motels (card network classification)3500–3999lodging_reservations
Steamships and cruise lines4411, 4457travel_reservations
Airlines and air carriers (not elsewhere classified)3000–3308, 4511, 4722, 5962travel_reservations
Transportation services4789travel_reservations
Marketplaces5262marketplace_seller_details
Lodging (hotels, motels, and resorts)7011, 4722, 5962lodging_reservations
Timeshares7012lodging_reservations
Automobile rentals7512travel_reservations
Travel agencies and tour operators4722, 4723travel_reservations, event_reservations
Truck and utility trailer rentals7513travel_reservations
Theatrical producers (excluding motion pictures) and ticket agencies7922event_reservations
Bands, orchestras, and miscellaneous entertainers (not elsewhere classified)7929event_reservations
Amusement parks, circuses, carnivals, and fortune tellers7996event_reservations
Aquariums, seaquariums, zoos, and dolphinariums7998event_reservations
When the required fields for the Partner's MCC are missing or malformed, the authorization may be declined or settlement and reporting may be blocked downstream. Validate that both the createPaymentRequest and authorizePayment requests carry the correct supplementary_purchase_data block for every Payment Transaction in scope, and keep the values consistent across the two calls.

How to include the data

Add the relevant block to supplementary_purchase_data in the request body of:
  • createPaymentRequestAPI: so Klarna has the context it needs for risk evaluation and to render the Klarna Purchase Journey correctly.
  • authorizePaymentAPI: so the resulting Payment Transaction is created with the data needed for authorization, settlement, and reporting.
The schemas of travel_reservations, lodging_reservations, event_reservations, and marketplace_seller_details are documented in the API reference for each operation. Use the same values on both calls. Significant discrepancies between the Payment Request and the authorize call can cause Klarna to require re-confirmation or to decline the authorization.
For general guidance on supplementary_purchase_data (including line items, customer, and shipping) see Supplementary purchase data.
Related articles
Sharing supplementary purchase data