Ajuda

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

Esta seção reúne o que fazer quando algo não funciona ou quando você tem uma dúvida pontual. Comece pelo sintoma: a página certa depende de onde o problema aparece.

O que é

Página Para quê
FAQ Respostas curtas, agrupadas por tema, com link para a página completa. Inclui o que acontece numa operação suspensa.
Problemas de integração Roteiro por sintoma para erros de chamada: 401, 403, 404, 409, 429, 503 e ambiente errado.
Suporte Como abrir um chamado e o que enviar.

Quando usar

Use o quadro abaixo para achar a página mais próxima do seu sintoma. Cada guia de problemas termina em "o que mandar ao suporte".

O que você vê Vá para
Uma chamada à API volta com erro Problemas de integração e o catálogo em Erros
401 com a assinatura que parece certa Passo zero: reproduza os vetores
O webhook não chega, chega duplicado ou fora de ordem Problemas comuns de webhook
O saldo, o caixa ou um estado não bate Runbook de dinheiro
Uma tela do painel mostra uma mensagem de erro Mensagens do painel
Dúvida sobre ambientes, chaves, IPs, mTLS ou primeiro acesso FAQ
Nada disso resolveu Suporte

Como funciona

Em qualquer problema, siga a mesma ordem:

  1. Guarde o Dracma-Trace-Id da resposta com erro, o external_id e o horário em UTC. Sem eles ninguém reconstrói o que aconteceu.
  2. Confirme o ambiente. Chame GET /v1/ping e veja environment. Uma chave de Teste num host de operação Real devolve 401 unknown_key (Ambientes, tipos de operação e hosts).
  3. Elimine a causa local. Reproduza os vetores de assinatura e confira o relógio por NTP.
  4. Procure o sintoma na página da tabela acima.
  5. Abra um chamado só depois, com os dados do passo 1 (Suporte).

Exemplos

Um 503 em laço num saque: o roteiro de 503 manda repetir com a mesma Idempotency-Key e respeitar o Retry-After. Se persistir, o chamado leva o trace_id da última resposta e o external_id do saque.

Erros e casos de borda

  • Nunca envie o segredo da chave, o segredo de webhook nem documento de jogador em um chamado.
  • Se um segredo vazou, não espere resposta: revogue e troque a chave você mesmo (Segredos e vazamento) e avise o suporte em seguida.

Veja também