Merchant Management

A merchant must exist before you can register terminals against it.

Register merchant — `POST /api/merchants`

Registers a new merchant in the system.

Request parameters

Parameter	Type	Required	Description
`merchantId`	string	Yes	Unique identifier for the merchant
`merchantName`	string	Yes	Display name of the merchant
`merchantSecret`	string	Yes	Secret key for merchant authentication
`enabled`	boolean	Yes	Whether the merchant is active
`role`	string	Yes	Merchant role (e.g. `MERCHANT`)

Request

{
  "merchantId": "merchant1",
  "merchantSecret": "pos123",
  "merchantName": "Merchant One",
  "enabled": "true",
  "role": "MERCHANT"
}

Response

{
  "merchantId": "merchant1",
  "merchantName": "Merchant One",
  "enabled": true,
  "role": "MERCHANT",
  "createdAt": null
}