Gateways (só leitura)

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

A tela Gateways mostra, em modo de leitura, as conexões de PSP (o provedor de pagamento) da operação: qual é, para que direção serve, em que ordem é usada e se está ativa. O cadastro e a ativação de uma conexão são feitos pela equipe do Dracma. Você não digita nem vê credenciais.

O que é

Uma conexão liga a operação a um PSP para uma direção: Entrada (receber depósitos), Saída (pagar saques) ou Entrada e saída. A operação pode ter mais de uma conexão.

A tela (menu Plataforma, item Gateways) lista, para a operação escolhida no seletor:

Coluna O que mostra
PSP O nome do provedor, como MaximaxPay ou Mercado Pago.
Direção Entrada, Saída ou Entrada e saída.
Prioridade Um número de 1 a 1000; menor número = tentado primeiro.
Situação Ativa ou Inativa.
Credencial cadastrada Sim ou Não. É só o indicador: o valor nunca aparece.
Criada em Data e hora, no horário de Brasília.

Qualquer pessoa com acesso à operação vê a tela. Uma operação de Teste sem conexão usa o simulador do Dracma; nesse caso a tela mostra "Nenhuma conexão cadastrada nesta operação", e isso é o esperado.

Quando usar

Consulte a tela para:

  • confirmar, antes do go-live, que a operação Real tem uma conexão Ativa para entrada e uma para saída (veja De Teste para Real);
  • conferir a ordem das conexões quando houver mais de uma;
  • entender por que um depósito ou saque não anda: conexão Inativa ou sem credencial.

Qual PSP atende cada tipo de operação e cada direção está em PSPs.

Como funciona

Quem cadastra. Só a equipe do Dracma cadastra uma conexão. Você não tem botão para isso, e as credenciais do PSP nunca passam pelo painel do operador. A tela diz: "As credenciais são cadastradas pelo suporte do Dracma; o painel nunca as mostra."

Como a conexão fica ativa.

sequenceDiagram participant S1 as Equipe do Dracma (1) participant S2 as Equipe do Dracma (2) participant PSP as PSP participant O as Você S1->>S1: Cadastra a conexão (nasce Inativa) S1->>PSP: Registra a URL de callback da conexão S1->>S2: Propõe a ativação (prioridade e direção) S2->>S1: Aprova (outra pessoa, com confirmação) Note over S1,S2: A conexão passa a Ativa O->>O: Vê a linha como Ativa em Gateways
  1. A conexão nasce Inativa, com prioridade entre 1 e 1000.
  2. A equipe do Dracma registra no PSP a URL de callback da conexão (veja abaixo).
  3. A ativação é um pedido com aprovação de outra pessoa da equipe do Dracma e confirmação recente de identidade. Não há espera de 24 horas.
  4. Mudar prioridade, direção ou desativar uma conexão segue o mesmo caminho. Desativar uma conexão pode afetar cobranças e saques em andamento nela, por isso a equipe do Dracma prefere mudar a prioridade.

Você acompanha só o resultado: a linha passa de Inativa para Ativa.

Não disponível

O painel do operador não permite cadastrar, ativar, desativar nem reordenar conexões. Peça ao suporte do Dracma. O mesmo vale para trocar as credenciais do PSP.

Callback não é webhook

São dois canais diferentes, em direções opostas:

Callback Webhook
Quem chama O PSP O Dracma
Quem recebe O Dracma, no host cb. O seu receptor
Quem configura A equipe do Dracma, no painel do PSP Você, em Webhooks no painel
O que informa Que um pagamento ou saque mudou de estado no PSP Que um depósito ou saque mudou de estado no Dracma

A URL de callback é própria de cada conexão e só a equipe do Dracma a usa. Você não precisa registrar nem proteger o callback; o que você recebe do Dracma são os webhooks.

Conta de PSP compartilhada

Uma mesma conta de PSP do Dracma pode atender mais de uma operação. A gestão dessas contas é só da equipe do Dracma e não aparece para você. O efeito para o seu lado é que saldo e reconciliação são sempre da sua operação, no livro do Dracma, e nunca o extrato do PSP. A tela Saldos e caixa deixa isso explícito.

Exemplos

Operação Real pronta para o go-live:

PSP Direção Prioridade Situação Credencial cadastrada
MaximaxPay Entrada e saída 1 Ativa Sim

Operação Real que ainda não está pronta:

PSP Direção Prioridade Situação Credencial cadastrada
Mercado Pago Entrada 1 Inativa Sim

Nesse caso, aguarde a ativação pela equipe do Dracma antes de gerar depósitos reais.

Erros e casos de borda

  • "Nenhuma conexão cadastrada nesta operação." Normal em operação de Teste (usa o simulador). Em operação Real, falta o cadastro: acione o suporte.
  • Conexão Ativa com "Credencial cadastrada: Não". Não deveria acontecer; acione o suporte.
  • Tela em branco ou "Não encontrado". Você abriu a tela sem escolher uma operação a que tem acesso. Escolha a operação no seletor.
  • "Executor indisponível agora". O serviço que lê as conexões não respondeu. Repita em instantes.
  • Prioridade. A ordem da tela não significa que o Dracma troque sozinho de conexão quando uma falha: veja em PSPs como a escolha da conexão funciona.

Veja também