Merchant Updating Info

Description

Updating registered merchants via create_merchant.md.

💡 Info

Agent account is impossible update via this api.

HTTP Request

PUT /marketplace/{agentQwqerId}/merchant/{merchantQwqerId}

Path Parameters

Parameter	Type	Required	Description
agentQwqerId	string	Yes	Agent identifier issued during marketplace registration
merchantQwqerId	string	Yes	Merchant identifier issued during create_merchant.md

Request Body

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

Field	Type	Required	Description
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

{
  "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

✅ 202 Accepted — Updated

{
  "message": "Merchant updated successfully"
}

❌ 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"
}

{
  "message": "This merchant 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