Listar contas virtuais do vendedor

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

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:

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.

string (datetime)

Timestamp ISO 8601.

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

Status	Quando
`401`	Cabeçalho `Authorization` ausente ou inválido.
`403`	O 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..."

import requests

response = requests.get(
    "https://api.dlpay.cloud/uniconta/seller/9c2a1f3e-7d8b-4a1c-9f2e-0b6a5d4c1e10/virtualaccounts/",
    headers={"Authorization": "Bearer eyJ0eXAiOiJKV1QiLCJh..."},
)
data = response.json()

const response = await fetch(
  "https://api.dlpay.cloud/uniconta/seller/9c2a1f3e-7d8b-4a1c-9f2e-0b6a5d4c1e10/virtualaccounts/",
  { headers: { Authorization: "Bearer eyJ0eXAiOiJKV1QiLCJh..." } }
);
const data = await response.json();

Início

Autenticação e usuários

Vendedores

Vendas

Planos

Contas unificadas

Eventos

Assinaturas

Contas virtuais

Integrações do vendedor

Listar contas virtuais do vendedor

Pré-requisitos

Parâmetros de caminho

Parâmetros de query

Resposta

Erros

Exemplos

​Pré-requisitos

​Parâmetros de caminho

​Parâmetros de query

​Resposta

​Erros

​Exemplos

Pré-requisitos

Parâmetros de caminho

Parâmetros de query

Resposta

Erros

Exemplos