Endpoint: GET /uniconta/admin/managed-accounts/
Acesso restrito (apenas superusuário). Qualquer usuário não-superusuário recebe 403.
Uma conta gerenciada é o agrupador de alto nível que fica acima de um conjunto de contas virtuais. Conceitualmente representa uma relação bancária que a plataforma administra: todo vendedor cujo dinheiro flui por aquela infraestrutura é vinculado à conta gerenciada correspondente. O recurso carrega:
  • name — rótulo legível.
  • type — identificador interno do tipo (apenas para uso operacional).
  • automation_enabled — se a movimentação automática de saída está habilitada para as carteiras vinculadas.
  • notify_actions_to / notify_on_actions — lista de e-mails e ações utilizados pelo notificador.
  • account — vínculo com a conta unificada master/pai à qual a conta gerenciada pertence.
Cada conta gerenciada possui um conjunto de contas virtuais associadas. Para inspecioná-las, utilize o endpoint listar contas virtuais de uma conta gerenciada.

​
Parâmetros de query

​
search
string
Busca case-insensitive sobre name e sobre o display_name da conta unificada associada.
​
page
integer
​
page_size
integer

​
Resposta

​
id
integer
Identificador da conta gerenciada.
​
name
string | null
Rótulo legível.
​
type
string
Identificador interno do tipo.
​
automation_enabled
boolean
​
notify_actions_to
array<string>
Lista de e-mails que recebem notificações.
​
notify_on_actions
array<string>
Lista de ações monitoradas (BANK_SLIP, TRANSFER).
​
account
object | null
Conta unificada vinculada (somente exibição): id, display_name, etc.
{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": 1,
      "name": "Master Operacional",
      "type": "INTERNAL",
      "automation_enabled": true,
      "notify_actions_to": ["ops@dlpay.cloud"],
      "notify_on_actions": ["BANK_SLIP", "TRANSFER"],
      "account": {
        "id": "9c2a1f3e-7d8b-4a1c-9f2e-0b6a5d4c1e10",
        "display_name": "DL Pay Master"
      }
    }
  ]
}

​
Ações adicionais sobre a coleção

  • GET /uniconta/admin/managed-accounts/total-balance/ — retorna a soma dos saldos virtuais (em centavos) e o saldo bancário externo de referência. Soma todos os lançamentos (PAID IN menos PAID OUT menos WAITING_CONFIRMATION OUT) em todas as contas gerenciadas e compara com o saldo bancário em tempo real.

​
Erros

StatusQuando
401Token ausente ou inválido.
403O usuário autenticado não é superusuário.

​
Exemplos

curl https://api.dlpay.cloud/uniconta/admin/managed-accounts/ \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJh..."