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
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âmetro | Descrição | Regra |
|---|---|---|
documento | DocumentoCPF ou CNPJ de quem deveria ser o titular da chave. | Obrigatório |
chavePix | Chave pixChave Pix a conferir: CPF, CNPJ, e-mail ou telefone com DDD. Chave aleatória não é aceita. | Obrigatório |
tipoChavePix | Tipo 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 pessoalChave Pix
Chave Pix consultada, como a fonte a devolveu.
tipoTipo da chave Pix
Tipo da chave: CPF, CNPJ, e-mail ou telefone.
documentoDado pessoalDocumento consultado
CPF ou CNPJ pesquisado, como a fonte o devolveu.
nomeEntidadeDado pessoalNome ou razão social
Nome da pessoa ou razão social da empresa pesquisada. Nome do titular da chave, como a fonte informa.
statusSituação da chave Pix
Situação da chave no momento da consulta, como a fonte informa.
probabilidadeTitularidadeProbabilidade de titularidade
Chance de a chave Pix pertencer ao CPF ou CNPJ informado, como a fonte a expressa.
riscoFraudeRisco de fraude
Classificação do risco de fraude ligado à chave Pix.
riscoLaranjaRisco 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"{ "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 */ }}Perguntas frequentes sobre Antifraude Chave PIX
Outras APIs para combinar
Ver catálogo completoPEP — Pessoa Exposta Politicamente
Verifica se o CPF é de Pessoa Exposta Politicamente: função, órgão e período de exposição.
PEP Estendida — Parentescos
PEP com rede de parentesco: além do titular, aponta vínculos familiares com pessoas expostas politicamente.
Vínculos Societários
Rede de vínculos societários da pessoa ou empresa: participações, sociedades e ligações diretas.
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.