Buscar conta virtual de uma conta gerenciada (admin)

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

integer

required

Identificador da conta gerenciada.

string (uuid)

required

UUID da conta virtual.

Resposta

string (uuid)

UUID da conta virtual.

object

Conta unificada vinculada, com identidade pública (id, display_name, email, dados de pessoa/empresa).

integer

Saldo atual em centavos de BRL. Retorna 0 quando não é possível calcular.

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

Status	Quando
`401`	Token ausente ou inválido.
`403`	Chamador não é superusuário.
`404`	Conta 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..."

import requests

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

const response = await fetch(
  "https://api.dlpay.cloud/uniconta/admin/managed-accounts/1/virtual-accounts/9c2a1f3e-7d8b-4a1c-9f2e-0b6a5d4c1e10/",
  { 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

Buscar conta virtual de uma conta gerenciada (admin)

Pré-requisitos

Parâmetros de rota

Resposta

Erros

Exemplos

​Pré-requisitos

​Parâmetros de rota

​Resposta

​Erros

​Exemplos

Pré-requisitos

Parâmetros de rota

Resposta

Erros

Exemplos