Listar Vendedores e Terminais Vinculados

Lista os vendedores da company do intermediador, incluindo os serial numbers dos terminais POS vinculados a cada vendedor. Suporta filtros por identificador, documento e nome.

Listar Vendedores e Terminais Vinculados

get

Lista os vendedores da company do intermediador autenticado, incluindo os serial numbers dos terminais POS vinculados a cada um. Apenas a conta principal (payfac) da company pode acessar.

Authorizations

ApiKeyAuth

X-Token-ApistringRequired

Chave de API do intermediador (conta principal/payfac da company)

Query parameters

idintegerOptional

Filtra por identificador do vendedor

Example: 456

documentstringOptional

Filtra por documento (CPF/CNPJ) do vendedor

Example: 12345678000199

namestringOptional

Filtra por nome do vendedor

Example: acme

pageinteger · min: 1Optional

Página (1-based)

Default: 1

sizeinteger · min: 1 · max: 100Optional

Tamanho da página

Default: 100

Responses

200

Lista de vendedores com os terminais vinculados

application/json

Página de vendedores (paginação 1-based)

pageintegerOptional

Página atual (1-based)

Example: 1

sizeintegerOptional

Tamanho da página

Example: 100

totalElementsinteger · int64Optional

Total de vendedores encontrados

Example: 1

totalPagesintegerOptional

Total de páginas

Example: 1

400

Parâmetro inválido (ex.: page ou size fora do permitido)

application/json

403

Token não é da conta principal (payfac) da company (BAR-PP-09)

application/json

get/physical-payments/payfac/v1/sellers

HTTPcURLJavaScriptPython

GET /physical-payments/payfac/v1/sellers HTTP/1.1
Host: api.barte.com
X-Token-Api: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "id": 456,
      "document": "12345678000199",
      "name": "Loja Centro",
      "serialNumbers": [
        "1850123456",
        "1850777888"
      ]
    }
  ],
  "page": 1,
  "size": 100,
  "totalElements": 1,
  "totalPages": 1
}