Onboard Partner Business Entities efficiently by meeting Klarna’s requirements for legal entity registration, unique references, and necessary business details.
A Partner Business Entity represents a specific business that is utilizing Klarna's Products, and which is associated with a registered legal entity.
Acquiring Partners must declare a minimum of one Partner Business Entity with the following parameters when onboarding a Partner:
partner_business_entity_reference: Unique reference the partner uses to identify the business entity.legal_registered_entity_name: Official registered name of the legal entitylegal_registration_country: Country where the legal entity is registered (ISO 3166-1 alpha-2 format).enabled_merchant_category_codes: Merchant Category Codes the Partner Business Entity operates as.
Sample request - partner_business_entities submitted when onboarding a Partner
{
...
"partner_business_entities": [
{
"partner_business_entity_reference": "LE_US002",
"legal_registered_entity_name": "Legal Entity LLC",
"legal_registration_country": "US",
"enabled_merchant_category_codes": [
"5411"
],Klarna may also require the Acquiring Partners to provide complementary information about the onboarded Partner through the supplementary_business_data object:
- legal_registration: registration information of the Partner Business Entity.
- operating_addresses: Physical locations where the Partner Business Entity conduct their operations.
- stakeholders: Individuals associated with the Partner Business Entity.
- partner_payouts_state: Payouts state for this Partner Business Entity on the acquiring partner side.
The list of data points to be shared in the supplementary_business_data will be agreed between Klarna and the Acquiring Partner during the contractual stage.
Acquiring Partner can read and update Partner Business Entity details defined on a Partner Account through the following endpoints:
Future releases will support additional endpoint to create or delete Partner Business Entities on a Partner Account.