Aprove o pagamento certo e segure o suspeito na hora
Um cadastro aprovado ontem não diz nada sobre o pagamento de hoje. A conta pode ter sido tomada, o aparelho pode ser outro, o destino pode ser uma conta de passagem. Este módulo julga o pagamento que está parado esperando e responde antes de o dinheiro se mover.
Avalia a transação que você nos envia e devolve allow, step_up ou deny com as razões e os pontos de risco de cada sinal que disparou: valor fora do padrão do próprio titular, cadência, contraparte nova ou concentradora, troca de aparelho, horário e se aquele titular já foi verificado por você aqui. Roda sobre o seu histórico, sem consórcio com outros clientes. Quem decide liberar o pagamento é você: nós não liquidamos, não acessamos o DICT nem o MED, e o pior desfecho que emitimos é revisar.
- Gate Transacional
"status": "approved"Para quem é
Serve a carteiras digitais, contas de pagamento, operações sobre BaaS e plataformas que repassam valores a terceiros. Todo negócio em que um pagamento errado não volta precisa de uma resposta antes da liquidação, e não de um relatório na semana seguinte.
O julgamento compara o movimento com o que aquele titular costuma fazer com você, e o laudo diz em códigos estáveis o que destoou. Não há consórcio: o histórico é o da sua organização, e o de outros clientes nunca entra na conta.
O que você recebe
A resposta síncrona traz verdict: allow, step_up ou deny. No webhook assinado chega o laudo completo, com risk_score, em que o número alto é o pior, a lista reasons e confidence, que diz quanto o veredito merece crédito. confidence não é probabilidade de fraude: perfil recente ou payload incompleto a derrubam mesmo num allow.
Repetir o mesmo external_id devolve o veredito já dado, sem reavaliar e sem segunda cobrança, o que torna o retry de rede seguro num caminho de pagamento. A sua lista de bloqueio também vale aqui: titular listado pelo reference_id recebe deny com blocklist_hit entre as razões.
O módulo transacao avalia a transação que você envia e devolve allow, step_up ou deny na hora, com as razões de cada sinal.
O módulo se chama transacao no flow e no webhook.
Como entra no seu flow
O gate mora num flow só dele, porque responde na chamada e não abre captura; o KYC continua no flow que você já tem, e os dois se encontram pelo mesmo reference_id. Mande a transação no bloco transaction da criação de sessão, um evento por vez, com external_id obrigatório e ids opacos no lugar de CPF, telefone ou número de cartão.
Trate step_up como o ramo comum: ele é a resposta sempre que o gate prefere não afirmar, e uma integração que só conhece liberar e barrar fica com uma porta aberta. deny é recomendação, e quem segura o dinheiro é o seu sistema.
O grupo do módulo
Sinais de risco da sessão, sem passo novo para o usuário.
Onde ele entra
Preço
R$ 0,12por transação avaliada
O valor é lido do mesmo catálogo que o painel usa para montar um flow, somando os módulos que este exige, se exigir. Ver preços.
Perguntas frequentes
Ler a documentaçãoVocês bloqueiam o pagamento?
Não. Nós não liquidamos, não somos o arranjo Pix e não retemos valor. O veredito chega ao seu backend, e a decisão de liberar, pedir confirmação ou reter é do seu motor de pagamentos.
Como testo os três ramos antes de produção?
No sandbox o veredito sai dos dois últimos dígitos de amount_cents: final 13 barra, final 07 pede prova e qualquer outro libera. A resposta tem a mesma forma da produção e nada é gravado, então o seu código exercita cada caminho sem depender de perfil.
Liquidação e estorno também recebem veredito?
Não. Só o movimento iniciado pelo próprio titular, e que não falhou, é julgado: depósito, saque, transferência e pagamento. Liquidação (settlement), reversão (reversal) e evento com status failed entram na trilha e no histórico, mas não geram avaliação nem cobrança.
Crie a conta, monte um flow com este módulo e rode a verificação inteira no ambiente de teste, sem consumir saldo.
