NovoCentral de APIs
Compliance

Antifraude Chave PIX

Confere se a chave Pix pertence ao CPF ou CNPJ informado e devolve o status da chave, a probabilidade de titularidade, o risco de fraude e o risco de conta laranja.

Fonte
Pix · Banco Central do Brasil
Entrada
Documento + Chave pix
Comprovante PDF
Não emite
Preço
R$ 1,55 por chamada
GEThttps://api.agrolitics.com.br/api/Marketplace/Consulta/antifraude-chave-pix?documento=00000000000&chavePix=contato@empresa.com.br

Para que serve

Confere se uma chave Pix pertence ao CPF ou CNPJ informado antes de você pagar, cadastrar ou liberar crédito. O retorno traz o nome do titular, o tipo e a situação da chave, a probabilidade de a chave ser mesmo daquele documento e a classificação dos riscos de fraude e de conta laranja.

Ideal para

Prevenção a fraude em pagamentosCadastro de fornecedores e parceirosLiberação de crédito e de saquesConciliação de recebimentos

Por que usar

  • Pague a quem deve

    Confirme que a chave informada é do titular certo antes de transferir.

  • Sinal de conta laranja

    A classificação de risco aponta chaves usadas por terceiros.

  • Pronto para o seu sistema

    Resposta em JSON estruturado, com os mesmos campos em toda consulta, para entrar direto no seu motor de regras.

Parâmetros

ParâmetroDescriçãoRegra
documentoDocumentoCPF ou CNPJ de quem deveria ser o titular da chave.Obrigatório
chavePixChave pixChave Pix a conferir: CPF, CNPJ, e-mail ou telefone com DDD. Chave aleatória não é aceita.Obrigatório
tipoChavePixTipo chave pixTipo da chave: CPF, CNPJ, EMAIL ou TELEFONE. Opcional — sem ele, o tipo é deduzido da própria chave.Opcional

O que você recebe

8 campos no retorno, como o seu sistema recebe.

  • chavePixDado pessoal

    Chave Pix

    Chave Pix consultada, como a fonte a devolveu.

  • tipo

    Tipo da chave Pix

    Tipo da chave: CPF, CNPJ, e-mail ou telefone.

  • documentoDado pessoal

    Documento consultado

    CPF ou CNPJ pesquisado, como a fonte o devolveu.

  • nomeEntidadeDado pessoal

    Nome ou razão social

    Nome da pessoa ou razão social da empresa pesquisada. Nome do titular da chave, como a fonte informa.

  • status

    Situação da chave Pix

    Situação da chave no momento da consulta, como a fonte informa.

  • probabilidadeTitularidade

    Probabilidade de titularidade

    Chance de a chave Pix pertencer ao CPF ou CNPJ informado, como a fonte a expressa.

  • riscoFraude

    Risco de fraude

    Classificação do risco de fraude ligado à chave Pix.

  • riscoLaranja

    Risco de conta laranja

    Classificação do risco de a chave pertencer a uma conta usada por terceiros (conta laranja).

Opções da chamada

  • assincrono=trueProcessa em segundo plano e devolve 202 com o consultaId.
  • comprovante=trueEsta API não emite comprovante em PDF.

Códigos de resposta

  • 200Sucesso — Consulta concluída; o retorno traz os dados da fonte.
  • 202Em processamento — Recupere em GET /api/Marketplace/Consulta/Resultado/{consultaId}. Recuperar não é cobrado.
  • 422Requisição inválida — Parâmetros validados antes de qualquer cobrança.
  • 429Limite simultâneo — Até 5 consultas simultâneas por cliente.
  • 503Em manutenção — A consulta está temporariamente indisponível; nada é cobrado.

Como é cobrado

  • Débito por chamada — do saldo pré-pago ou do contrato pós-pago
  • Preço exibido na plataforma antes de executar
  • Falhas estornadas automaticamente
  • Mesmo preço na plataforma e na API
curl "https://api.agrolitics.com.br/api/Marketplace/Consulta/antifraude-chave-pix?documento=00000000000&chavePix=contato@empresa.com.br" \  -H "X-Api-Key: $AGROLITICS_API_KEY"
Resposta · envelope padrão
200 OK
{  "metaDados": {    "consultaId": "3f9c2a71-5b8e-4d1a-9c07-1e6b2f8a4d90",    "apiIdentificador": "antifraude-chave-pix",    "apiNome": "Antifraude Chave PIX",    "fonte": "Pix · Banco Central do Brasil",    "status": "Concluída",    "resultado": "Sucesso",    "tempoExecucaoMs": 1840,    "assincrono": false,    "urlComprovante": null  },  "retorno": { /* dados da fonte — variam por consulta */ }}
Referência completa no Swagger

Perguntas frequentes sobre Antifraude Chave PIX

CPF, CNPJ, e-mail ou telefone com DDD. Chave aleatória não é aceita.

Comece a integrar

Leve as fontes oficiais do agro para dentro do seu sistema

Crie sua conta e teste qualquer API na plataforma — ou fale com um especialista para desenhar a integração e o contrato ideais para o seu volume.

  • APIs de fontes oficiais, com resposta padronizada
  • Pague por chamada — sem mensalidade, falhas estornadas
  • API do Dossiê BNIR com lotes de até 1.000 CARs
  • Webhooks assinados e comprovante em PDF
  • Conformidade LGPD — fontes oficiais, log auditável

Solicite uma Demonstração

Nossa equipe entrará em contato em breve.

Sem compromisso. Seus dados são usados só para este contato, conforme a Política de Privacidade.