Buscar conta gerenciada (admin)

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

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:

string

boolean

array<string>

Lista de e-mails que receberão notificações quando uma das ações em notify_on_actions for solicitada.

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:

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

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

Exemplos

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

import requests

response = requests.patch(
    "https://api.dlpay.cloud/uniconta/admin/managed-accounts/1/",
    headers={"Authorization": "Bearer eyJ0eXAiOiJKV1QiLCJh..."},
    json={
        "automation_enabled": False,
        "notify_on_actions": ["BANK_SLIP", "TRANSFER"],
        "notify_actions_to": ["ops@dlpay.cloud", "risk@dlpay.cloud"],
    },
)

const res = await fetch(
  "https://api.dlpay.cloud/uniconta/admin/managed-accounts/1/export-report/",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer eyJ0eXAiOiJKV1QiLCJh...",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ statuses: ["PLANNED", "WAITING_CONFIRMATION"] }),
  }
);
const blob = await res.blob();

Início

Autenticação e usuários

Vendedores

Vendas

Planos

Contas unificadas

Eventos

Assinaturas

Contas virtuais

Integrações do vendedor

Buscar conta gerenciada (admin)

Parâmetros de caminho

Resposta

Atualizar (PATCH)

Ações de detalhe

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

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

Erros

Exemplos

​Parâmetros de caminho

​Resposta

​Atualizar (PATCH)

​Ações de detalhe

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

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

​Erros

​Exemplos

Parâmetros de caminho

Resposta

Atualizar (PATCH)

Ações de detalhe

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

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

Erros

Exemplos