---
title: "Register Additional Acquiring for Existing Merchant"
method: POST
path: "/merchantportalws/registerAdditionalAcquiring"
tags: ["merchant-portal-pam-merchant-controller"]
---

# Register Additional Acquiring for Existing Merchant

`POST /merchantportalws/registerAdditionalAcquiring`

## Request

- Base URL: `//test.tecs.at` (relative, and the document’s source URL is not known)
- URL: `//test.tecs.at/merchantportalws/registerAdditionalAcquiring`
- Auth: none declared. Required headers: `Authorization`

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.

## Headers

- `Authorization` string, required

## Request body

- InputRegisterAdditionalAcquiring
  - `additional_data` object: Optional additional merchant-specific data related to enabling acquiring. This may include custom key-value pairs that provide further context.
  - `currency` string, required: Transaction currency in ISO 4217 format.
  - `packageorderuuid` string, 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_acquirer` string, 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.
  - `terminalIds` integer[]: 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_acquirer` string: Optional terminal ID provided by the acquirer.
  - `vu_nummer` string, required: Merchant contract number with the acquirer.

## Response `200`

Successful registration of additional acquiring.

- OutputRegisterAdditionalAcquiring
  - `responseCode` integer, required: Response code. For success state 0. For failure state lower than 0.
  - `responseMessage` string, required: Response message. For success state OK. For failure state description of the cause.

## Other responses

- `400`: Bad Request – Missing or invalid parameters.
- `401`: Unauthorized – Invalid authentication credentials provided.
- `403`: Forbidden – The caller does not have sufficient permissions.
- `500`: Internal Server Error – An unexpected error occurred on the server.

---

[API](https://skmtc.dev/bluefin-com/apis/merchant-portal-web-service-documentation.md) - [All operations](https://skmtc.dev/bluefin-com/apis/merchant-portal-web-service-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/bluefin-com/apis/merchant-portal-web-service-documentation/revisions/1d7ee5e85e1e?raw)