Endpoint: GET /uniconta/admin/managed-accounts/{managed_accounts_pk}/virtual-accounts/{id}/
Autenticação: JWT obrigatório (apenas superusuário).
Acesso restrito a superusuário. Qualquer chamador que não seja superusuário recebe 403.
Retorna uma conta virtual vinculada à conta gerenciada informada, com a mesma estrutura usada pelo endpoint de listagem, porém em formato de objeto único. Use este recurso quando precisar da visão administrativa de uma carteira — identidade completa da conta vinculada mais o saldo calculado em tempo real.

​
Pré-requisitos

  • A conta gerenciada existe.
  • A conta virtual existe e está vinculada à conta gerenciada informada (a referência interna precisa coincidir com managed_accounts_pk). Caso contrário, retorna 404.
  • O chamador é superusuário.

​
Parâmetros de rota

​
managed_accounts_pk
integer
required
Identificador da conta gerenciada.
​
id
string (uuid)
required
UUID da conta virtual.

​
Resposta

​
id
string (uuid)
UUID da conta virtual.
​
account
object
Conta unificada vinculada, com identidade pública (id, display_name, email, dados de pessoa/empresa).
​
balance
integer
Saldo atual em centavos de BRL. Retorna 0 quando não é possível calcular.
​
created_at
string (datetime)
​
updated_at
string (datetime)
{
  "id": "9c2a1f3e-7d8b-4a1c-9f2e-0b6a5d4c1e10",
  "account": {
    "id": "9c2a1f3e-7d8b-4a1c-9f2e-0b6a5d4c1e10",
    "display_name": "Ada Lovelace",
    "email": "ada@example.com"
  },
  "balance": 158400,
  "created_at": "2026-04-12T14:01:33-03:00",
  "updated_at": "2026-05-11T08:42:10-03:00"
}

​
Erros

StatusQuando
401Token ausente ou inválido.
403Chamador não é superusuário.
404Conta virtual não existe para esta conta gerenciada.

​
Exemplos

curl https://api.dlpay.cloud/uniconta/admin/managed-accounts/1/virtual-accounts/9c2a1f3e-7d8b-4a1c-9f2e-0b6a5d4c1e10/ \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJh..."