# Dracma para desenvolvedores — guia de integração > O Dracma é um gateway de pagamento multi-tenant: o conector de um operador chama a API v1 do Dracma para cobrar depósitos e pagar saques PIX em BRL, com chamadas assinadas por HMAC-SHA256, `Idempotency-Key = external_id` em todo POST de dinheiro, webhooks assinados que só avisam (o dinheiro se move depois do fetch-back `GET /deposits/{id}` ou `GET /withdrawals/{id}`), recuperação de eventos por `GET /events` a cada 5 minutos e reconciliação diária com digest assinado. Este guia segue o Contrato de integração v1 1.1.0 e foi conferido contra o código do Dracma em 2026-10-18; as diferenças estão em developers/referencia/divergencias.md. Cada operação é do tipo Teste (sem dinheiro real) ou Real (dinheiro real em qualquer instância). Todo o conteúdo concatenado num só arquivo: [llms-full.txt](llms-full.txt). Instruções para agentes de código: [AGENTS.md](AGENTS.md). Este índice é publicado só em `developers./llms.txt`; os links de `https://docs.…` levam à documentação do painel. ## Comece aqui - [Início do portal](https://developers.dracma.cfd/): o que é, por onde começar e o que está disponível hoje. A documentação do painel (para quem opera o dia a dia) está em [docs](https://docs.dracma.cfd/). - [Referência rápida](https://developers.dracma.cfd/referencia-rapida/): regras MUST/NEVER do integrador (R01 a R36), endpoints, erros, estados e eventos. - [Glossário](https://docs.dracma.cfd/conceitos/glossario/): termos de contas, API, dinheiro e webhooks. ## Conceitos e onboarding - [Visão geral](https://docs.dracma.cfd/conceitos/visao-geral/): tenant, operação, conector, jogador e PSP; fluxo ponta a ponta. - [Ambientes, tipos de operação e hosts](https://developers.dracma.cfd/conceitos/ambientes-e-hosts/): hml e prd, operação Teste e Real, qual host e qual chave. - [Convenções HTTP](https://developers.dracma.cfd/conceitos/convencoes-http/): `Money`, datas, IDs, timeouts, limites de corpo. - [Do zero ao go-live](https://docs.dracma.cfd/onboarding/): linha do tempo e quem faz o quê. - [O que preparar](https://docs.dracma.cfd/onboarding/pre-requisitos/): dados, pessoas, fuso, domínio do webhook. - [Primeiro depósito e primeiro saque](https://developers.dracma.cfd/onboarding/quickstart-sandbox/): comandos copiáveis no sandbox. - [De Teste para Real](https://docs.dracma.cfd/onboarding/promocao-para-producao/): pedido de operação Real e primeira transação. ## API: fundamentos - [Autenticação HMAC](https://developers.dracma.cfd/api/autenticacao/): pedido canônico, nonce, janela de 300 s, ordem de verificação, escopos. - [Erros](https://developers.dracma.cfd/api/erros/): `problem+json`, catálogo de `code`, motivos de validação, modo degradado. - [Idempotência e repetição](https://developers.dracma.cfd/api/idempotencia/): `Idempotency-Key`, `external_id`, recuperar um POST perdido, backoff. - [Paginação e filtros](https://developers.dracma.cfd/api/paginacao/) e [Limites e quotas](https://developers.dracma.cfd/api/limites/). ## Referência de endpoints - [Índice de endpoints](https://developers.dracma.cfd/referencia/): as 31 rotas, escopo e `operationId`. - [Ping e moedas](https://developers.dracma.cfd/referencia/ping-e-moedas/), [Depósitos](https://developers.dracma.cfd/referencia/depositos/), [Saques](https://developers.dracma.cfd/referencia/saques/), [Limites do jogador e saldos](https://developers.dracma.cfd/referencia/jogadores-e-saldos/), [Regras](https://developers.dracma.cfd/referencia/regras/), [Reconciliação](https://developers.dracma.cfd/referencia/reconciliacao/). - [Rotas e campos reservados](https://developers.dracma.cfd/referencia/superficies-reservadas/), [Objetos e campos](https://developers.dracma.cfd/referencia/schemas/). - [OpenAPI](https://developers.dracma.cfd/referencia/openapi/) e [openapi.yaml](https://developers.dracma.cfd/referencia/openapi.yaml): o documento que a API serve. - [Divergências conhecidas](https://developers.dracma.cfd/referencia/divergencias/): onde o código atual difere do contrato. ## Dinheiro e conector - [Modelo de dinheiro](https://docs.dracma.cfd/dinheiro/), [Dia, fuso e horários](https://docs.dracma.cfd/dinheiro/fuso-dia-e-horarios/), [Saldos e caixa livre](https://docs.dracma.cfd/dinheiro/saldos/). - [Ciclo do depósito](https://docs.dracma.cfd/dinheiro/ciclo-do-deposito/) e [Ciclo do saque](https://docs.dracma.cfd/dinheiro/ciclo-do-saque/): estados e efeito no livro. - [Decisão, limites e regras](https://docs.dracma.cfd/dinheiro/decisao-limites-e-regras/), [PSPs](https://docs.dracma.cfd/dinheiro/psps-e-ambientes/), [Tarifas](https://docs.dracma.cfd/dinheiro/tarifas/). - [Cripto](https://docs.dracma.cfd/metodos/cripto/): ativos, redes, confirmações e como habilitar. - [Devoluções, estornos e disputas](https://docs.dracma.cfd/dinheiro/devolucoes-estornos-e-disputas/), [Reconciliar com o seu livro](https://developers.dracma.cfd/dinheiro/reconciliacao-do-operador/), [Runbook de dinheiro](https://docs.dracma.cfd/dinheiro/runbook/). - [Estados no seu produto](https://developers.dracma.cfd/conector/estados-no-produto/), [Política de exceções de dinheiro](https://developers.dracma.cfd/conector/politica-de-excecoes/), [Arquitetura do conector](https://developers.dracma.cfd/conector/arquitetura/), [Alertas do conector](https://developers.dracma.cfd/conector/alertas-e-observabilidade/). ## Webhooks - [Visão geral](https://developers.dracma.cfd/webhooks/), [Seu endpoint](https://developers.dracma.cfd/webhooks/endpoint-e-politica-de-url/), [Requisição e assinatura](https://developers.dracma.cfd/webhooks/requisicao-e-assinatura/). - [Envelope](https://developers.dracma.cfd/webhooks/envelope/) e [Catálogo de eventos](https://developers.dracma.cfd/webhooks/catalogo-de-eventos/): os 17 tipos emitidos, com payload completo. - [Receptor passo a passo](https://developers.dracma.cfd/webhooks/receptor/): os 13 passos de verificação, fetch-back e deduplicação. - [Retentativas, skipped e DLQ](https://developers.dracma.cfd/webhooks/retentativas-e-dlq/), [`GET /events`](https://developers.dracma.cfd/webhooks/recuperacao-get-events/), [Segredo e rotação](https://developers.dracma.cfd/webhooks/segredos-e-rotacao/), [Problemas comuns](https://developers.dracma.cfd/webhooks/troubleshooting/). ## Painel do operador - [O painel](https://docs.dracma.cfd/painel/), [Conta, login e dispositivos](https://docs.dracma.cfd/painel/conta-e-login/), [Equipe e papéis](https://docs.dracma.cfd/painel/equipe-e-papeis/), [Tenants e operações](https://docs.dracma.cfd/painel/tenants-e-operacoes/). - [Chaves de API](https://docs.dracma.cfd/painel/chaves-de-api/), [IPs do conector](https://docs.dracma.cfd/painel/allowlist-de-ip/), [Webhooks no painel](https://docs.dracma.cfd/painel/webhooks/), [Gateways](https://docs.dracma.cfd/painel/gateways-e-psp/). - [Transações](https://docs.dracma.cfd/painel/transacoes/), [Cobrança de teste](https://docs.dracma.cfd/painel/cobranca-de-teste/), [Revisão](https://docs.dracma.cfd/painel/revisao-de-depositos-e-saques/), [Regras, listas e emergência](https://docs.dracma.cfd/painel/regras-e-listas/). - [Saldos e caixa](https://docs.dracma.cfd/painel/saldos-e-caixa/), [Reconciliação no painel](https://docs.dracma.cfd/painel/reconciliacao/), [Auditoria](https://docs.dracma.cfd/painel/auditoria/), [Relatórios](https://docs.dracma.cfd/painel/relatorios/), [Alertas e e-mails](https://docs.dracma.cfd/painel/alertas/), [Mensagens do painel](https://docs.dracma.cfd/painel/erros-do-painel/). ## Sandbox, segurança e go-live - [Sandbox](https://developers.dracma.cfd/sandbox/), [Receitas por caminho](https://developers.dracma.cfd/sandbox/receitas/), [Suíte de conformidade](https://developers.dracma.cfd/sandbox/conformidade/), [Dados de teste](https://developers.dracma.cfd/sandbox/dados-de-teste/). - [Rede, allowlist e mTLS](https://developers.dracma.cfd/seguranca/rede-allowlist-e-mtls/), [Segredos e vazamento](https://developers.dracma.cfd/seguranca/segredos-e-credenciais/), [Dados pessoais](https://docs.dracma.cfd/seguranca/dados-e-privacidade/). - [Checklist de go-live](https://developers.dracma.cfd/go-live/checklist/) e [Dia do corte e rollback](https://developers.dracma.cfd/go-live/dia-do-corte-e-rollback/). ## Versionamento e ajuda - [Versionamento](https://developers.dracma.cfd/versionamento/politica/) e [Changelog](https://developers.dracma.cfd/versionamento/changelog/). - [Ajuda](https://docs.dracma.cfd/ajuda/), [FAQ](https://docs.dracma.cfd/ajuda/faq/), [Problemas de integração](https://developers.dracma.cfd/ajuda/troubleshooting/), [Suporte](https://docs.dracma.cfd/ajuda/suporte/). ## Exemplos e casos - [Exemplos executáveis](https://developers.dracma.cfd/exemplos/): clientes Go, Node (TypeScript), PHP e shell, com testes nos vetores e nos helpers de repetição, paginação e `GET /events`. - [Vetores de assinatura](https://developers.dracma.cfd/exemplos/vetores-assinatura.json): vetores normativos de chamada e de webhook (segredos públicos de teste). - [Casos de operadores](https://developers.dracma.cfd/casos/), [Ficha do operador](https://developers.dracma.cfd/casos/ficha-do-operador/) e [um caso completo de casa de apostas](https://developers.dracma.cfd/casos/nero/): como um operador real aplicou o desenho.