Merchant Creation

Description

Register merchants for the marketplace with the role Agent.

Learn more

HTTP Request

POST /marketplace/{qwqerId}/merchant

Path Parameters

Parameter	Type	Required	Description
qwqerId	string	Yes	Agent identifier issued during marketplace registration

Request Body

The request body must be in JSON format and contain the following fields:

Field	Type	Required	Description
externalId	string	Yes	Merchant unique identifier in your system
name	string	Yes	Merchant company name
link	string (URI)	No	Merchant’s website link
logoLink	string (URI)	No	Link to the merchant’s logo
email	string (email)	Yes	Merchant’s email (used for sending invoices and, in the future, for authorization in the admin panel)
addressFirst	string	No	Primary address (street, building, district, etc.)
addressSecond	string	No	Additional address (city, postal code, country)
paymentRegistrationNumber	string	No	Registration number for payments
paymentTaxNumber	string	No	Tax number (e.g., VAT)
paymentAdditionalLines	array of string	No	Additional payment details (e.g., IBAN, SWIFT, bank, etc.)

💡 Info

Fields addressFirst and the following ones are used when generating invoices.

Example Request Body

{
  "externalId": "1",
  "name": "SIA Example Name",
  "link": "https://example.site",
  "logoLink": "https://example.site/logo.png",
  "email": "admin@domain.com",
  "addressFirst": "Katla kalna iela 1, Latgales priekšpilsēta",
  "addressSecond": "Riga, LV-1073, Latvia",
  "paymentRegistrationNumber": "12345678901",
  "paymentTaxNumber": "LV12345678901",
  "paymentAdditionalLines": [
    "IBAN: LV01HABA1234567890123",
    "BANK: AS SWEDBANK",
    "SWIFT: HABALV22",
    "Country: Latvia"
  ]
}

Responses

✅ 201 Created

{
  "message": "Merchant created successfully",
  "data": {
    "qwqerId": "112233"
  }
}

💡 Info

Save the merchant’s qwqerId — it will be needed for subsequent API calls, for example when creating a Receipt.

✅ 302 Found — Merchant already registered for your externalId

{
  "message": "Merchant already exists",
  "data": {
    "qwqerId": "112233"
  }
}

❌ 400 Bad Request — Invalid data

{
  "message": "Invalid input data"
}

Possible reasons:

• Missing required fields
• Invalid email or URI format

❌ 404 Not Found — Marketplace not found

{
  "message": "This marketplace is not registered yet"
}

Possible reasons:

• The provided qwqerId does not match any registered marketplace
• The marketplace with the specified qwqerId does not have permission to create merchants