API de Verificação de Cidadania Argentina (AFIP) (PT-BR)

Integrar usuários na Argentina significa confirmar se eles são quem dizem ser. Verifica os dados inseridos na AFIP (Administracion Federal de Ingresos Publicos). Um documento ou um dado digitado apenas prova que o dado existe — não que seja genuíno ou pertença à pessoa à sua frente. A Verificação de Cidadania Argentina (AFIP) preenche essa lacuna, verificando os dados com a AFIP. Este guia explica o que a verificação faz, os detalhes técnicos exatos e como integrá-la em minutos.

Principais vantagens:

• O que é verificado — A Verificação de Cidadania Argentina (AFIP) valida o registro de cidadania na AFIP.
• O que você recebe — um match_type normalizado mais resultados de nível de campo que você pode direcionar diretamente para a lógica de aprovar / revisar / rejeitar.
• Por que isso importa — Confirmar o status de cidadania no registro original impede a fabricação de identidade e oferece suporte a verificações de residência, benefícios e integração regulamentada.
• Como usá-lo — um POST para o endpoint de validação de banco de dados da Didit ou um módulo de fluxo de trabalho sem código. US$ 1,84 por consulta conclusiva, resultados em segundos.

O que a Verificação de Cidadania Argentina (AFIP) valida

Verifica os dados inseridos na AFIP (Administracion Federal de Ingresos Publicos). A Didit expõe isso por meio de um único endpoint para que você possa verificar os dados enviados em relação ao registro oficial de cidadania / civil e receber um resultado estruturado e normalizado — não um dump de registro bruto que você precisa analisar sozinho.

Uma resposta conclusiva retorna os source_data correspondentes e um bloco de validation por campo, para que seu mecanismo de risco obtenha um veredicto claro e legível por máquina.

Por que isso importa

Confirmar o status de cidadania no registro original impede a fabricação de identidade e oferece suporte a verificações de residência, benefícios e integração regulamentada.

Para empresas regulamentadas na Argentina — fintechs, plataformas de criptomoedas, credores, marketplaces e operadores de jogos — verificar em relação a uma fonte autoritativa produz um registro defensável e auditável de que a identidade foi confirmada na fonte, não apenas capturada de um formulário ou foto.

Detalhes técnicos

A Didit expõe este serviço através do endpoint unificado de validação de banco de dados. É um único POST — nenhum SDK necessário.

Endpoint

POST /v3/database-validation/

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Descrição
issuing_state	string	Sim	Código de país ISO 3166-1 alpha-3. Use ARG.
services	string	Sim	Identificador do serviço. Use arg_citizens.
first_name	string	Sim	Nome.
last_name	string	Sim	Sobrenome.
date_of_birth	string	Sim	Data de nascimento.
document_number	string	Sim	Número do documento.

Exemplo de solicitação

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: SUA_CHAVE_API" \
  -F "issuing_state=ARG" \
  -F "services=arg_citizens" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "date_of_birth=1990-01-01" \
  -F "document_number=1111111"

Exemplo de resposta (correspondência conclusiva)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "ARG",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "arg_citizens",
      "service_name": "Cidadania Argentina (AFIP)",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "full_name": "John Doe",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe",
        "name_match_score": "1.000",
        "verifications": {
          "date_of_birth": true,
          "full_name": true,
          "identification_number": true
        }
      },
      "validation": {
        "date_of_birth": "full_match",
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

Desempenho e cobrança

• Latência: normalmente alguns segundos.
• Custo: US$ 1,84 por consulta conclusiva. Você é cobrado apenas por resultados conclusivos — sem cobrança por inatividade da fonte, campos ausentes ou rejeições pré-fonte.
• Confiabilidade: executado na infraestrutura da Didit com uma meta de tempo de atividade trimestral de 99,9%.

Casos de uso

• Fintechs e neobancos — confirme um titular de conta real e verificável antes de abrir uma carteira ou conceder crédito na Argentina.
• Crypto & Web3 — cumpra os requisitos de integração VASP com prova de identidade de fonte autoritativa.
• Empréstimos — reduza a fraude de identidade sintética e de primeira parte com dados verificados na fonte.
• Marketplaces e plataformas de trabalhos freelancer — verifique os usuários em relação a dados autoritativos, não apenas a um formulário auto-declarado.
• iGaming — atenda aos requisitos de verificação de identidade e elegibilidade para jogadores argentinos com um registro auditável.

Como integrar com a Didit

Você pode executar a Verificação de Cidadania Argentina (AFIP) de duas maneiras:

1. Fluxo de trabalho sem código. No Console de Negócios da Didit, abra o Criador de Fluxos de Trabalho, adicione o módulo Validação de Banco de Dados, selecione Argentina → Verificação de Cidadania Argentina (AFIP) e ative-o. Os usuários correspondentes são roteados automaticamente — sem necessidade de engenharia.
2. API direta. Chame o endpoint /v3/database-validation/ mostrado acima com services=arg_citizens. Leia match_type e o bloco de validation por campo para acionar sua lógica de aprovar / revisar / rejeitar.

Toda conta Didit inclui 500 verificações gratuitas por mês, para que você possa testar todo o fluxo de ponta a ponta antes de pagar por uma única consulta.

Perguntas frequentes

O que a Verificação de Cidadania Argentina (AFIP) confirma?

Ela valida os dados enviados em relação à AFIP e retorna um resultado de correspondência normalizado, para que você saiba se o registro de cidadania existe na fonte autoritativa e quais campos corresponderam.

O que acontece se a fonte estiver temporariamente indisponível?

Você não será cobrado. A cobrança se aplica apenas a resultados conclusivos — inatividade da fonte, campos ausentes e rejeições pré-fonte são gratuitas.

Quão rápida é a verificação?

A validação de banco de dados normalmente retorna em alguns segundos, então se encaixa em um fluxo de integração em tempo real.

Preciso de um SDK?

Não. A verificação é um único POST HTTPS para um endpoint. Você também pode conectá-lo a um fluxo de trabalho sem código no Console de Negócios.

Pronto para começar?

Valide seu primeiro registro de cidadania argentina hoje.

• Leia a referência da API: Verificação de Cidadania Argentina (AFIP)
• Veja todas as validações de banco de dados: Preços e cobertura da Validação de Banco de Dados
• Comece a construir: Crie uma conta gratuita Didit — 500 verificações por mês, grátis.