Ficha do operador¶
Para: Adm — Conferido em 2026-10-18.
Um modelo de ficha para descrever uma operação em uma página: o perfil que você combina com o Dracma no onboarding e que o seu time consulta depois. Uma ficha por operação.
O que é¶
A ficha é um documento seu, versionado junto do conector. Ela não substitui o contrato: reúne, no mesmo lugar, o que está espalhado entre o painel, a API e o que foi combinado no onboarding. A coluna "Onde obter" diz de onde sai cada valor, para você preencher sem adivinhar.
Quando usar¶
- No onboarding, ao pedir a operação Teste e, de novo, ao pedir a operação Real.
- Quando algo muda: novo PSP, nova regra de saque, novo webhook, pessoa nova na equipe.
- No go-live, anexada ao registro, como prova de que o perfil combinado é o que está configurado (Checklist de go-live).
Como funciona¶
O modelo¶
Copie a tabela e preencha a coluna "Valor". Os valores abaixo são fictícios.
| Campo | Valor (exemplo) | Onde obter |
|---|---|---|
| Nome da operação | operador-br-teste |
Painel, seletor de operação (O painel) |
| Tipo | Teste (ou Real) | GET /v1/ping: environment sandbox é Teste; Real é production |
| Id da operação | 00000000-0000-0000-0000-000000000001 |
GET /v1/ping: operation_id |
| Host da API | Informado no onboarding | Ambientes, tipos de operação e hosts |
| Moeda e método | BRL, pix (depósito e saque) |
GET /v1/currencies (Ping e moedas) |
| Exigências de depósito | player.name |
GET /v1/currencies: deposit_requirements |
| PSP de depósito | Informado pelo Dracma | Onboarding. É escolhido por operação e não aparece na API (PSPs) |
| PSP de saque | Informado pelo Dracma | Onboarding |
| Multiplicador do saque automático (X×) | Ex.: 1 | GET /v1/rules (Regras) |
| Janela e horário do saque automático | Ex.: 24x7 | GET /v1/rules e Dia, fuso e horários |
| Fuso da operação | Ex.: America/Sao_Paulo | Onboarding |
| Primeiro saque do jogador | Vai para revisão? | decision.reasons com FIRST_WITHDRAWAL |
| Jogadores antigos | Contam ou não para o multiplicador? | Decisão sua; veja o parágrafo abaixo |
| Tarifas | Por contrato | Contrato com o Dracma (Tarifas) |
| Caixa inicial e alerta de caixa baixo | Valor e limiar | GET /v1/balances e Saldos e caixa livre |
| URL do webhook | https://pagamentos.operador.example/dracma/webhook |
Painel (Webhooks no painel) |
| Eventos assinados | Todos, ou lista | Painel |
| Contatos de alerta | Até 5 e-mails | Painel (Alertas e e-mails) |
| Chaves ativas e escopos | Até 2 ativas | Painel (Chaves de API) |
| Equipe e papéis | Quem aprova, quem revisa, quem vê | Equipe e papéis |
| Quem decide as exceções de dinheiro | Cargo e substituto | Política de exceções de dinheiro |
| Conector | Nome do serviço, repositório e responsável | Sua empresa |
| Jobs | Poller de eventos (5 min), reconciliação (hora), relógio | Arquitetura do conector |
Sobre jogadores antigos: o multiplicador conta só o que o Dracma liquidou. Quem já tinha depositado antes da operação existir não tem histórico no Dracma e, conforme as regras da operação, o primeiro saque pode ir para revisão (FIRST_WITHDRAWAL ou NO_SETTLED_DEPOSIT). Anote aqui a sua escolha (deixar assim, ou revisar manualmente os primeiros saques) para o time de suporte saber o que esperar.
Como manter a ficha¶
- Guarde a ficha no repositório do conector, em Markdown.
- Mude-a no mesmo pedido de mudança que altera a configuração.
- No go-live, compare a ficha com o painel e com
GET /v1/ruleseGET /v1/currencies: qualquer diferença é um bug de um dos dois lados.
Exemplos¶
Um preenchimento real, de uma casa de apostas, está no Caso Nero, seção "A Nero no Dracma".
Erros e casos de borda¶
- Campo que depende do Dracma e não aparece na API (PSP, tarifa, fuso): peça ao suporte e anote a data da resposta.
- Operação Teste e Real têm fichas diferentes: o PSP, os limites e a equipe podem não ser os mesmos.
- Não coloque segredo nem chave na ficha. Ela guarda onde estão, nunca o valor.