De Teste para Real

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

Uma operação Teste nunca vira Real. Você pede uma operação Real nova, recebe uma chave key_live_ nova e troca a configuração do conector. O código do conector é o mesmo. Esta página mostra o pedido, a revelação da chave, o gateway, o webhook, os limites e a primeira transação real.

O que é

A promoção é a troca de duas operações, cada uma com a própria chave, regra, saldo e webhook:

Operação Teste Operação Real
Onde hml (api.) prd (api. do domínio de produção) ou hml (api-live.)
Chave key_test_… key_live_…
PSP simulador PSP de verdade
Dinheiro nunca real
Rotas /v1/sandbox/* abertas 404
Webhook URL de homologação URL de produção, https

Dinheiro real

A operação Real move dinheiro real. Os testes do passo 14 pagam e sacam PIX de verdade, com valor mínimo.

O que muda no conector ao promover:

  1. $DRACMA_BASE_URL passa a apontar para o host da operação Real.
  2. O key id e o segredo passam a ser os key_live_.
  3. O segredo de webhook passa a ser o da operação Real (cada operação tem o seu).
  4. A URL do webhook passa a ser a de produção.
  5. A suíte de conformidade e os testes que chamam /v1/sandbox/* não rodam contra a operação Real: essas rotas respondem 404.

Quando usar

Depois que o checklist de go-live estiver cumprido na operação Teste: conformidade verde, receptor com fetch-back e deduplicação, um dia de reconciliação sem divergência. O Dracma pede esse registro antes de aprovar o pedido da operação Real.

Como funciona

1. Pedir a operação Real

O pedido é feito no painel, em "Tenants e operações", pelo dono do tenant (o administrador que aceitou o convite). Informe:

  • o tenant e o nome da operação (por exemplo marca-a-br-prd);
  • o ambiente Real;
  • os IPs ou CIDRs de saída do conector (o formulário pede pelo menos um);
  • a URL https do webhook de produção (opcional na criação, mas recomendada);
  • o motivo, de 10 a 1000 caracteres.

O pedido exige confirmação recente com fator forte. Ele fica pendente até uma pessoa do Dracma, que não seja você, aprovar.

sequenceDiagram participant D as Dono do tenant (você) participant P as Painel participant S as Staff Dracma D->>P: pede operação Real (motivo, IPs, URL, fator forte) P-->>D: pedido pendente S->>P: aprova (outra pessoa, fator forte) P->>P: cria a operação e provisiona regras, chave e webhook P-->>D: operação Real, chave disponível por 24 h D->>P: revela o segredo da chave (uma vez, fator forte)

Estados do pedido: pendente, executado, recusado, cancelado e falhou. Só quem pediu cancela. Quem pediu nunca vota. Os detalhes estão em Tenants e operações.

2. Revelar a chave key_live_

Depois da aprovação, o painel mostra a operação como "Configurando" até o provisionamento terminar (alguns minutos, com novas tentativas automáticas). Então:

  1. A chave aparece com o prazo para revelar: 24 horas.
  2. Quem pediu a operação clica em revelar, com fator forte. O segredo aparece uma única vez.
  3. Grave o segredo no seu cofre e entregue ao conector pela sua ferramenta de deploy. Veja Segredos e vazamento.

Se o prazo vencer ou a tela for fechada, a chave não é mais revelável. Peça uma chave nova (aprovação de outra pessoa e 24 h de espera). Uma operação aceita até duas chaves ativas.

3. Gateway ativo

A operação Real só cobra e paga depois que existe uma conexão de gateway ativa. Quem faz isso é o Dracma, não você:

  1. O staff cadastra a credencial do PSP na operação. A conexão nasce inativa.
  2. Uma segunda pessoa do Dracma aprova a ativação.
  3. Você vê a conexão no painel, em "Gateways", somente leitura: PSP, direção (entrada ou saída), prioridade e se está ativa.

Confirme na tela "Gateways" que a conexão está ativa antes do primeiro teste. Sem conexão ativa a operação Real não tem como cobrar. Veja Gateways (só leitura) e PSPs.

4. Webhook de produção

  1. A URL informada no pedido já vale na operação nova. Mudanças depois passam por aprovação de outra pessoa e 24 h de espera, pelo painel.
  2. O primeiro segredo de webhook só existe depois de "Rotacionar segredo" na tela de webhooks. Quem tem permissão de gerir webhooks (administrador do tenant) o rotaciona; o valor aparece uma única vez.
  3. Instale o segredo no receptor de produção. Veja Segredo e rotação.

5. Limites conservadores e alertas

A operação nasce com um conjunto de regras inicial. Antes da primeira transação real, deixe-o mais restritivo do que o necessário:

  1. Leia a regra ativa com GET /v1/rules ou na tela "Regras e listas". Este guia não publica valores padrão: consulte a sua operação.
  2. Proponha a mudança (pelo painel, com simulação prévia; ou por POST /v1/rules/change-requests com uma chave que tenha o escopo rules:propose).
  3. Endurecer (limites menores, mais revisão) vale na hora. Afrouxar exige a aprovação de outra pessoa e 24 h de espera.
  4. Configure os alertas de caixa baixo e de webhook falhando em "Alertas". Veja Alertas e e-mails.

6. Primeira transação real

Faça um depósito de valor mínimo pela tela "Cobrança de teste" (em operação Real ela pede a confirmação "é REAL") ou pela API, e acompanhe do POST ao crédito e à linha da reconciliação. Depois faça um saque de valor mínimo.

Não disponível

O Dracma não permite abastecer o caixa de saques de outra forma que não seja por depósitos pagos (ou devoluções). Não existe aporte. O primeiro saque real só é possível depois de existir depósito pago na operação. Confira GET /v1/balances.

Exemplos

Prova de que a chave certa está no conector: GET /v1/ping com a chave nova devolve environment: "production" e o operation_id da operação Real.

{ "ok": true, "operation_id": "0192a3b4-0000-7000-8000-0000000000b2", "environment": "production", "server_time": "2026-10-18T12:00:00Z" }

Usar a chave key_test_ no host da operação Real, ou o inverso, volta 401 unknown_key.

Erros e casos de borda

O que você vê Causa O que fazer
Pedido fica pendente ninguém do Dracma aprovou avise o Dracma pelo canal do onboarding
self_review_forbidden quem pediu tentou votar outra pessoa vota
reveal_expired passou das 24 h para revelar peça outra chave
already_revealed o segredo já foi mostrado use o que você guardou; se perdeu, peça outra chave
key_limit_reached já há duas chaves ativas revogue uma que não é mais usada
Operação "Configurando" por muito tempo passo de provisionamento falhando aguarde as novas tentativas automáticas; se passar bem de 10 minutos, abra chamado
environment_not_allowed tipo não permitido na instância veja Ambientes, tipos de operação e hosts

Não disponível

Editar ou apagar um tenant ou uma operação não é possível pelo painel. Peça ao suporte.

Veja também