Price Plans

After the Acquiring Partner signs a contract with Klarna and agrees on pricing, Klarna will create a Price Plan that connects the partner account to fees and Payment Products.

Price Plan is a core entity and is used to manage how prices are set and updated for Acquiring Partners and Partners.

Relationships & Dependencies

Each Price Plan is linked to a Rate Card, which stores the actual rates. Rate Cards are reusable and required for every Price Plan. A Partner Account can have multiple Price Plans, but only one is required for onboarding.

graph %% Nodes PA(Partner Account) PP(Payment Profile) PPD(Payment Product) PPLAN(Price Plan) %% Relationships PA -->|1..1| PP PP -->|1..n| PPD PPD -->|1..1| PPLAN class PPLAN primaryEntity

Resource Properties

Price PlansKlarna Icon
GET:/v2/distribution/products/payment/price-plans/{price_plan_id}
Show recommended
ParameterRequiredDescription
price_plan_id
Yes

The identifier assigned to the price plan

rates
Yes
rates[]
Yes
version
Yes

Version number

effective_from
Yes

Timestamp in ISO 8601 with timezone Valid examples:

  • 2025-06-24T05:51
  • 2025-06-24T05:51:48Z
  • 2025-06-24T05:51:48.1Z
  • 2025-06-24T05:51:48.12Z
  • 2025-06-24T05:51:48.123Z
Here you can find all required parameters for this operation readPricePlanKlarna Icon

Lifecycle

stateDiagram Price_Plan_Default : Price Plan Price_Plan_Version_1 : Price Plan Version 1 Price_Plan_Version_2 : Price Plan Version 2 Rate_Card_Standard_GKD : Rate Card A Rate_Card_Default : Rate Card B Price_Plan_Default --> Price_Plan_Version_1 : Active, Effective from 2024-01-01 until 2024-03-31 Price_Plan_Default --> Price_Plan_Version_2 : Inactive, Effective from 2024-04-01 Price_Plan_Version_1 --> Rate_Card_Standard_GKD Price_Plan_Version_2 --> Rate_Card_Default

Price Plans can have multiple versions, allowing for future-dated changes and version control. The management process includes creating the Rate Card, associating it with a Price Plan, and setting effective dates. The process is documented and managed internally, with specific steps for creation, updating, and sharing with partners. When a Price Plan has been requested and created, it can only have one state: Published.

Integration with Partner Management API

To expose and use Price Plans in transactions and for partners, Partner Management API sets its price plan id in the distribution profile.

Frequent Use Cases

Create a Price Plan for new Acquiring Partner

Pricing Team while onboarding process can request Price Plan creation.

Use Price Plan to price transaction

Every transaction will be priced by requested parameters such as Price Plan and Payment Program and others.

Get Price Plans for Acquiring Partner

Get Price Plan information

Related articles