Endpoint: GET /uniconta/seller/{account_id}/virtualaccounts/
Autenticação: obrigatória — JWT via Authorization: Bearer <access_token>. O usuário precisa ter acesso à account_id (vínculo de acesso legado) ou ser superusuário.
Uma conta virtual é uma sub-razão financeira que existe dentro da conta de um vendedor. Serve para segregar e acompanhar valores destinados a um propósito específico (uma campanha, um evento, uma sub-operação). O dinheiro entra e sai por meio de lançamentos; o saldo atual é a soma das entradas com status PAID menos as saídas com status PAID e WAITING_CONFIRMATION (sempre em centavos de BRL). Este endpoint retorna todas as contas virtuais cuja account corresponde ao account_id informado, ordenadas por created_at decrescente. A representação aqui é enxuta — o saldo não é incluído. Para inspecionar o saldo, utilize o endpoint de detalhe.

Pré-requisitos

  • A conta do vendedor (account_id) já deve existir na plataforma. As contas virtuais são provisionadas automaticamente para sub-contas na primeira chamada do endpoint de detalhe (veja a documentação correspondente).

Parâmetros de caminho

account_id
string (uuid)
required
Identificador unificado da conta do vendedor. É o mesmo id utilizado em toda a árvore /sellers/{sellers_pk}/....

Parâmetros de query

Paginação padrão (page, page_size). Não há filtros adicionais expostos.

Resposta

Lista paginada. Cada item expõe:
id
string (uuid)
Identificador da conta virtual. Para a conta virtual “principal” de uma sub-conta, esse id é igual ao id da própria sub-conta.
created_at
string (datetime)
Timestamp ISO 8601.
updated_at
string (datetime)
Timestamp ISO 8601.
{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "9c2a1f3e-7d8b-4a1c-9f2e-0b6a5d4c1e10",
      "created_at": "2026-04-12T14:01:33-03:00",
      "updated_at": "2026-04-12T14:01:33-03:00"
    },
    {
      "id": "1d3b8a2c-4e5f-4a91-8b22-77c91e0d9aaa",
      "created_at": "2026-03-30T09:18:02-03:00",
      "updated_at": "2026-03-30T09:18:02-03:00"
    }
  ]
}

Erros

StatusQuando
401Cabeçalho Authorization ausente ou inválido.
403O usuário não possui acesso à account_id.

Exemplos

curl https://api.dlpay.cloud/uniconta/seller/9c2a1f3e-7d8b-4a1c-9f2e-0b6a5d4c1e10/virtualaccounts/ \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJh..."