Endpoint: POST /uniconta/seller/{account_id}/virtualaccounts/
Autenticação: obrigatória — JWT via Authorization: Bearer <access_token>. O usuário precisa ter acesso à account_id ou ser superusuário.
Não existe um POST direto nesta coleção. A chamada retorna 405 Method Not Allowed. As contas virtuais são criadas automaticamente pelo fluxo de auto-provisionamento descrito abaixo.
Uma conta virtual não é um recurso criado pelo usuário. Ela é a sub-razão financeira que dá suporte a uma sub-conta, e é provisionada automaticamente na primeira vez em que é consultada.

​
Como provisionar uma conta virtual

Faça uma chamada ao endpoint de detalhe com pk igual ao id da sub-conta: 
GET /uniconta/seller/{sub_account_id}/virtualaccounts/{sub_account_id}/
Quando o endpoint detecta que account_id == pk, ele aciona a rotina de auto-provisionamento. O processo:
  1. Verifica se a conta é uma sub-conta. Caso contrário, retorna erro de validação.
  2. Localiza a conta gerenciada do pai (se existir) e a vincula automaticamente.
  3. Cria a conta virtual com o id igual ao id da sub-conta. A operação é idempotente — chamadas subsequentes retornam o registro existente e só preenchem o vínculo de conta gerenciada caso ainda esteja ausente.
Após o provisionamento, a mesma chamada de detalhe passa a retornar os dados completos da conta virtual (incluindo o balance atual).

​
Pré-requisitos

  • A conta do vendedor existe e é uma sub-conta (possui um pai).
  • O usuário tem acesso à sub-conta (vínculo de acesso legado) ou é superusuário.

​
Erros

StatusQuando
405Foi enviado um POST para esta URL. Utilize o fluxo de detalhe descrito acima.
400A conta não é uma sub-conta.
403O usuário não tem acesso à account_id.

​
Exemplo: disparar o provisionamento

curl https://api.dlpay.cloud/uniconta/seller/9c2a1f3e-7d8b-4a1c-9f2e-0b6a5d4c1e10/virtualaccounts/9c2a1f3e-7d8b-4a1c-9f2e-0b6a5d4c1e10/ \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJh..."