Endpoint: DELETE /uniconta/seller/{account_id}/virtualaccounts/{id}/
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 DELETE neste recurso. Uma chamada DELETE para a URL de detalhe retorna 405 Method Not Allowed.
Contas virtuais são sub-razões financeiras duráveis, vinculadas a uma sub-conta unificada (sua chave primária equivale ao id da sub-conta quando provisionada automaticamente). Elas guardam o histórico completo de lançamentos, pagamentos e transferências relacionados. Excluí-las orfanaria ou destruiria esse histórico contábil — por isso a operação é intencionalmente bloqueada.

​
O que fazer no lugar

  • Parar de usar a conta — deixe-a com saldo zero e ignore. Nenhum novo lançamento será criado a menos que você chame um dos endpoints de ação (pay, transfer, deposit).
  • Esvaziar o saldo — emita uma transferência de saída (POST …/virtualaccounts/{id}/transfer/) para mover os fundos antes de aposentar a sub-conta correspondente.
  • Exclusão física dos dados — precisa ser feita por um operador com acesso direto ao banco de dados. Não há endpoint REST para isso, nem no escopo administrativo.

​
Erros

StatusQuando
405Qualquer DELETE enviado para esta URL.
403O usuário não tem acesso à account_id.

​
Exemplo de resposta

DELETE /uniconta/seller/9c2a.../virtualaccounts/9c2a.../ HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJh...

HTTP/1.1 405 Method Not Allowed
Allow: GET, HEAD, OPTIONS