Endpoint: GET /unified/accounts/sellers/{sellers_pk}/point-of-sale/
Autenticação: JWT obrigatório ou Chave de API aceita
Um Ponto de Venda é um terminal físico (ou registro de máquina virtual) provisionado junto à infraestrutura de processamento e vinculado a um seller. Cada POS captura vendas presenciais e as expõe como transações unificadas. A ordenação é por last_tx_at decrescente, de modo que os terminais usados mais recentemente aparecem primeiro.

​
Parâmetros de path

​
sellers_pk
string (uuid)
required
Identificador da conta unificada. Terminais em que esta conta é a acquirer_account (ou uma conta relacionada, para não-superusuários) são listados.

​
Parâmetros de query

​
search
string
Busca por substring (case-insensitive) em serial_number, manufacturer, terminal_model, status e zoop_id.
​
status
string
Correspondência exata ao status do terminal.
​
acquirer_account
string (uuid)
Filtra por uma conta específica (ex.: uma sub-conta quando sellers_pk é a conta pai).

​
Resposta

Retorna um array de registros de POS.
​
id
string (uuid)
​
acquirer_account
object | null
Projeção {id, display_name, type} da conta na qual o terminal está provisionado.
​
receiver_account
object | null
Projeção {id, display_name, type} da conta que recebe as vendas capturadas pelo terminal (frequentemente igual a acquirer_account, mas pode diferir em frotas distribuídas).
​
serial_number
string | null
​
manufacturer
string | null
​
terminal_model
string | null
​
status
string | null
​
last_tx_at
string | null
Timestamp ISO 8601 da transação mais recente capturada.
​
created_at
string
​
updated_at
string
​
zoop_id
string | null
Identificador histórico na infraestrutura de processamento.
​
zoop_acquirer_status
string
Estado reportado pela infraestrutura de processamento.
​
zoop_last_updated
string | null
Última atualização do registro na infraestrutura de processamento.
[
  {
    "id": "21c8e9a3-1b40-4f3e-9c11-c2c0a1b3e711",
    "acquirer_account": { "id": "9b1f0d2a-...", "display_name": "ACME Comércio LTDA", "type": "SELLER_PJ" },
    "receiver_account": { "id": "9b1f0d2a-...", "display_name": "ACME Comércio LTDA", "type": "SELLER_PJ" },
    "serial_number": "P2-7Z1-000123",
    "manufacturer": "Ingenico",
    "terminal_model": "Move 5000",
    "status": "active",
    "last_tx_at": "2025-05-13T18:11:00.000000Z",
    "created_at": "2025-02-10T14:03:21.000000Z",
    "updated_at": "2025-05-13T18:11:00.000000Z",
    "zoop_id": "pos_a1b2c3",
    "zoop_acquirer_status": "ACTIVE",
    "zoop_last_updated": "2025-05-13T18:11:30.000000Z"
  }
]

​
Erros

StatusQuando
401Token ausente ou inválido.
403Solicitante não tem acesso a sellers_pk.
404sellers_pk não existe.

​
Exemplos

curl https://api.dlpay.cloud/unified/accounts/sellers/9b1f0d2a-2b40-4f3e-9c11-c2c0a1b3e711/point-of-sale/ \
  -H "Authorization: Bearer $ACCESS_TOKEN"