API and SDKs
Payment Profiles

Payment Profiles connect payment configuration details, such as pricing and product availability, to payment products, allowing one configuration to be shared across multiple partners.

A Payment Profile connects a Payment Product to a Price Plan and a Payment Program Plan. Klarna creates and manages these profiles, which are shared with Acquiring Partners together with API credentials. Payment Profiles enable multiple Partners under the same Acquiring Partner to share a unified payment configuration, simplifying management and reducing duplication.

Link copied!

graph PA(Partner Account):::nodeEmphasis PP(Payment Product):::nodeDefault PAA(Payment Account):::nodeDefault PPRO(**Payment Profile**):::accent PT(Payment Transaction):::nodeEmphasis PRI(Payment Price Plan):::nodeSubtle PRO(Payment Program Plan):::nodeSubtle %% MCC(Merchant Category Code):::nodeSubtle %% SG(Store Group):::nodeSubtle %% AA(Payment Acquiring Account):::nodeDefault %% PBE(Partner Business Entity):::nodeSubtle %% SC(Settlement Configuration):::nodeDefault %% ALE(Acquiring Legal Entity):::nodeDefault PA -->|1..1| PP PP -->|1..n| PAA PP -->|1..1| PPRO PPRO -.->|defines configuration for| PT PAA -->|1..n| PT PPRO -->|n..1| PRI PPRO -->|n..1| PRO %% AA -->|n..1| PAA %% AA --> SC %% AA -->ALE %% PAA -->|1..1: default| MCC %% PAA -->|1..1: default| SG %% PAA -->|1..1| PBE
  • Payment Products:The payment profile may be used for one or many different Payment Products
  • A Price Plan: defines the pricing structure applied to transactions.
  • A Payment Program Plan: defines which Klarna Payment Programs the consumer will interact with.

Link copied!

Payment ProfilesKlarna Icon

Copied

GET:/v2/distribution/products/payment/profiles
Show recommended
ParameterRequiredDescription

Copied

payment_profile_id
Yes

ID assigned to the payment product at onboarding, outlining all configurations such as price plans and payment program plans.

Copied

price_plan_id
Yes

The identifier assigned to the price plan

Here you can find all required parameters for this operation listPaymentDistributionProfilesKlarna Icon

Link copied!

There is no specific lifecycle associated with a Payment Profile because it is a static configuration object managed entirely by Klarna.

Link copied!

No webhook or event notifications are connected to this resource.

Link copied!

Link copied!

Payment Profiles are used during onboarding when creating a Partner Payment Product. It's required to define which Payment Profile the product will use, ultimately defining transaction pricing and payment programs. Read more about this on the "Prepare the onboarding payload" guide.

Link copied!

In order to know the list of Payment Profiles available and their configuration, the listPaymentDistributionProfilesKlarna Icon operation can be executed, returning the following data:

JSON

Copied

[
  {
    "payment_profile_id": "krn:partner:global:account:distribution-profile:206bbb83-9b6e-46fa-940d-337153c04a58",
    "price_plan_id": "krn:partner:global:payment:price-plan:171080e7-2637-4675-a224-ec032723ebdf",
    "payment_program_plan_id": "krn:network:global:all:payment:payment-program-plan:33deb549-aa35-4102-b9ec-56c527386111"
  }
]

Which means only one Payment Profile is available to use, with the ID krn:partner:global:account:distribution-profile:206bbb83-9b6e-46fa-940d-337153c04a58. This profile can then be used to onboard a partner and will in turn affect the pricing and payment programs for transactions placed by this merchant.

Link copied!