Merchant

Example

{
  "Name": "Selling Company Group",
  "OrganizationNumber": "9912139814",
  "VatRegistrationCode": "SE991213981401",
  "CountryCode": "SE",

  "ContactInformation": {
    "Name": "John Doe",
    "Address": {
      "AddressLine1": "Street address 11",
      "City": "Gothenburg",
      "PostalCode": "41103",
      "CountryCode": "SE"
    },
    "Phone": "+46730000111",
    "Email": "contact@sellingcompanygroup.com",
    "WebsiteUrl": "https://sellingcompanygroup.com",
  }

  "InvoiceInformation": {
    "Address": {
      "AddressLine1": "Street address",
      "City": "Gothenburg",
      "PostalCode": "41103",
      "CountryCode": "SE"
    },
    "Email": "invoice@sellingcompanygroup.com"
  }
}

Merchant Properties

Property	Required	Explanation
Name	Yes	Name of the selling company.
OrganizationNumber	Yes	Organization number / Company registration number of the selling company. See validation
VatRegistrationCode	Yes	VAT registration number of the selling company. See validation
CountryCode	Yes	CountryCode of residence. AT, BE, BG, CA, CY, CZ, DE, DK, EE, ES, FI, FR, GB, GR, HR, HU, IE, IS, IT, LI, LT, LU, LV, MT, NL, NO, PL, PT, RO, SE, SI, SK, US
ContactInformation	Yes	Contact information. See ContactInformation
InvoiceInformation	Yes	Invoice information. See InvoiceInformation

ContactInformation properties

Property	Required	Explanation
Name	Yes	The name of the contact person
Address	Yes	Company address. See Address
Phone	Yes	Phone of the selling company.
Email	Yes	Email of the selling company. Type Address
WebsiteUrl	Yes	Website url of the selling company.

InvoiceInformation properties

Property	Required	Explanation
Address	Yes	Invoicing address. See Address
Email	No	Email of the selling companys invoice department or equivalent.

OrganizationNumber validation

Market	Validation method
SE	10 digits where the last digit is a checksum digit that is calculated from the previous 9 digits. This is done using the Luhn algoritm. This is the same method being used for civig registration numbers in Sweden. To differ civic numbers from company registration numbers (org. number), digit 3 and 4 are always > 20. See more details here
NO	9 digits where the last digit is a checksum digit that is calculated by multiplying fixed weight numbers and calculating the rest using Modulo 11. See more details on brreg.no
FI	8 digits where the last digit is a checksum digit that is calculated by multiplying fixed weight numbers and calculating the rest using Modulo 11. See more details on finlex.fi
DK	8 digits where the last digit is a checksum digit that is calculated by multiplying fixed weight numbers and calculating the rest using Modulo 11.
*All other markets	No validation.

VatRegistrationCode validation

Market	Validation method
SE	OrganizationNumber prefixed with SE and suffixed with 01
NO	OrganizationNumber prefixed with NO and optional suffixed with MVA
FI	OrganizationNumber prefixed with FI
*All other markets	Prefixed with 2 A-Z and followed by 5-12 regular characters.

Address

Example

{
  "AddressLine1": "Street address",
  "AddressLine2": "Floor 2, building C",
  "City": "Gothenburg",
  "PostalCode": "41103",
  "CountryCode": "SE"
}

Properties

Property	Required
AddressLine1	Yes
AddressLine2	No
City	Yes
PostalCode	Yes
CountryCode	Yes