​When integrating to Klarna's APIs, every operation is executed targeting Partner Accounts and its Products. This article provides an overview of this model and will help you understand our APIs going forward.

A Partner Account represents a company working with Klarna. It’s the most basic object that allows you or your partners to operate on the Klarna Network ecosystem.

While Partner Accounts represent who is interacting with Klarna, Partner Products represent what from the Klarna’s product offering the account may utilize.

Partner Products have a type indicating the exact product from Klarna is associated with it, and each type of product is associated with its own configuration. Currently, the only types available are Payment Product and Payment Acquiring Product.

Represents the Payments offering from Klarna, not associated with a specific payment program, but all Klarna’s payment products.

Payment Products are always connected to a Payment Profile, which defines the pricing and payment programs that are going to be applied to that partner.

Payment Accounts also exist below the Payment Product, and are used to assign an identifier to the connection of the Payment Product configuration to an MCC, Brand and similar. Payment Accounts allow you to support even the most complex account structures.

For more detailed information, see “Modeling your partner’s accounts”

Represents the Acquiring Partner offering, allowing acquiring partners to onboard and manage their own partners at Klarna.

Payment Acquiring Acquiring holds all Payment Profiles you can use when onboarding your partners together with your list of Payment Acquiring Accounts. Acquiring Accounts provide a very powerful tool to cater for cases where you are working with multiple legal entities and settlement configurations, allowing a truly global company to operate seamlessly at Klarna

For more detailed information, see “Understanding your own account”

Besides the Partner Account and its Products, there are other resources of an account that enhance the experience of consumers and merchants when interacting with Klarna:

• Partner Business Entities: Represent a legal entity and any metadata associated with it
• Stores: Represent the location, physical or digital, where Klarna’s products and services can be used
• Brands: Are the visual representation of a company, its visual assets and links.
• Store Groups: Allow multiple stores to share a single Brand.

Ensuring these resources are accurate during the onboarding and maintaining their accuracy along the time is essential not only to improving customer experience but also allowing Klarna to execute its fraud and risk controls better.

Partner Accounts are used for managing the relationship between your Partners and Klarna Payment Services. These accounts, created and managed via Klarna’s Management API, contain critical information to facilitate a successful partnership. These blocks consist of:

• Partner Account contact: Information about the main representative of the Partner for Klarna. This data point is used in case we need to reach out to the Partner directly.
• Products: List the Klarna products and configuration the Partner account is onboarded with. At the moment the only available product type is PAYMENT .
• Payment Accounts: Payment accounts connect various attributes, such as the Partner Business Entity, the Payment Acquiring Account(s) Klarna has configured for the Acquiring Partner, and the default Merchant Category Code for the Partner Business Entity.
  • For each legal entity used by the Acquiring Partner to distribute Klarna as a payment method to their Partners, Klarna will configure a unique Payment Acquiring Account. Each Payment Acquiring Account contains the settlement configuration Klarna will use to pay out the Acquiring Partner.
• Stores & Branding: Lists containing the details of the website, mobile app or physical store where Klarna products are going to be made available as well as the related branding data.
• Partner Business Entities: Any information relevant for Klarna to efficiently run its fraud prevention functionality.

If a Partner operates through multiple entities, Klarna prefers that the account structure be simplified towards Klarna by creating a single Partner Account containing multiple Partner business entities and associated Payment Accounts.

However, as the Acquiring Partner, you should align the creation of Klarna's Partner Accounts with the structure reflected in your own systems.

Overall, it is required that a Partner be able to enable Klarna without additional effort as compared to cards or any other low-friction payment method.

Product and Account lifecycles are independent, more information available in the Manage your Partner section.