Endpoint: GET /uniconta/admin/managed-accounts/{id}/
Acesso restrito (apenas superusuário).
Retorna a conta gerenciada. O mesmo recurso também expõe um PATCH para edição da metadata operacional e duas ações de detalhe administrativas (métricas e exportação de relatório).

​
Parâmetros de caminho

​
id
integer
required
Identificador da conta gerenciada.

​
Resposta

Mesmo formato do endpoint de listagem: 
{
  "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"
  }
}

​
Atualizar (PATCH)

PATCH /uniconta/admin/managed-accounts/{id}/
Campos editáveis:
​
name
string
​
automation_enabled
boolean
​
notify_actions_to
array<string>
Lista de e-mails que receberão notificações quando uma das ações em notify_on_actions for solicitada.
​
notify_on_actions
array<string>
Subconjunto de BANK_SLIP, TRANSFER.
type e a conta vinculada (account) não são editáveis por este endpoint.

​
Ações de detalhe

​
GET /uniconta/admin/managed-accounts/{id}/metrics/

Retorna contadores agregados no escopo desta conta gerenciada: 
{
  "transfers": { "PAID": 12, "WAITING_CONFIRMATION": 1 },
  "bank_slips": { "PAID": 5, "ERROR": 1 },
  "balance": 158400
}
  • transfers / bank_slips — contagem de transferências e pagamentos de boleto agrupada por status.
  • balance — SOMA(IN, PAID) − SOMA(OUT, PAID) − SOMA(OUT, WAITING_CONFIRMATION) sobre todos os lançamentos vinculados a esta conta gerenciada, em centavos de BRL.

​
POST /uniconta/admin/managed-accounts/{id}/export-report/

Gera um relatório no formato .xlsm a partir dos pagamentos de boleto e transferências TED desta conta gerenciada. Corpo:
​
statuses
array<string>
required
Lista não vazia entre: PLANNED, PAID, WAITING_CONFIRMATION, REVERSED, CANCELED, ERROR, UNKNOWN.
A resposta é um arquivo binário .xlsm (application/vnd.ms-excel.sheet.macroEnabled.12) com cabeçalho Content-Disposition: attachment. Duas planilhas são preenchidas:
  • Pagamentos Boletos e Tributos — uma linha por pagamento (código do boleto, valor em reais, data alvo, id).
  • Transferencias Dados da Conta — uma linha por transferência TED (banco, agência, conta, titular, CPF/CNPJ, valor em reais, data alvo, id).

​
Erros

StatusQuando
401Token ausente ou inválido.
403O usuário não é superusuário.
404A conta gerenciada não existe.

​
Exemplos

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