O que preparar

Para: Adm — Conferido em 2026-10-19.

Reúna estes itens antes de pedir o tenant. Quase todos atrasam o go-live se chegarem depois: o convite precisa de um e-mail real, os pedidos do painel precisam de uma segunda pessoa e o webhook precisa de um domínio que o Dracma aceite.

O que é

Uma lista de dados que você entrega ao Dracma e de decisões que você toma antes do primeiro acesso.

Dados da empresa (KYB)

Entregue ao Dracma pelo canal combinado no contrato:

  • razão social e documento fiscal (CNPJ);
  • sócios e beneficiários finais;
  • licença ou autorização para operar no país;
  • contato comercial e contato técnico.

Dados da integração

Item Para que serve Observação
E-mail do administrador do tenant recebe o convite e vira dono tem de ser um e-mail real e monitorado de uma pessoa. Não use caixa compartilhada nem endereço de teste
Nome das operações marca-país-ambiente, por exemplo marca-a-br-hml só letras minúsculas, dígitos e hífen; 2 a 63 caracteres; começa com letra ou dígito
IPs ou CIDRs de saída do conector opcional e altamente recomendado (em Real, cadastre); sem IP a operação aceita qualquer origem rede no mínimo /24 (IPv4) e /56 (IPv6); nunca /0; até 50 itens. Com IP cadastrado, outra origem recebe 403 ip_not_allowed (veja Rede, allowlist e mTLS)
URL do webhook recebe os eventos de depósito e saque https, sem usuário e senha, host público. Em hml, o domínio precisa ser reservado ou liberado pelo Dracma
Domínio do conector de homologação liberação do webhook no hml peça no onboarding. Túneis temporários (ngrok e semelhantes) não funcionam
Contatos de alerta recebem e-mails de caixa baixo, webhook falhando e informação solicitada informe ao Dracma; o painel não edita esses contatos
Moedas e métodos hoje BRL com pix a operação nasce com BRL e PIX

Não disponível

O painel não permite cadastrar nem editar os contatos de alerta de e-mail da operação. Sem contatos, os alertas por e-mail e o aviso de "informação solicitada" não têm destinatário. Informe os e-mails ao Dracma no onboarding.

Quando usar

Antes do passo 2 da linha do tempo: o Dracma só cria o tenant quando tem o e-mail do administrador.

Como funciona

Pelo menos duas pessoas, com dois fatores

Várias ações do painel exigem a aprovação de outra pessoa: segunda chave de API, IP novo, mudança de URL do webhook, conceder um papel que aprova dinheiro, afrouxar uma regra, exportar dados pessoais. Quem pede nunca vota no próprio pedido. Com uma única pessoa, esses pedidos ficam parados.

Por isso:

  1. Tenha pelo menos duas pessoas com acesso ao painel já no go-live, com o convite aceito. Elas podem acumular papéis: quem administra o tenant também pode ser Financeiro (veja Equipe e papéis).
  2. Cada pessoa precisa de pelo menos dois fatores de login e de um fator forte (passkey ou app autenticador) para aprovar, votar, revelar segredos e dados pessoais.
  3. Cada pessoa usa um e-mail próprio. O e-mail identifica a conta, mas o identificador interno do usuário é um UUID que nunca muda.

O primeiro administrador pode convidar o segundo sem aprovação (enquanto há um só administrador, o pedido dele vale na hora). Mas o convite não conta como pessoa da equipe: a segunda pessoa só existe para as aprovações depois de aceitar o convite (link de uso único, 72 horas, com dois fatores). Convide cedo e confira em Usuários e papéis que o convite saiu de "Aguardando aceite". A partir do aceite, convidar para um papel que aprova dinheiro (Financeiro, Revisor) sempre pede a aprovação do outro administrador. Veja Equipe e papéis.

Fuso da operação

Cada operação tem um fuso, que define o "dia" das janelas de limite dos saques e o horário do saque automático. Uma operação criada pelo painel nasce com America/Sao_Paulo. O painel não altera o fuso depois. Se a sua operação precisa de outro fuso, peça ao Dracma antes de criar a operação.

O relatório de reconciliação usa sempre o dia em UTC, independentemente do fuso da operação. Veja Dia, fuso e horários.

Webhook e domínio

  1. Decida o endereço do receptor em produção (https) e o de homologação.
  2. Para o de homologação, peça no onboarding a liberação do domínio do seu conector.
  3. Tenha o receptor pronto para deduplicar por Dracma-Event-Id e conferir tudo por fetch-back. Veja Receptor passo a passo.

Exemplos

Formulário preenchido para o Dracma (todos os valores são fictícios):

Campo Valor
Administrador ana.admin@empresa-exemplo.example (pessoa real, e-mail real em produção)
Segunda pessoa bruno.fin@empresa-exemplo.example
Operações marca-a-br-hml, marca-a-br-prd
IPs de saída 203.0.113.0/24
Webhook hml https://pagamentos-hml.marca-a.example/dracma
Webhook prd https://pagamentos.marca-a.example/dracma
Contatos de alerta pagamentos@empresa-exemplo.example

Erros e casos de borda

  • IP inválido ou mais de 50 itens: o formulário recusa com "IP inválido". Informe 203.0.113.10 (vira /32) ou uma rede de no mínimo /24.
  • Rede grande demais: /16 é recusada. A regra é de "rede mínima": o prefixo precisa ser /24 ou mais longo em IPv4.
  • Webhook em http://: recusado em operação Real.
  • Webhook em domínio de terceiro no hml: a URL é recusada. Peça a liberação do domínio.
  • Só uma pessoa na equipe: o go-live não fecha. Convide a segunda pessoa antes.

Veja também