Antifraude Chave PIX

A conta laranja é criada para despistar o destino do dinheiro, permitindo que sejam feitas movimentações financeiras fraudulentas, sem um registro claro sobre o destino da transação. Para isso, são utilizados dados bancários de pessoas reais, que são vazados, roubados e até mesmo alugados de terceiros.

Casos de Uso

Score antifraude para transações PIX
Verificação de titularidade da chave e conta laranja
Bloqueio preventivo em regras de risco
Monitoramento em tempo real de chaves recorrentes

Aplicações

Onboarding de Clientes e Fornecedores
Análise de Risco/Crédito

Benefícios

Reduz perdas por fraude em pagamentos instantâneos
Diminui falsos positivos com probabilidade de titularidade
Melhora a experiência do cliente com validações rápidas
Escalável para grandes volumes com baixa latência

O endpoint /api/AntifraudePix permite verificar o risco de fraude associado a uma chave PIX, analisando a probabilidade de titularidade e identificando possíveis contas laranjas. Este serviço é essencial para prevenção de fraudes e análise de risco em transações PIX.

URL Base

A API está hospedada no seguinte endereço:

https://apiv3.directd.com.br/api/AntifraudePix

Endpoint

GET https://apiv3.directd.com.br/api/AntifraudePix?Documento={0}&Chave={1}&Tipo={2}&Token=Seu_Token

Descrição: Endpoint para realizar consultas Antifraude Chave PIX.

Nota: Esta consulta não gera comprovantes.

Campos Retornados

Chave Pix: Informa a chave PIX consultada.
Documento: Documento referente ao CPF/CNPJ
Nome Entidade: Nome da entidade ou Razão Social consultada
Probabilidade de Titularidade: Informa a probabilidade de ser o titular.
Risco de Fraude: Nível de risco associado à chave quanto a possível fraude.
Risco de Laranja: Nível de risco de a chave estar em nome de "laranja" (uso indevido por terceiros).
Status: Retorna detalhes sobre o status do registro em questão
Tipo: Tipo do registro em questão

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
`TIPO`	string	Sim	O parâmetro TIPO deve ser enviado (CPF, CNPJ, EMAIL, TELEFONE).
`CHAVE`	string	Sim	O parâmetro CHAVE pode ser enviado com qualquer outro.
`DOCUMENTO`	string	Sim	O parâmetro DOCUMENTO pode ser enviado com ou sem formatação.
`TOKEN`	string	Sim	O parâmetro TOKEN é essencial para efetuar esta consulta. Em caso de dúvidas, por favor, entre em contato com: suporte@directd.com.br

Exemplo de Resposta

{
  "metaDados": {
    "consultaNome": "string",
    "consultaUid": "string",
    "chave": "string",
    "usuario": "string",
    "mensagem": "string",
    "ip": "string",
    "resultadoId": 0,
    "resultado": "string",
    "apiVersao": "v3",
    "enviarCallback": false,
    "gerarComprovante": false,
    "urlComprovante": "string",
    "assincrono": true,
    "data": "dd/MM/yyyy HH:mm:ss",
    "tempoExecucaoMs": 0
  },
  "retorno": {
    "chavePix": "string",
    "documento": "string",
    "nomeEntidade": "string",
    "tipo": "string",
    "status": "string",
    "probabilidadeTitularidade": "string",
    "riscoFraude": "string",
    "riscoLaranja": "string"
  }
}

Erros Comuns

Código	Descrição
400	Requisição Inválida: a requisição está incorreta ou os parâmetros são inválidos.
401	Não Autenticado: o usuário não forneceu as credenciais corretas para acessar o recurso.
403	Não Autorizado: o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível.
404	Não Encontrado: o servidor não encontrou uma representação atual do recurso solicitado.
408	Tempo Esgotado: o servidor não conseguiu retornar a requisição no prazo estabelecido.
500	Falha ao Realizar Consulta: o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte.
503	Consulta em Manutenção: a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte.

Notas Importantes

Informe apenas um único documento por requisição
Para utilizar a consulta de forma assíncrona, utiliza-se: '&async=habilitar' na URL
Em caso de dúvidas/suporte, entre em contato pelo e-mail: suporte@directd.com.br ou pelo nosso WhatsApp: (11) 93906-9228