O painel¶

Para: Adm · Fin — Conferido em 2026-10-18.

O painel é a aplicação web em que a equipe do operador administra a própria integração com o Dracma: operações, chaves, webhooks, revisão de saques e depósitos, regras, caixa, reconciliação, auditoria, relatórios e alertas. Esta página mostra a estrutura comum a todas as telas e resume quais ações pedem aprovação, espera e confirmação de identidade. Cada tela tem a sua página neste guia.

O que é¶

O painel tem o endereço painel.<domínio> e o login fica em auth.<domínio>, uma aplicação separada (veja Conta, login e dispositivos e Ambientes, tipos de operação e hosts). Você não cria conta sozinho: o acesso nasce de um convite da equipe do Dracma (primeiro administrador) ou de um administrador do seu tenant (demais pessoas).

O painel não é uma API. Tudo o que ele mostra e faz é para pessoas. Quem integra o sistema do operador usa a API HMAC descrita em Autenticação HMAC.

Este guia responde à pergunta "existe um guia do painel do operador?": sim, são as páginas desta seção.

Área do menu	Tela	Página do guia
Início	Operações	esta página
Operação	Transações	Transações
Operação	Depósitos em revisão e Saques em revisão	Revisão
Operação	Saldos e caixa	Saldos e caixa
Operação	Cobrança de teste	Cobrança de teste
Regras	Regras e listas	Regras, listas e emergência
Integração	Chaves e IPs	Chaves de API e IPs do conector
Integração	Webhooks	Webhooks no painel
Plataforma	Tenants e operações	Tenants e operações
Plataforma	Gateways	Gateways (só leitura)
Plataforma	Reconciliação	Reconciliação no painel
Administração	Usuários e papéis	Equipe e papéis
Administração	Auditoria	Auditoria
Administração	Alertas	Alertas e e-mails
Administração	Relatórios	Relatórios

Alguns itens do menu existem só para a equipe do Dracma e não fazem parte deste guia.

Quando usar¶

Abra o painel para:

• decidir saques e depósitos que as regras mandaram para revisão;
• acompanhar saldo, caixa e divergências de reconciliação;
• criar operações, chaves, endereços de webhook e alertas;
• propor mudanças de regra e conferir a trilha de auditoria.

A tela Início mostra um cartão por operação a que você tem acesso. Cada cartão traz o nome, o tipo (produção ou sandbox), os saldos Disponível, A receber e A pagar e dois botões com o tamanho das filas: Saques em revisão e Depósitos em revisão. Os números são os do livro do Dracma; a definição de cada saldo está em Saldos e caixa livre.

Como funciona¶

Barra superior¶

1. Seletor de operação. Trocar a operação mantém a mesma tela. Ele lista só as operações a que você tem acesso. A última operação aberta fica lembrada no navegador, por cerca de 180 dias, para o painel abrir direto nela.
2. Selo de ambiente. Mostra em que instância você está:
   • PRD · produção, em destaque, na instância de produção;
   • HML · sandbox, na instância de homologação;
   • DEV · local, em desenvolvimento.
3. Selo de sessão. Mostra Sessão com fator forte ou Sessão básica. Ações sensíveis só passam com fator forte recente (veja abaixo).
4. Sair. Encerra a sessão no painel e no provedor de identidade.

O mesmo conceito aparece com dois nomes. Em Tenants e operações o tipo é Teste ou Real; no seletor, nos cartões do Início e na cobrança de teste ele aparece como sandbox ou produção. Teste é sandbox e Real é produção.

Isolamento entre operações¶

Cada operação é um espaço separado. O endereço de cada tela leva o identificador da operação (/<id-da-operação>/chaves, por exemplo), e abrir o endereço de uma operação a que você não tem acesso mostra "Não encontrado", sem confirmar que a operação existe. A permissão vale por operação: a mesma pessoa pode ser Financeiro numa operação e só Auditor em outra.

Confirmação de identidade (step-up)¶

Toda ação sensível exige fator forte recente: passkey ou aplicativo autenticador confirmados nos últimos 5 minutos. Se a confirmação venceu, o formulário mostra o link Confirmar identidade agora, que leva ao login do provedor e volta à mesma tela. Ações que só leem dados e algumas ações restritivas (cancelar um pedido, por exemplo) não pedem a confirmação.

Aprovação de outra pessoa (4-eyes) e espera (time-lock)¶

Mudanças que ampliam o risco viram um pedido. O pedido só vigora depois de aprovado por outra pessoa (nunca por quem propôs) e, em alguns casos, depois de uma espera de 24 h. Em qualquer pedido:

• quem propôs não vota no próprio pedido;
• um voto contra encerra o pedido como recusado;
• cancelar um pedido que ainda não vigorou é permitido (nos pedidos de operação Real, só quem propôs cancela);
• todo voto, proposta e cancelamento pede um motivo de 10 a 1000 caracteres e fica na Auditoria.

Por isso cada tenant precisa de pelo menos duas pessoas com dois fatores de autenticação: com uma só pessoa, nenhuma aprovação fecha. Veja Equipe e papéis.

Ação, aprovação, espera e confirmação¶

Ação	Quem faz	Aprovação de outra pessoa	Espera	Confirmação recente
Criar tenant	equipe do Dracma	não	não	sim
Criar operação Teste	dono do tenant ou equipe do Dracma	não	não	sim
Criar operação Real	dono do tenant ou equipe do Dracma (pede)	1 pessoa da equipe do Dracma	não	sim
Pedir chave nova	Administrador do tenant	1	24 h	sim
Revelar o segredo da chave	quem pediu a chave	não	uma vez, em até 24 h	sim
Revogar chave	Administrador do tenant	não	não	sim
Incluir IP	Administrador do tenant	1	24 h	sim
Remover IP	Administrador do tenant	não	não	sim
Mudar URL ou eventos do webhook	Administrador do tenant	1	24 h	sim
Rotacionar o segredo do webhook	Administrador do tenant	não	não (o segredo antigo vale mais 7 dias)	sim
Reentregar ou resolver a DLQ	Administrador do tenant	não	não	não
Alterar conexão de gateway	equipe do Dracma	1	não	sim
Gerar cobrança de teste ou simular pagamento	Administrador, Financeiro	não	não	sim
Decidir saque ou depósito	Financeiro, Revisor	um voto contra decide; a favor, 1 pessoa (2 se exigir aprovação dupla)	não	sim
Revelar dados pessoais (no detalhe da revisão)	Financeiro, Revisor	não	não	sim
Pedir informação ao operador	Financeiro, Revisor	não	não	não
Mudança de regra restritiva	propõe: Administrador, Financeiro; aprova: Financeiro	1	não	sim
Mudança de regra relaxante	idem	1	24 h por padrão	sim
Incluir entrada em lista	Financeiro	não	não	sim
Remover entrada de lista ou ativar VIP	Financeiro	1	sim	sim
Suspender o automático (emergência)	Administrador, Financeiro	confirmação de outra pessoa em até 24 h	não	sim
Definir limiar de caixa	Financeiro	não	não	sim
Resolver divergência de reconciliação	Financeiro	não	não	sim
Exportar auditoria assinada	Administrador, Financeiro, Auditor	não	não	sim
Exportar relatório mascarado	Administrador, Financeiro, Auditor	não	não	não
Exportar relatório com dados pessoais	Financeiro, Auditor	1	não	sim
Configurar alertas	Administrador, Financeiro	não	não	não

As ações de equipe (convidar, conceder e remover papéis) têm regras próprias: veja Equipe e papéis.

Idioma, fuso e acessibilidade¶

• O painel é todo em português do Brasil.
• Datas e horas aparecem no fuso America/Sao_Paulo. A Reconciliação no painel trabalha por dia UTC e avisa isso na tela. Os filtros de data da Auditoria também valem no horário de Brasília.
• Valores aparecem em reais (R$ 1.234,56); os arquivos exportados usam inteiros na menor unidade, como a API.
• O estado de cada item aparece sempre em texto, nunca só em cor; há um atalho Pular para o conteúdo no início de cada página.

Faixa "Saques em verificação"¶

Quando o Dracma põe os saques novos de uma operação em verificação, uma faixa aparece no alto de todas as telas dessa operação: os novos saques podem demorar mais que o normal para sair, e os depósitos seguem normalmente. A faixa não traz motivo nem detalhe; em caso de dúvida, acione o suporte informando o horário que a faixa mostra.

Exemplos¶

Rotina típica do Financeiro, no começo do dia:

1. Abra Início e veja se alguma operação mostra saques ou depósitos em revisão.
2. Entre em Saques em revisão, abra cada item e decida (veja Revisão).
3. Abra Saldos e caixa e confira o disponível projetado de cada moeda (veja Saldos e caixa).
4. Depois das 02:00 UTC, abra Reconciliação e confira o dia anterior (veja Reconciliação no painel).

Se você abrir uma tela que precisa de operação (por exemplo Chaves e IPs) sem escolher uma, o painel abre direto na última operação usada, ou na primeira da lista.

Erros e casos de borda¶

• "Você ainda não tem acesso a nenhuma operação. Peça ao administrador do seu tenant." Aparece no Início e nas telas de operação quando a sua conta existe, mas nenhum papel foi concedido. Peça a um Administrador do tenant que conceda um pacote (veja Equipe e papéis).
• "Não encontrado. O item não existe ou você não tem acesso a ele." O painel não distingue "não existe" de "sem permissão". Confira o seletor de operação e o seu papel.
• Itens do menu que levam a "Não encontrado". A maioria dos itens aparece no menu para todos, e cada tela confere o seu papel ao abrir. Tenants e operações só aparece para quem é dono de algum tenant ou para a equipe do Dracma.
• Sessão vencida. O painel leva ao login e volta para a tela em que você estava.
• "Atualizando a página…". A página foi aberta antes de uma atualização do painel; ela recarrega sozinha uma vez.
• "Algo deu errado". Falha inesperada. O botão Tentar de novo repete a tela. Se persistir, acione o suporte com o horário (UTC) e o que você estava fazendo.
• Falha ao entrar. A página de entrada mostra "O login foi cancelado ou recusado", "O pedido de login expirou" ou "Não foi possível concluir o login". Tente de novo a partir do botão Entrar.

A lista completa de mensagens está em Mensagens do painel.

Veja também¶

• Conta, login e dispositivos
• Equipe e papéis
• Tenants e operações
• Mensagens do painel
• Ambientes, tipos de operação e hosts
• Do zero ao go-live