Sign in

v1

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

Register Additional Acquiring for Existing Merchant

Registers an acquirer for an existing merchant’s terminal(s) on the TECS Platform. The call requires the package order UUID (received from the initial merchant registration), the transaction currency (in ISO 4217 format), the acquirer product identifier, and the merchant’s contract number with the acquirer (vu_nummer). Optionally, you may provide a list of terminal IDs for which acquiring should be enabled. If no terminal IDs are supplied, acquiring will be activated for all terminals registered to the merchant.

post/merchantportalws/registerAdditionalAcquiring

Headers

Authorizationstring required

Authorization header containing valid credentials. Example: "Bearer AT-2359-DFYpOWfDFSls4DeKDmGOXDyynx0a8Trwk"

Request body

additional_dataobject

Optional additional merchant-specific data related to enabling acquiring. This may include custom key-value pairs that provide further context.

currencystring required

Transaction currency in ISO 4217 format.

packageorderuuidstring required

Unique identifier for the registered merchant in the TECS system. This value is provided by TECS during the initial merchant registration and must be used for subsequent terminal or acquirer registrations.

productid_acquirerstring required

Identifier of the product for which acquiring is to be enabled. If not provided, the default product as defined in the package may be used.

terminalIdsinteger[]

Optional list of terminal IDs for which acquiring should be activated. If omitted, acquiring will be enabled for all terminals associated with the merchant.

terminalid_acquirerstring

Optional terminal ID provided by the acquirer.

vu_nummerstring required

Merchant contract number with the acquirer.

Example request

{
  "additional_data": {
    "firstname": "John",
    "surname": "Doe",
    "type": "tx-300",
    "version": "v1.2.3"
  },
  "currency": "EUR",
  "packageorderuuid": "16acb5a4-e573-423c-a024-fae90ea45d70",
  "productid_acquirer": "874d84a8-a6f4-47fa-b594-944593fc394b",
  "terminalIds": [
    77000001,
    77000002,
    77000003
  ],
  "terminalid_acquirer": "66000001",
  "vu_nummer": "VU-20230501-00123"
}

Response

Successful registration of additional acquiring.