Desvincular Terminais

Desassocia terminais do vendedor atual, mantendo o vínculo com o intermediador (inverso do vínculo): um terminal ACTIVE volta ao status LINKED, sem vendedor.

Operação em lote (bulk): informe de 1 a 30 serial numbers em uma única requisição. Cada terminal é processado de forma independente e a resposta é sempre 200, no mesmo padrão do vínculo, com o resultado por terminal em duas listas:

• success — serial numbers desvinculados com sucesso.
• errors — serial numbers que falharam, cada um com code e message.

Desvincular Terminais

post

Desassocia terminais do vendedor atual, mantendo o vínculo com o intermediador (inverso do configure): um terminal ACTIVE volta a LINKED (sem vendedor). Operação em lote (bulk): cada serial é processado de forma independente e a resposta é sempre 200 com o resultado por terminal, no mesmo padrão do configure (success / errors). Serials são normalizados para maiúsculas e deduplicados.

Apenas a conta principal (payfac) da company pode chamar (senão 403 / BAR-PP-09).

Códigos possíveis em errors:

Código	Significado
BAR-PP-11	Terminal não encontrado na company
BAR-PP-14	Terminal já desvinculado / não está ACTIVE
BAR-PP-20	Falha de comunicação com o provedor ao desassociar

Authorizations

ApiKeyAuth

X-Token-ApistringRequired

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

Body

application/json

serialNumbersstring[] · min: 1 · max: 30Required

Serial numbers dos terminais a desvincular (1 a 30 itens; normalizados para maiúsculas e deduplicados)

Example: ["1850123456","1850777888"]

Responses

200

Resultado por terminal (success / errors). Consulte a descrição do endpoint para a lista completa de códigos possíveis em errors.

application/json

Resultado por terminal das operações em lote (bulk) de vínculo e desvínculo. A requisição retorna 200 mesmo quando parte (ou todos) os terminais falham — as falhas vêm por item em errors.

successstring[]Optional

Serial numbers processados com sucesso

Example: ["1850123456"]

400

Corpo inválido (ex.: serialNumbers vazio ou acima de 30 itens)

application/json

403

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

application/json

post/physical-payments/payfac/v1/terminals/unconfigure

HTTPcURLJavaScriptPython

POST /physical-payments/payfac/v1/terminals/unconfigure HTTP/1.1
Host: api.barte.com
X-Token-Api: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 57

{
  "serialNumbers": [
    "1850123456",
    "1850777888",
    "UNKNOWN01"
  ]
}

{
  "success": [
    "1850123456"
  ],
  "errors": [
    {
      "serialNumber": "1850777888",
      "code": "BAR-PP-14",
      "message": "Terminal 1850777888 já está desvinculado."
    },
    {
      "serialNumber": "UNKNOWN01",
      "code": "BAR-PP-11",
      "message": "Terminal UNKNOWN01 não encontrado. Verifique se o serial number está correto."
    }
  ]
}