Como integrar o BINLIST.net a um motor de decisão
O BINLIST é um serviço que identifica dados do cartão a partir dos 6 ou 8 primeiros dígitos. Ele informa se o cartão é de crédito ou débito e pode indicar se é pessoal, empresarial ou corporativo. Para alguns BINs, o serviço informa apenas o país emissor. Para outros, também identifica o banco emissor e fornece dados sobre ele.
O serviço é gratuito para quem faz menos de 10 requisições por minuto. Para um volume baixo de requisições, a integração é simples. Se você precisar de mais, entre em contato com binlist.net para obter chaves de API.
Crie uma fonte de dados no Decisimo Portal
Em Data sources, selecione New e peça ao AI Assistant para configurar o provedor. Revise e aprove a proposta antes de aplicá-la.- Depois de criar a fonte de dados, não é necessário fazer mais nada, porque o serviço não exige uma chave de API no plano gratuito.
- Informe ao AI Assistant que a API precisa apenas do BIN do cartão. Ele sugere o endpoint e os parâmetros. Revise e ajuste a proposta antes de aplicar a conexão ao seu fluxo de decisão.
Adicione a fonte de dados BINLIST.net ao fluxo de decisão
- Se você já tem uma etapa de decisão para fontes de dados, adicione a chamada ao BINLIST.net nessa mesma etapa. O motor de decisão chamará todas as fontes dessa etapa em paralelo, para executar as chamadas no menor tempo possível.
- Se o fluxo de decisão ainda não tiver uma etapa para dados externos, adicione uma. Conecte-a ao fluxo e clique duas vezes para abrir a janela de definição.
- Na etapa do fluxo de decisão, defina qual atributo do objeto de dados contém o BIN que será enviado ao BINLIST.net. Envie apenas os 6 ou 8 primeiros dígitos, nunca o número completo do cartão.
-
Execute a tomada de decisão
- Faça o release do fluxo de decisão, publique-o em um endpoint e tome decisões usando os dados do BINLIST.net.
Perguntas frequentes
Quais dados do cartão a decisão deve enviar ao BINLIST.net?
Envie apenas os 6 ou 8 primeiros dígitos do cartão, conforme exigido pela consulta, e mapeie o atributo de origem para esse valor reduzido antes de chamar o serviço. Nunca envie o número completo do cartão em uma consulta de BIN. Confira os parâmetros configurados e teste os dados enviados, pois selecionar a entrada errada pode expor mais dados do cartão do que a consulta exige.
Devo usar seis ou oito dígitos na consulta de BIN?
Siga os requisitos atuais da API do BINLIST.net e use o menor prefixo aceito que retorne os campos necessários para sua política. A cobertura varia conforme o BIN: alguns resultados informam apenas o país emissor, enquanto outros incluem o tipo de cartão ou dados do emissor. Teste cartões representativos do seu mercado e configure a política para lidar com campos ausentes.
O que a decisão antifraude deve fazer se o BINLIST.net retornar dados incompletos ou não responder?
Trate a ausência de dados do emissor ou do tipo de cartão como informação desconhecida, não como prova de legitimidade ou fraude. Defina uma alternativa com os sinais disponíveis, como continuar com outras verificações ou encaminhar o pagamento para análise. Teste os cenários de tempo esgotado e resposta parcial antes do release e confira se a política não substitui silenciosamente os dados ausentes por um valor padrão.
