Do zero ao go-live¶
Para: Adm · Dev — Conferido em 2026-10-18.
Esta é a linha do tempo completa de um integrador: da aprovação comercial ao primeiro PIX real. Cada passo diz quem faz, onde e qual prova você guarda. Os detalhes de cada passo ficam nas páginas ligadas.
O que é¶
O onboarding junta três frentes que andam em paralelo:
- Comercial e conformidade (KYB): acontece fora do painel e do código. O Dracma recebe os dados da empresa e decide se abre o tenant. Não há formulário de KYB no painel.
- Acesso: o Dracma cria o tenant e convida o administrador da sua empresa por e-mail. Ele aceita, vira dono do tenant e convida o resto da equipe.
- Técnica: você cria uma operação Teste, recebe a chave, liga o webhook, roda o quickstart e a suíte de conformidade, reconcilia um dia, pede a operação Real e vai ao ar.
Só o staff do Dracma cria tenants. Não existe cadastro self-service de empresa. Quem cria o tenant (a pessoa do Dracma) vira administrador dele e pode convidar você como outro dono; o convite é opcional na criação e também pode sair depois.
A aprovação de uma operação Real é de uma pessoa do Dracma que não seja quem fez o pedido. O número de pessoas envolvidas na análise comercial não é uma regra do produto e não aparece aqui.
Quando usar¶
Leia primeiro esta página para ter o mapa. Depois siga a ordem: O que preparar, Primeiro depósito e primeiro saque, De Teste para Real e o checklist de go-live.
Como funciona¶
Linha do tempo¶
flowchart TD
K["1. KYB e contrato (fora do painel)"] --> T["2. Dracma cria o tenant e convida o administrador por e-mail"]
T --> A["3. Administrador aceita o convite e vira dono do tenant"]
A --> E["4. Dono convida a equipe: pelo menos 2 pessoas com 2 fatores"]
E --> O["5. Dono cria a operação Teste no hml e revela a chave"]
O --> W["6. Webhook: URL e primeiro segredo"]
W --> Q["7. Quickstart: primeiro depósito e primeiro saque"]
Q --> C["8. Suíte de conformidade verde"]
C --> R["9. Um dia reconciliado nos dois lados"]
R --> P["10. Pedido de operação Real"]
P --> V["11. Uma pessoa do Dracma aprova; chave key_live_ revelada uma vez"]
V --> G["12. Gateway ativo na operação Real (cadastro e ativação pelo Dracma)"]
G --> L["13. Limites conservadores e alertas"]
L --> F["14. Primeira transação real de valor mínimo"]
F --> X["15. Registro de go-live"]
Quem faz o quê¶
| # | Passo | Quem | Onde | Prova que você guarda |
|---|---|---|---|---|
| 1 | KYB e contrato | Dracma e sua empresa | fora do painel | contrato assinado |
| 2 | Criar o tenant e convidar o administrador | Dracma | painel (ação de plataforma) | e-mail de convite recebido |
| 3 | Aceitar o convite | administrador da sua empresa | página de convite em auth. |
acesso ao painel como dono |
| 4 | Convidar a equipe | dono | painel, "Usuários e papéis" | lista de acessos |
| 5 | Criar a operação Teste e revelar a chave | dono | painel, "Tenants e operações" | GET /v1/ping com environment: "sandbox" |
| 6 | Cadastrar a URL do webhook e girar o primeiro segredo | administrador | painel, "Webhooks" | evento entregue no seu receptor |
| 7 | Quickstart | dev | seu terminal | saídas dos comandos |
| 8 | Conformidade | dev | Suíte de conformidade | saída com todos os casos verdes e a data |
| 9 | Reconciliar um dia | fin e dev | GET /v1/reconciliation |
relatório comparado nos dois lados, sem divergência |
| 10 | Pedir a operação Real | dono | painel | pedido registrado |
| 11 | Aprovar o pedido | Dracma (outra pessoa) | painel | operação Real ativa e chave revelada |
| 12 | Cadastrar e ativar o gateway | Dracma | painel | conexão ativa na tela "Gateways" |
| 13 | Limites e alertas | fin e administrador | painel | regras ativas e alertas configurados |
| 14 | Primeira transação real | fin e dev | painel "Cobrança de teste" ou API | depósito e saque do POST à linha da reconciliação |
| 15 | Go-live | todos | Dia do corte e rollback | registro assinado |
Primeiro acesso: o administrador é convidado¶
- O staff do Dracma cria o tenant informando o e-mail do administrador da sua empresa. Nenhuma conta do Dracma vira dona do tenant.
- O administrador recebe um e-mail com um link de uso único, válido por 72 horas. O e-mail é real, inclusive no hml. Endereços dos domínios de teste (
test.dracma.cfd,.test,.invalid,.example) nunca recebem e-mail de verdade. - O link abre a página de convite em
auth.. A pessoa entra ou cria a conta com o mesmo e-mail do convite. A conta precisa de pelo menos 2 fatores, com um fator forte (passkey, ou senha mais app autenticador). Veja Conta, login e dispositivos. - Ao aceitar, a pessoa vira dona do tenant. Só a partir daí ela cria operações e chaves.
- O Dracma não guarda nem vê o link. Se o convite expirar, o staff reenvia (até 5 reenvios, com 60 s entre eles; cada reenvio invalida o link anterior).
Consequências para você:
- A primeira chave de uma operação Teste é revelada a quem criou a operação: a sua empresa, não o Dracma. O Dracma nunca recebe o segredo.
- Se o convite não chegar, confira a caixa de spam e peça o reenvio ao Dracma. Não existe "esqueci meu convite" no painel.
- Quem criou o seu tenant no Dracma consta como dono até o seu administrador aceitar o convite. Depois do aceite, essa pessoa pode sair do tenant (o painel não deixa o tenant sem dono). Depois que o tenant tem dono ativo da sua empresa, a equipe do Dracma que não é dona do tenant não cria operações Teste nele.
- Os convites seguintes, para a equipe, são feitos pelo seu administrador em Usuários e papéis e funcionam do mesmo jeito: e-mail com link de uso único, aceite com dois fatores e acesso só depois do aceite. Veja Equipe e papéis.
Janelas de tempo que você precisa planejar¶
| Ação | Espera |
|---|---|
| Aceitar o convite do dono | 72 h de validade do link |
| Segunda chave de API (ou nova) | aprovação de outra pessoa da sua equipe e 24 h de espera |
| Revelar o segredo de uma chave nova | até 24 h depois que a chave nasce, uma única vez |
| Incluir IP na lista do conector | aprovação de outra pessoa e 24 h de espera |
| Mudar URL ou eventos do webhook pelo painel | aprovação de outra pessoa e 24 h de espera |
| Pedido de operação Real | aprovação de uma pessoa do Dracma, sem espera adicional |
Por isso o go-live exige pelo menos duas pessoas na equipe: com uma só, nenhum pedido que precisa de aprovação fecha.
Exemplos¶
Um cronograma realista para quem prepara tudo antes:
| Dia | O que acontece |
|---|---|
| D0 | Contrato assinado. Dracma cria o tenant e envia o convite |
| D0 | Administrador aceita, convida uma segunda pessoa e cria a operação Teste. A chave aparece na hora |
| D1 | Webhook ligado, quickstart e conformidade rodando |
| D2 a D3 | Um dia de reconciliação (o relatório do dia só fecha em D+1, às 02:00 UTC) |
| D3 | Pedido de operação Real, aprovação e revelação da chave |
| D4 | Gateway ativo, limites, alertas e primeira transação real |
| D5 | Go-live |
Se você precisar de uma segunda chave ou de IP novo, some 24 h ao cronograma.
Erros e casos de borda¶
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Link de convite diz que expirou ou já foi usado | passou de 72 h, ou outra conta já o consumiu | peça reenvio ao Dracma |
| Convite recusado por e-mail diferente | a conta usada não tem o e-mail do convite verificado | entre com o e-mail do convite ou adicione-o à conta e confirme o código |
| Convite recusado por falta de fatores | a conta tem só o código por e-mail | cadastre uma passkey ou um app autenticador e repita |
| "Você ainda não tem acesso a nenhuma operação" no painel | o seu usuário não tem pacote em nenhuma operação | peça ao administrador do seu tenant |
| Operação aparece como "Configurando" | passos de provisionamento em andamento | aguarde; o painel conclui sozinho |
| Chave não aparece | a janela de 24 h para revelar venceu | peça outra chave; veja Chaves de API |