---
title: "Retrieve host processor configuration"
method: GET
path: "/processing-terminals/{processingTerminalId}/host-configurations"
tags: ["processingTerminals"]
---

# Retrieve host processor configuration

`GET /processing-terminals/{processingTerminalId}/host-configurations`

Use this method to retrieve the host processor configuration of a processing terminal. Integrate with this method only if you use your own gateway and want to validate the processor configuration.  

Our gateway returns the configuration settings for the merchant and the payment terminal.

## Path parameters

- `processingTerminalId` string, required

## Headers

- `Authorization` string, required

## Response `200`

Successful request. Returns the host configuration of the processing terminal.

- HostConfiguration — Object that contains the terminal's host configuration.
  - `processingTerminalId` string, required — Unique identifier that our gateway assigned to the terminal.
  - `processingAccountId` string — Unique identifier that we assigned to the processing account.
  - `configuration` HostConfigurationConfiguration, required — tsys variant
    - `processor` 'tsys', required — Discriminator value: tsys
    - `merchant` HostConfigurationConfigurationDiscriminatorMappingTsysMerchant, required — Object that contains the configuration settings for the merchant.
      - `posMid` string, required — Unique identifier that the host processor assigned to the merchant.
      - `chainNumber` string, required — Number that represents the merchant's chain of locations or stores.
      - `settlementAgent` string — Unique identifier of the merchant's settlement agent.
      - `abaNumber` string — Number that identifies the merchant in direct debit requests.
      - `binNumber` string, required — Unique identifier of the merchant's bank.
      - `agentBankNumber` string — Number of the merchant's bank if it processes transactions on behalf of another entity.
      - `reimbursementAttribute` string — Indicates if the merchant can accept interlink debit cards.
      - `locationNumber` string — Location of the merchant's information.
    - `terminal` HostConfigurationConfigurationDiscriminatorMappingTsysTerminal, required — Object that contains the configuration settings for the terminal.
      - `terminalId` string, required — Unique identifier that the host processor assigned to the terminal.
      - `terminalNumber` string, required — Unique identifier of the terminal at the merchant's site.
      - `authenticationCode` string — Authenticates the terminal's identity with the host processor.
      - `sharingGroups` string — Indicates the direct debit networks and EBT networks that the terminal can use.
      - `motoAllowed` boolean — Indicates if the terminal can run Mail Order/Telephone Order (MOTO) transactions.
      - `internetAllowed` boolean — Indicates if the terminal can run e-Commerce transactions.
      - `cardPresentAllowed` boolean — Indicates if the terminal can run card present transactions.

## Other responses

- `400` — Invalid request
- `401` — Identity could not be verified
- `403` — Do not have permissions to perform this action
- `404` — Resource not found
- `406` — Not acceptable
- `500` — An error has occured

---

[API](https://skmtc.dev/payroc/apis/schema.md) · [All operations](https://skmtc.dev/payroc/apis/schema/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/payroc/schema/revisions/1d9d3e305945/schema)