Vincular Terminais a um Vendedor

Vincula um ou mais terminais (por serial number) a um vendedor da company do intermediador.

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, com o resultado por terminal em duas listas:

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

Sobrescrita automática de vínculo: um terminal já vinculado a outro vendedor da mesma company é automaticamente re-vinculado ao vendedor informado.

Vincular Terminais a um Vendedor

post

Vincula um ou mais terminais (por serial number) a um vendedor da company do intermediador autenticado. Operação em lote (bulk): cada serial é processado de forma independente e a resposta é sempre 200 com o resultado por terminal (success / errors).

Sobrescrita automática de vínculo: um terminal já vinculado a outro vendedor da mesma company é re-vinculado ao vendedor informado.

Apenas a conta principal (payfac) da company pode chamar (senão 403 / BAR-PP-09). Se sellerId não pertencer à company do token, a resposta é 200 com BAR-PP-10 para todos os serials.

Códigos possíveis em errors:

Código	Significado
BAR-PP-10	Terminal de outra company ou sellerId inválido
BAR-PP-11	Terminal não encontrado
BAR-PP-12	Status do terminal não permite a operação
BAR-PP-13	Terminal ainda não vinculado a nenhuma company
BAR-PP-16	Terminal associado a outro vendedor da mesma company
BAR-PP-18	Erro interno ao criar/recuperar o vendedor de pagamento físico
BAR-PP-19	Falha de comunicação com o provedor ao associar
BAR-PP-20	Falha de comunicação com o provedor ao desassociar do vendedor anterior
BAR-PP-21	Falha de conexão ao consultar o terminal

Authorizations

ApiKeyAuth

X-Token-ApistringRequired

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

Body

application/json

sellerIdintegerRequired

Identificador do vendedor que receberá os terminais

Example: 456

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

Serial numbers dos terminais a vincular (1 a 30 itens, sem itens em branco)

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.: sellerId ausente, serialNumbers vazio, acima de 30 itens ou com item em branco)

application/json

403

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

application/json

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

HTTPcURLJavaScriptPython

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

{
  "sellerId": 456,
  "serialNumbers": [
    "1850123456",
    "1850777888",
    "BADSERIAL"
  ]
}

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