Listar pontos de venda

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

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

string

Busca por substring (case-insensitive) em serial_number, manufacturer, terminal_model, status e zoop_id.

string

Correspondência exata ao status do terminal.

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.

string (uuid)

object | null

Projeção {id, display_name, type} da conta na qual o terminal está provisionado.

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).

string | null

Timestamp ISO 8601 da transação mais recente capturada.

string

string | null

Identificador histórico na infraestrutura de processamento.

string

Estado reportado pela infraestrutura de processamento.

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

Status	Quando
`401`	Token ausente ou inválido.
`403`	Solicitante não tem acesso a `sellers_pk`.
`404`	`sellers_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"

import requests

response = requests.get(
    f"https://api.dlpay.cloud/unified/accounts/sellers/{seller_id}/point-of-sale/",
    headers={"Authorization": f"Bearer {access_token}"},
)
pos_devices = response.json()

const response = await fetch(
  `https://api.dlpay.cloud/unified/accounts/sellers/${sellerId}/point-of-sale/`,
  { headers: { Authorization: `Bearer ${accessToken}` } },
);
const posDevices = await response.json();

Início

Autenticação e usuários

Vendedores

Vendas

Planos

Contas unificadas

Eventos

Assinaturas

Contas virtuais

Integrações do vendedor

Listar pontos de venda

Parâmetros de path

Parâmetros de query

Resposta

Erros

Exemplos

​Parâmetros de path

​Parâmetros de query

​Resposta

​Erros

​Exemplos

Parâmetros de path

Parâmetros de query

Resposta

Erros

Exemplos