API and SDKs
Partner Business Entities

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 entity
  • legal_registration_country: Country where the legal entity is registered (ISO 3166-1 alpha-2 format).

Sample request - partner_business_entities submitted when onboarding a Partner

JSON
{ 
  ...
  "partner_business_entities": [
    {
      "partner_business_entity_reference": "LE_US002",
      "legal_registered_entity_name": "Legal Entity LLC",
      "legal_registration_country": "US",
      "supplementary_business_data": {...}
    }
  ]

Klarna may also require the Acquiring Partners to provide complementary information about the onboarded Partner through the supplementary_business_data object:

Partner Business Entities
API
POST:/v2/accounts/{partner_account_id}/partner-business-entities
Show recommended
ParameterRequiredDescription
Here you can find all required parameters for this operation createPartnerBusinessEntity
API

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.

Official registration number of the legal entity in the relevant country’s business or corporate registry. This identifier is usually assigned by the government authority responsible for company formation and maintenance of the corporate registry.

Key Points

  • Always use the official identifier from the national/company registry.
  • The format varies significantly by country (alphanumeric, numeric, or mixed).
  • Some jurisdictions require additional contextual information to ensure uniqueness (e.g., Germany).

Examples by Country

CountryOfficial name (common)RegexExample(s)Notes
AT AustriaFirmenbuchnummer (excl. VAT)^(?!ATU\d{8})(?!K6\d{5}$).{5,11}$FN 123456aExplicitly excludes VAT ATU and social K6 IDs.
AU AustraliaACN/ABN^\d{9}d{11}$123456789, 12345678901
AX ÅlandOrg. ID^[A-Z]{2}\d{7}-\d$AX1234567-1Prefix + 7 digits + check.
BE BelgiumBCE/KBO^[01](\.?\d){9}$0123.456.789Dots optional.
BG BulgariaЕИК^\d{9}$1234567899 digits.
BY BelarusUNP^\d{9}$1234567899 digits.
CA CanadaBusiness/provincial no.(^\d{2}-\d{7}$)(^\d{3}-\d{2}-\d{4}$)(^\d{9}$)(^\d{6}-\d{1}$)(^\d{10}$)12-3456789, 123-45-6789, 123456789Multiple provincial formats.
CH SwitzerlandUID^[A-Z]{3}-\d{3}\.\d{3}\.\d{3}$CHE-123.456.789Fixed prefix.
CY CyprusReg. No.^[A-Za-zΑ-Ω]{2} \d{6}$HE 123456Two letters + space + 6 digits.
CZ CzechiaIČO^\d{8}$256660018 digits.
DE GermanyHandelsregister (HRB/HRA etc.)^([g,G][n,N][r,R](PV)RHR(AB))( \d{3,6})( \w{1,2})?$^HRB \d{2}$HRB 123456Handelsregister number (e.g., HRB 12345). Must be combined with legal_registration_authority (e.g., “Amtsgericht Frankfurt am Main”), since numbers are only unique within a local court’s jurisdiction.
DK DenmarkCVR^\d{8}$123456788 digits.
EE EstoniaRegistrikood^\d{8}$102938478 digits.
ES SpainCIF/NIF(^[A-Za-z]\d{7,8}$)(^[A-Za-z]\d{6,7}[A-Za-z]$)(^\d{7,8}[A-Za-z]$)(^TF-\d{5}$)B12345678, 12345678Z, TF-12345Historic variants supported.
FI FinlandY-tunnus^\d{7}-\d{1}$1234567-8Hyphen required.
FR FranceSIREN/SIRET^(\d{3} ?\d{3} ?\d{3})( ?\d{5})?$552100554, 552 100 554 00013Spaces optional.
GA GabonRCCM^\d{9}$1234567899 digits.
GB United KingdomCompanies House No.^([0-9]{8}[A-Za-z][0-9]{7}[A-Za-z]{2}[0-9]{6})$012345678 digits.
GG GuernseyCompany No.^[A-Z]{3}\d{5}$GGG123453 letters + 5 digits.
GI GibraltarCompany No.^\d{5}$123455 digits.
GR GreeceGEMI^\d{12}$12345678901212 digits.
HK Hong KongCR No.^\d{7,8}$123456787–8 digits.
HR CroatiaMBS^\d{11}$0812345678911 digits.
HU HungaryCg. no.^\d{2}-\d{2}-\d{6}$01-09-123456Standard format.
ID IndonesiaNIB^\d{12}$12345678901212 digits.
IE IrelandCRO No.^([A-Za-z]{2})?[0-9]{6}$123456, IE123456Optional prefix.
IL IsraelCompany No.^\d{9}$5101234569 digits.
IM Isle of ManCompany No.^\d{6}[A-Z]$123456C6 digits + letter.
IS IcelandKennitala (org)^\d{10}$501234123010 digits.
IT ItalyCodice fiscale / P.IVA^(\d{11}[A-Z0-9]{16})$12345678901, ABCDEFGH1234567
JE JerseyCompany No.^\d{6}$1234566 digits.
JP JapanHoujin Bangou^\d{13}$123456789012313 digits.
LI LiechtensteinUID^[A-Z]{2}-\d{4}\.\d{3}\.\d{3}-\d$LI-1234.567.890-1Includes prefix + check.
LT LithuaniaLegal Entity Code^\d{9}$1234567899 digits.
LU LuxembourgRCS^[A-Z]\d{6}$B123456Letter + 6 digits.
LV LatviaReģ. Nr.^\d{11}$4000301234511 digits.
MT MaltaROC No.^[A-Z]\d{5}$C12345Single-letter + 5 digits.
MX MexicoRFC (moral persons)^[A-Za-z]{3,4}\d{6}[A-Za-z0-9]{3}$ABC010203XYZLetters + date + suffix.
NL NetherlandsKvK-nummer^\d{8}$302812678 digits.
NO NorwayOrganisasjonsnummer^\d{9}$9846611859 digits.
NZ New ZealandNZBN^\d{13}$942903123456713 digits.
PA PanamaRegistro^\d{9}$1234567899 digits.
PL PolandREGON (company)^\d{10}$123456785010 digits.
PT PortugalRNPC^\d{9}$5001234569 digits.
RO RomaniaONRC^([A-Z]\d{2}/\d{3,5}/\d{4})(^[JFC]\d{4}\d{6}\d{2}\d{1})$J40/12345/2020
SE SwedenOrganisationsnummer^\d{6}-\d{4,5}$556016-0680Dash required.
SG SingaporeUEN (simplified)^\d{9}[A-Z]$123456789ANumeric + suffix only.
SI SloveniaCompany ID^\d{10}$123456789010 digits.
SK SlovakiaIČO^\d{2}\s\d{3}\s\d{3}$12 345 678Spaces required.
SM San MarinoCompany No.^[A-Z]{2}\d{5}$SM123452 letters + 5 digits.
TR TürkiyeTicaret Sicil No.^(?:\d{5}-\d{5}\d{6}-\d)$12345-67890, 123456-7
US United StatesState File No.(^\d{2}-\d{7}$)(^\d{3}-\d{2}-\d{4}$)12-3456789, 123-45-6789State-specific variations.

Special Case: Germany (Handelsregister)

In Germany, the legal_registration_number alone is not sufficient for uniquely identifying a legal entity.

To ensure unambiguous identification, always capture both:

  • legal_registration_number: e.g., HRB 12345
  • legal_registration_authority: e.g., Amtsgericht München

Handelsregister numbers (HRB) are not unique across all German district courts, so including the registration authority is necessary to avoid misidentification.

Acquiring Partner can create and update Partner Business Entity details defined on an existing Partner Account through the following endpoints:

Future releases will support additional endpoint to delete Partner Business Entities on a Partner Account.