Autenticação: obrigatória — JWT via
Authorization: Bearer <access_token>. O usuário precisa ter acesso à account_id ou ser superusuário.balance em tempo real (centavos de BRL), calculado como:
Auto-provisionamento
Seid == account_id, a chamada é interpretada como uma solicitação da conta virtual “principal” da sub-conta e dispara o provisionamento automático antes de serializar a resposta. Ou seja, um simples GET em …/virtualaccounts/{account_id}/ é suficiente para criar o registro caso ainda não exista, desde que a conta seja uma sub-conta.
Para qualquer outro id, o registro precisa existir previamente.
Parâmetros de caminho
Identificador unificado da conta do vendedor.
Identificador da conta virtual. Use
id == account_id para referenciar a conta virtual principal da sub-conta.Resposta
Identificador da conta virtual.
Saldo atual em centavos de BRL.
1000 significa R$ 10,00. Pode ser 0. Inclui entradas PAID menos saídas PAID e WAITING_CONFIRMATION.Timestamp ISO 8601.
Timestamp ISO 8601.
Erros
| Status | Quando |
|---|---|
401 | Cabeçalho Authorization ausente ou inválido. |
403 | O usuário não tem acesso à account_id. |
404 | A conta virtual não existe (e id != account_id, portanto não é auto-provisionada). |
400 | Auto-provisionamento solicitado para uma conta que não é sub-conta. |