Partner Business Entities
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.
49 min read
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 and Dependencies
graph
PBE(
Partner Business Entity
)
PA(Partner Account)
PP(Payment Product)
PAA(Payment Account)
PT(Payment Transaction)
PA -->|1..n|PBE
PA --> PP
PP -->|1..n| PAA
PAA -->|n..1| PBE
PT -->|1..n| PAA
PT -.->|counter party| PBE
PBE -->|n..1| LE(Legal Registration)
class PBE primaryEntity
- 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
Supplementary business data
The
supplementary_ object may include the following sub-objects:| Object | Definition |
|---|---|
legal_ | Legal registration data including the Legal Registration Number. |
operating_ | Contains the list of physical addresses associated with the entity. |
stakeholders | Lists beneficial owners and authorized signatories. |
partner_ | 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.
API & SDK references
Jump to section...