Endpoint: POST /uniconta/admin/managed-accounts/{managed_accounts_pk}/virtual-accounts/
Acesso restrito (apenas superusuário) — e a operação não é implementada. Qualquer POST para esta URL retorna 405 Method Not Allowed.
Contas virtuais não são criadas sob demanda. Elas são provisionadas automaticamente na primeira chamada do endpoint de detalhe pelo escopo do vendedor:
GET /uniconta/seller/{sub_account_id}/virtualaccounts/{sub_account_id}/
Nesse momento, o auto-provisionamento executa duas etapas:
- Verifica se a conta unificada é uma sub-conta.
- Localiza a conta gerenciada do pai (se existir) e a vincula automaticamente à nova conta virtual.
Portanto, uma conta virtual fica sob uma conta gerenciada por associação ao pai da conta unificada, e não por uma chamada direta de criação administrativa.
Como vincular uma conta virtual existente a uma conta gerenciada
Também não existe endpoint REST para isso. O vínculo é definido durante o auto-provisionamento (acima) ou por um operador com acesso direto ao banco. Se a conta unificada pai não tinha uma conta gerenciada no momento do provisionamento, você pode:
- Definir a conta gerenciada do pai no painel administrativo interno.
- Acionar novamente o fluxo de detalhe — a chamada preenche
managed_account da conta virtual se ainda estiver nula e agora houver uma disponível.
Erros
| Status | Quando |
|---|
401 | Token ausente ou inválido. |
403 | O usuário não é superusuário. |
405 | Foi enviado um POST — endpoint não implementado. |
Exemplo de resposta
POST /uniconta/admin/managed-accounts/1/virtual-accounts/ HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJh...
HTTP/1.1 405 Method Not Allowed
Allow: GET, HEAD, OPTIONS