Como avaliar o risco de transação com a Toden
Charles Archibong, Cofundador
Avalie o risco da transação antes de movimentar dinheiro. Envie o valor exato, a direção correta e as partes envolvidas, e utilize a decisão e sua justificativa.
Pontos principais
- Uma solicitação completa mostra o remetente e o destinatário pretendidos.
- Permitir, revisar, bloquear e lidar com falhas de serviço utilizam os caminhos de pagamento corretos.
- Uma nova tentativa não gera nova pontuação nem cobrança.
- A decisão exibida corresponde ao registro da API.
- A versão criptográfica utiliza sua própria integração de autorização qualificada.
Avalie o risco da transação antes de movimentar dinheiro. Envie o valor exato, a direção correta e as partes envolvidas, e utilize a decisão e sua justificativa.
Antes de começar
Valor exato, moeda, direção e referência estável.
Regras publicadas e requisitos de transferência aplicáveis
Use um membro da equipe com permissão para este controle. Verifique a organização e o ambiente antes de alterar qualquer configuração. Revise o preço atual antes de efetuar um pagamento ou renovar a assinatura. As capturas de tela mostram um exemplo de espaço de trabalho ou a referência de integração pública; elas não mostram um cliente real nem um pagamento efetuado.
Configure e utilize a funcionalidade.
Etapa 1: Configure os controles de transação no ambiente de teste (Sandbox).
Acesse Inteligência de Risco → Monitoramento de Fraudes → Transações e revise os requisitos de configuração. Em Regras e Políticas → Regras de Fraude , instale as regras adequadas da biblioteca ou teste e publique uma regra personalizada. Revise os limites e os valores máximos de transação. A instalação publica uma versão da regra para a organização e o ambiente selecionados. A pré-visualização da página com a pontuação de risco é um dado de demonstração e não um sistema de decisão configurado.
Referência de integração: Comece com a biblioteca de regras.
Etapa 2: Prepare uma solicitação de transação completa
Atribua referências estáveis para atividades externas e transações. Especifique o assunto , a data de ocorrência original , a classe do ativo , a direção , o valor , a moeda e o tipo de transação . Envie o valor como uma string decimal positiva exata, não como um cálculo de ponto flutuante. A direção é da perspectiva do seu cliente: entrada significa recebido pelo cliente, saída significa enviado por ele. Associe cada conta bancária ou carteira à parte que a utilizou.
Referência de integração: Enviar uma transação completa
Etapa 3: Inclua a parte que precisa de triagem.
Para pagamentos em moeda fiduciária de saída, forneça o nome e o contexto de identidade permitidos do destinatário; para pagamentos em moeda fiduciária de entrada, verifique o remetente. Para criptomoedas, forneça o endereço da carteira da parte externa relevante e a rede explícita. Cada parte precisa de uma referência estável. A falta de evidências do alvo pode resultar em uma revisão por dados insuficientes em vez de um resultado claro. Um valor de exibição mascarado por si só não permite identificar um instrumento de pagamento.
Referência de integração: Como funciona a triagem direcional
Etapa 4: Envie uma única vez e leia o resumo oficial.
Chamar POST Acesse a API /api/v1/transactions do seu backend com uma chave secreta e uma chave de idempotência estável . Armazene as referências de atividade, transação e decisão retornadas. Leia assessment.summary.outcome , reason e nextAction. Mantenha as opções de Revisão e Bloqueio separadas das opções de Permissão. Regras detalhadas de correspondência, triagem e faturamento explicam o resultado; não as some você mesmo para substituir o resultado retornado.
Referência de integração: Resposta à avaliação da transação
Etapa 5: Garantir o resultado antes da movimentação de fundos
Seu sistema de pagamento mantém a análise em execução, interrompe o bloqueio e continua permitindo a liberação de acordo com sua política operacional autorizada. Mantenha os resultados indisponíveis ou pendentes durante o período de retenção necessário. Para criptomoedas, uma permissão baseada apenas em risco não constitui autorização de viagem nem autorização de execução de uso único. Toden Não houve movimentação de fundos. Pesquise a referência da transação no painel de controle e verifique as evidências antes de abrir uma exceção manual.
Referência de integração: Implementando decisões no seu aplicativo
Etapa 6: Novas tentativas de teste, notificações e resultados finais
Após incertezas, tente novamente as solicitações inalteradas com as referências e a chave originais. Inscreva-se em fraud.transaction.assessed e nas alterações de decisão aplicáveis. Verifique as assinaturas, armazene os IDs de evento de forma duradoura e recupere o estado atual para eventos atrasados. Envie os resultados downstream confirmados quando conhecidos para que a equipe de Eficácia possa medir o desempenho. Um webhook entregue com sucesso não comprova que seu sistema de pagamento aplicou a decisão.
Referência de integração: Idempotência e frescor
Tire o máximo proveito dessa capacidade.
Inclua remetentes, destinatários e instrumentos estruturados para tornar a triagem e as evidências de relacionamento mais informativas.
Realize backtests das alterações nas regras antes de publicar uma nova versão e mantenha a versão exata com as decisões que ela produziu.
Registre fraudes confirmadas, resultados legítimos e inconclusivos. Evite ajustar os limites com base apenas em decisões não rotuladas.
Faça o teste antes de confiar nele.
Execute os cenários de Sandbox ou simulador compatíveis com este produto. Quando uma ferramenta for exclusiva para Produção, verifique primeiro o acesso e o escopo e, em seguida, use apenas um teste de Produção permitido e cuidadosamente revisado. Uma captura de tela da documentação ou o carregamento bem-sucedido de uma página não constituem um teste de integração de ponta a ponta.
Uma solicitação completa mostra o remetente e o destinatário pretendidos.
Permitir, revisar, bloquear e lidar com falhas de serviço utilizam os caminhos de pagamento corretos.
Uma nova tentativa não gera nova pontuação nem cobrança.
A decisão exibida corresponde à API registro.
A versão criptográfica utiliza sua própria integração de autorização qualificada.
Solução de problemas
Uma transação precisa ser revisada mesmo sem ter atingido nenhuma regra.
Analise a triagem direcional e as evidências de dados insuficientes, e não apenas a contagem de regras correspondentes.
O valor ou a localização foram rejeitados.
Use sequências decimais exatas e forneça tanto a latitude quanto a longitude ao enviar as coordenadas.
A nova tentativa gerou um conflito.
Os mesmos identificadores foram usados para dados imutáveis alterados. Reconcilie a transação original antes de uma nova operação genuína.
Abra as referências de configuração e integração.
Abra a ferramenta de painel de controle. (abre num novo separador)
Leia a referência de integração. (abre num novo separador)
Voltar para Soluções (abre num novo separador) . Escolha a funcionalidade que deseja ativar e siga o guia correspondente.
Fontes
Charles Archibong
Cofundador
Charles Archibong é cofundador da Toden. Ele escreve sobre verificação de identidade, tecnologia financeira e o trabalho prático de construção de serviços digitais confiáveis.
