Create merchant Account
OpenAPI SpecTest this endpoint live
Open the same request directly in API Explorer.
Server URL
Create a merchant account associated with your partner profile and invite its owner by email.
Authenticate using your partner key as an Authorization: Bearer header.
A missing or malformed key returns 401; a key rejected by authentication returns 403.
Authorization
BearerAuth In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Optional address and contact fields may be omitted or null. A non-null VAT number requires a non-null countryCode.
The name of the merchant, typically the company name or the name of its domain or app.
1 <= length"Merchant Name"The email address invited to join the created merchant account with ownership privileges.
email1 <= length <= 255"owner@merchant.dk"The primary currency of the merchant. Must be a valid ISO 4217 alpha-3 currency code.
3 <= length <= 3"DKK"The primary language of the merchant, expressed as a two-character language code.
2 <= length <= 2"da"The primary timezone of the merchant.
1 <= length"Europe/Copenhagen"The merchant website. Accepts a domain name or a URL.
"merchant.dk"The first merchant address line.
1 <= length"Merchant Street 1"The second merchant address line.
1 <= length"Floor 2"The merchant city.
1 <= length"Copenhagen"The merchant postal code.
1 <= length <= 32"2100"A valid ISO 3166-1 alpha-2 country code. Required when vat is non-null. If omitted or null without VAT, the country is derived from language, falling back to DK. Use GB for the United Kingdom and GR for Greece.
2 <= length <= 2"DK"The primary contact phone number. Must be non-empty when supplied; no specific phone format is enforced.
1 <= length"+45 12345678"The merchant VAT number without a country code prefix or separators for the countries listed below.
- AT:
^U[0-9]{8}$ - BE:
^[0-9]{10}$ - BG:
^[0-9]{9,10}$ - CY:
^[0-9]{8}[A-Z]$ - CZ:
^[0-9]{8,10}$ - DE:
^[0-9]{9}$ - DK:
^[0-9]{8}$ - EE:
^[0-9]{9}$ - ES:
^([A-Z][0-9]{7}[A-Z0-9]|[0-9]{8}[A-Z])$ - FI:
^[0-9]{8}$ - FR:
^[0-9A-HJ-NP-Z]{2}[0-9]{9}$ - GB:
^([0-9]{9}([0-9]{3})?|(GD|HA)[0-9]{3})$ - GR:
^[0-9]{9}$ - HR:
^[0-9]{11}$ - HU:
^[0-9]{8}$ - IE:
^([0-9]{7}[A-Z]{1,2}|[0-9][A-Z+*][0-9]{5}[A-Z])$ - IT:
^[0-9]{11}$ - LT:
^[0-9]{9}([0-9]{3})?$ - LU:
^[0-9]{8}$ - LV:
^[0-9]{11}$ - MT:
^[0-9]{8}$ - NL:
^[0-9]{9}B[0-9]{2}$ - NO:
^[0-9]{9}(MVA)?$ - PL:
^[0-9]{10}$ - PT:
^[0-9]{9}$ - RO:
^[0-9]{2,10}$ - SE:
^[0-9]{10}01$ - SI:
^[0-9]{8}$ - SK:
^[0-9]{10}$
1 <= length <= 32"12345678"Response Body
application/json
application/json
application/json
application/json