Klarna Docs - Partner Stores and Brands

Partner Stores and Brands

Define and manage Partner Stores, Brands, and Store Groups to ensure a seamless Klarna shopping experience, maintaining accurate references and brand consistency.

Acquiring Partners must define stores and brand attributes of the Partners they onboard with Klarna.

Stores

A key component of a Partner Account is the store. Stores represent where Klarna Payment Services are going to be available to customers via the Partner.

As multiple stores can be declared when onboarding a Partner, Acquiring Partners must indicate a unique store_reference for each Partner store.

The store_reference must be indicated when processing payments with Klarna in case multiple stores have been declared for an onboarded Partner. This ensures the correct brand identity is displayed to customers, enhancing their shopping experience. Accurate identifying the payment store is also crucial for the effectiveness of Klarna’s fraud assessment systems.

Future releases will support multiple stores within a single account.

Stores can be one of the following types:

Types	Definition
Website	Online store where Klarna’s payment products are shown
Physical store	Brick and mortar store where a customer can use Klarna to pay for goods
Mobile app	Mobile app where Klarna’s payment options can be used

Depending on the type set for the store, different sets of parameters will be required. For more information, please refer to the API reference.
Sample request - stores submitted when onboarding a Partner

JSON

{
  "stores": [
    {
      "type": "WEBSITE",
      "store_reference": "web131231",
      "url": "https://example.com/store"
    },
    {
      "type": "PHYSICAL_STORE",
      "store_reference": "store1234",

Each partner account must have at least one store. If an account has only one store, no further specifications are required.

Acquiring Partner can read and update store details defined on a Partner Account through the following endpoints:

Future releases will support additional endpoint to create or delete a store on a Partner Account

Brands

A Brand is the set of names, logos and colors that facilitate communication and marketing towards consumers for an onboarded Partner.

The Acquiring Partner must share the brand details from their Partners during onboarding so that they can be used to enhance the customer purchase experience and post-purchase experience, including interactions in the Klarna app.

Sample request - brands submitted when onboarding a Partner

JSON

{
  ...
  "brands": [
    {
      "brand_reference": "Partner Brand",
      "display_name": "Cool Brand",
      "element": {
        "logo_url": "https://example.com/logo.png",
        "icon_url": "https://example.com/icon.png",
        "feature_image_url": "https://example.com/feature_image.png"

At a minimum, Acquiring Partners must submit the following parameters when setting the brand details during onboarding:

display_name: the Partner brand which will be displayed to the consumer when completing the Payment on the Klarna Purchase Journey
brand_reference: identifier assigned by the Acquiring Partner which will be used to connect a declared store group with a brand.

Acquiring Partner can read and update brand details defined on a Partner Account through the following endpoints:

Future releases will support additional endpoint to create or delete a brand on a Partner Account

Store groups

A Store Group is a collection of Stores which is designed to unify the Partner brand identity across various customer touch points.
Each store group includes Partner-specific details such as branding, support contact, and social media links that will apply to all stores within the Store group. This is crucial for enhancing the customer's purchase and post-purchase experience, including interactions in the Klarna app.

Acquiring Partners must submit a minimum of one store group with the following parameters when onboarding their Partners:

store_group_reference: for each store group created, the Acquiring Partner must assign a unique reference to identify each store group defined for their Partners.
stores: a store group must contain one or multiple stores as defined in the store section.
brandreference: To efficiently manage the Partner brand across multiple stores, Acquiring Partner must assign a brand_reference attribute on a store_group.

Sample request - store_groups submitted when onboarding a Partner

JSON

{
  "store_groups": [
    {
      "store_group_reference": "STORE_NY004",
      "brand_reference": "2wrgqrwgf",
      "stores": [
        {
          "type": "WEBSITE",
          "store_reference": "web131231",
          "url": "https://example.com/store"

Acquiring Partner can read and update store groups defined on a Partner Account through the following endpoints:

Future releases will support additional endpoint to create or delete a brand on a Partner Account.