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

Integrar utilizadores na Argentina implica confirmar que são quem dizem ser. Verifica os dados inseridos junto da AFIP (Administración Federal de Ingresos Públicos). Um documento ou um dado inserido apenas prova que o dado existe – não que seja genuíno ou pertença à pessoa em frente a si. A Verificação de Cidadania Argentina (AFIP) colmata essa lacuna, verificando os dados junto da AFIP. Este guia explica o que a verificação faz, os detalhes técnicos exatos e como integrá-la em minutos.

Principais conclusões:

• O que verifica – A Verificação de Cidadania Argentina (AFIP) valida o registo de cidadania junto da AFIP.
• O que obtém – um match_type normalizado mais resultados ao nível do campo que pode encaminhar diretamente para lógica de aprovar / rever / rejeitar.
• Por que é importante – Confirmar o estatuto de cidadania junto do registo de origem impede a falsificação de identidade e suporta verificações de residência, benefícios e onboarding regulamentado.
• Como usá-lo – um POST para o endpoint de validação de base de dados da Didit, ou um módulo de fluxo de trabalho sem código. 1,84€ por consulta conclusiva, resultados em segundos.

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

Verifica os dados inseridos junto da AFIP (Administración Federal de Ingresos Públicos). A Didit disponibiliza-o através de um único endpoint para que possa validar os dados submetidos em relação ao registo oficial de cidadania / civil e receber um resultado estruturado e normalizado – não um despejo bruto de registo que tem de analisar por si.

Uma resposta conclusiva devolve os source_data correspondentes e um bloco de validation por campo, para que o seu motor de risco receba um veredicto claro e legível por máquina.

Por que é importante

Confirmar o estatuto de cidadania junto do registo de origem impede a falsificação de identidade e suporta verificações de residência, benefícios e onboarding regulamentado.

Para empresas regulamentadas na Argentina – fintechs, plataformas de criptomoedas, instituições de crédito, mercados e operadores de jogos – verificar em relação a uma fonte autoritativa produz um registo defensável e auditável de que a identidade foi confirmada na origem, e não apenas capturada de um formulário ou de uma fotografia.

Detalhes técnicos

A Didit disponibiliza este serviço através do endpoint unificado de validação de base de dados. É um único POST – não é necessário nenhum SDK.

Endpoint

POST /v3/database-validation/

Parâmetros de pedido

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

Exemplo de pedido

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": "Argentina Citizens (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 faturação

• Latência: normalmente alguns segundos.
• Custo: 1,84€ por consulta conclusiva. É cobrado apenas por resultados conclusivos – sem custos por indisponibilidade da fonte, campos em falta ou rejeições pré-fonte.
• Fiabilidade: executa-se na infraestrutura da Didit com um objetivo de tempo de atividade trimestral de 99,9%.

Casos de utilização

• Fintechs e neobancos – confirme um titular de conta real e verificável antes de abrir uma carteira ou conceder crédito na Argentina.
• Cripto e Web3 – cumpra os requisitos de onboarding VASP com uma prova de identidade de fonte autoritativa.
• Empréstimos – reduza a fraude de identidade sintética e de primeira parte com dados verificados na fonte.
• Mercados e plataformas de trabalho temporário – verifique os utilizadores em relação a dados autoritativos, e não apenas a um formulário auto-declarado.
• iGaming – satisfaça as verificações de identidade e elegibilidade para jogadores argentinos com um registo auditável.

Como integrar com a Didit

Pode executar a Verificação de Cidadania Argentina (AFIP) de duas formas:

1. Fluxo de trabalho sem código. Na Consola de Negócios da Didit, abra o Construtor de Fluxos de Trabalho, adicione o módulo Validação de Base de Dados, selecione Argentina → Verificação de Cidadania Argentina (AFIP) e ative-o. Os utilizadores correspondentes são encaminhados automaticamente – não é necessária engenharia.
2. API direta. Chame o endpoint /v3/database-validation/ acima com services=arg_citizens. Leia match_type e o bloco de validation por campo para conduzir a sua lógica de aprovar / rever / rejeitar.

Todas as contas Didit incluem 500 verificações gratuitas por mês, para que possa testar todo o fluxo de ponta a ponta antes de pagar por uma única consulta.

Perguntas frequentes

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

Valida os dados submetidos junto da AFIP e devolve um resultado de correspondência normalizado, para que saiba se o registo de cidadania existe na fonte autoritativa e quais os campos que corresponderam.

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

Não é cobrado. A faturação aplica-se apenas a resultados conclusivos – a indisponibilidade da fonte, campos em falta e rejeições pré-fonte são gratuitas.

Qual é a velocidade da verificação?

A validação de base de dados normalmente é devolvida em alguns segundos, para que se encaixe num fluxo de onboarding em tempo real.

Preciso de um SDK?

Não. A verificação é um único POST HTTPS para um endpoint. Também pode ligá-lo a um fluxo de trabalho sem código na Consola de Negócios.

Pronto para começar?

Valide o seu primeiro registo de cidadania argentina hoje mesmo.

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