A Partner Business Entity represents a specific business using Klarna’s Products. It is linked to a legally registered entity and enables Acquiring Partners to declare and manage entities within their Partner Account through the Klarna Management API.

Partner Business Entities exist to ensure compliance, audit traceability, and structured onboarding of each business under a Partner Account.

Diagram: Relationship between Partner Account and Partner Business Entity.

• Each Partner Business Entity belongs to a Partner Account.
• It references a legally registered company identified by legal_registered_entity_name and Legal Registration Number.
• An Acquiring Partner can register multiple Partner Business Entities under a single Partner Account.

Partner Business Entities

Copied

PATCH:/v2/accounts/{partner_account_id}/partner-business-entities/{partner_business_entity_id}

Response Body

Show recommended

Parameter	Required	Description
Copied partner_business_entity_id	Yes	Klarna Resource Identifier (KRN) used to identify the partner business entity.
Copied partner_business_entity_reference	Yes	Provide a unique reference used by the integrator to identify a specific Partner entity within their system. This reference is used to associate requests with the correct Partner entity.
Copied legal_registered_entity_name	Yes	Provide the official registered name of the Partner’s legal entity to identify the organization in legal and compliance contexts. The server stores this name as part of the Partner’s legal entity data. Ensure the value is a non-empty string... Show more
Copied legal_registration_country	Yes	Provide the two-letter country code in ISO 3166‑1 alpha‑2 format for the indicated address. The system accepts only predefined country codes such as US, DE, SE, and AU. Treat the country code as an opaque string, do not parse or interpret i... Show more

Here you can find all required parameters for this operation updatePartnerBusinessEntity

The supplementary_business_data object may include the following sub-objects:

Klarna and the Acquiring Partner define which data points are mandatory during the contracting phase.

Partner Business Entities are created automatically when a Partner Account is established. Once created, their lifecycle is managed internally by Klarna systems:

• Created: Automatically when the Partner Account is registered.
• Updated: Through updatePartnerBusinessEntity API for compliance or branding changes.
• Disabled: When associated Products are deactivated.
• Archived: (Planned) Future API functionality will enable deletion or archival.

The Acquiring Partner declares and links business entities during Partner registration.

Update legal name or registration details following rebranding or jurisdictional changes.

Retrieve all Partner Business Entities under a Partner Account for audit or payout reconciliation.

The following endpoints manage Partner Business Entity data under an existing Partner Account:

• createPartnerBusinessEntity
• getAllPartnerBusinessEntities
• getPartnerBusinessEntities
• updatePartnerBusinessEntity