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:
  1. Verifica se a conta unificada é uma sub-conta.
  2. 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

StatusQuando
401Token ausente ou inválido.
403O usuário não é superusuário.
405Foi 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