Partner Business Entities are used to efficiently onboard by validating compliance with Klarna’s legal and operational requirements. This includes confirming legal entity registration, assigning unique business references, and capturing all mandatory business details needed for setup and integration through the Partner Business Entity.
Overview
Partner Business Entities represent a legal entities associated with the company. Partner Business Entities exist to ensure compliance, audit traceability, and structured onboarding of each business under a Partner Account.
Relationships & Dependencies
- 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.
Resource properties
/v2/accounts/{partner_account_id}/partner-business-entities/{partner_business_entity_id}| Parameter | Required | Description |
|---|---|---|
partner_business_entity_id | Yes | Klarna Resource Identifier (KRN) used to identify the partner business entity. |
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. |
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 |
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 |
Supplementary business data
The supplementary_business_data object may include the following sub-objects:
| Object | Definition |
|---|---|
| Legal registration data including the Legal Registration Number. |
| Contains the list of physical addresses associated with the entity. |
| Lists beneficial owners and authorized signatories. |
| Defines the payout configuration per entity. |
Klarna and the Acquiring Partner define which data points are mandatory during the contracting phase, for example which stakeholder details and operating addresses must be provided before transactions can be processed.
Lifecycle
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.
- Deletion or archival is not yet available via API and is planned for a future release.
Frequent Use Cases
Onboard new Partners
The Acquiring Partner declares and links business entities during Partner registration at onboarding. Learn more about how to execute the onboard operation.
Update Partner details to meet compliance requirements
Update legal name or registration details following rebranding or jurisdictional changes. Understand compliance requirements to maintain onboarded Partners information up to date and maintain a secure and compliant network.
Reporting
Retrieve all Partner Business Entities under a Partner Account for audit or payout reconciliation.