Sign in

v1

latestOpenAPI 3.1.02026-07-24153164.0 KB
merchant-portal-api-controller

Register Additional Terminal for Existing Merchant

Registers an additional terminal for an existing merchant on the TECS Platform. The caller must supply the package order UUID (obtained from the initial merchant registration) and detailed terminal information including country code, language code, location, and serial number. Optional fields such as product ID, terminal ID from the acquirer, and user contact details can also be provided. If the merchant username or password are omitted, TECS will generate these credentials and return them in the response.

post/merchantportalws/registerAdditionalTerminal

Headers

Authorizationstring required

Authorization header containing a valid Bearer token or Basic authentication credentials. Example: "Bearer AT-2359-DFYpOWfDFSls4DeKDmGOXDyynx0a8Trwk"

Request body

additional_dataobject

Arbitrary merchant-specific data related to terminal registration. Provide any additional key-value pairs as required.

packageorderuuidstring required

Identifier of the registered merchant in the TECS system, provided in the response of the registerNewMerchant call.

passwordstring

Merchant password for MPOS. If not provided, TECS will generate a password and return it in the response.

productidstring

Identifier of the product for which terminal registration is to be performed. If omitted, a default product may be used.

terminal_country_codestring required

Terminal country code (must be in 'ISO-3166 ALPHA-3' format).

terminal_language_codestring required

Terminal language code (must be in 'ISO 639-1' format).

terminal_locationstring required

Physical or logical location of the terminal.

terminal_serial_numberstring required

Terminal serial number.

terminalid_acquirerstring

Terminal ID as set by the acquirer (optional).

user_emailstring email

Email address of the user acting on behalf of the merchant.

user_phone_numberstring

Phone number of the user acting on behalf of the merchant. Must be in international format (e.g., +421910711234).

usernamestring

Merchant username for MPOS. If not provided, TECS will generate a username and include it in the response.

web_shop_urlstring uri

URL of the merchant's web shop.

Example request

{
  "additional_data": {
    "firstname": "John",
    "surname": "Doe",
    "type": "tx-300",
    "version": "v1.2.3"
  },
  "packageorderuuid": "dccb9a6a-b02c-46e3-aef3-a28f0b7bf993",
  "password": "testpassword",
  "productid": "d8af7e4f-a04f-42ea-91ac-bed20c5eebfe",
  "terminal_country_code": "SVK",
  "terminal_language_code": "EN",
  "terminal_location": "Palisady 12 BA",
  "terminal_serial_number": "325-320-924",
  "terminalid_acquirer": "66000001",
  "user_email": "testemail@tecs.at",
  "user_phone_number": "+421910876567",
  "username": "testuser",
  "web_shop_url": "https://www.tecs.at"
}

Response

Successful registration of an additional terminal.