Merchant

A Merchant is a business and a User can own and/or manage multiple businesses. Within SumUp every Merchant is identified by its merchant code, typically a string like MK01A8C2. For a detailed list of properties of the Merchant, please have a look at the Merchants API reference.

Company

The company field of the Merchant contains the business’s legal information. This is the data SumUp checks when verifying the merchant before enabling products.

Company Identifiers

A key part of the company data are identification numbers contained in the identifiers array. Each identifier is a CompanyIdentifier object with:

• ref (string): the unique reference for the identifier type
• value (string): the actual identifier value

For every identifier, we use a unique reference as key following the pattern {country_code}.{identifier_type}. The prefix indicates the country (using ISO 3166-1 alpha-2 codes), and the suffix identifies the specific type of identifier.

Example:

{
  "identifiers": [
    {
      "ref": "de.hrb",
      "value": "HRB 123456 B"
    },
    {
      "ref": "de.ust_idnr",
      "value": "DE123456789"
    }
  ]
}

Legal Types

Legal type is the official way the business is set up and recognized by the law. Legal types are of the pattern {country_code}.{identifier_type}. The prefix indicates the country (using ISO3166-1 alpha-2(Opens in a new tab)), and the suffix identifies the specific legal type within that country.

Business Profile

A Merchant’s business profile contains information that a Merchant wants to be publicly visible for their customers, for example on their website.

Addresses

For address structure, fields, and country-specific requirements, see the Address glossary.

Persons

A Person is someone who plays some legally relevant role in the Merchant.

Person Relations

Persons can have various roles within a merchant:

• Legal Representative: the person legally representing the business towards SumUp
• Business Owner: owner of the business (especially for sole traders)
• Business Officer: officer of the business (for corporations)

Person Identifiers