API de Verificação de Número de Verificação Bancária (BVN) na Nigéria (PT-PT)

Integrar utilizadores na Nigéria significa confirmar que são quem dizem ser. Isto verifica os dados introduzidos na base de dados da Indústria Bancária Nigeriana. Um documento ou um detalhe digitado apenas prova que os dados existem — não que são genuínos ou pertencem à pessoa à sua frente. A Verificação do Número de Verificação Bancária (BVN) da Nigéria preenche essa lacuna, verificando os dados com o BVN. Este guia explica o que a verificação faz, os detalhes técnicos exatos e como integrá-la em minutos.

Principais pontos:

• O que verifica — A Verificação do Número de Verificação Bancária (BVN) da Nigéria valida a conta bancária contra o BVN.
• O que obtém — um match_type normalizado, mais resultados ao nível do campo que pode encaminhar diretamente para a lógica de aprovação / revisão / rejeição.
• Por que é importante — Confirmar a identidade do titular da conta previne fraudes de pagamento e apoia a integração de pagamentos e folha de pagamentos.
• Como usar — um POST para o endpoint de validação de base de dados da Didit. 0,80$ por consulta conclusiva, resultados em segundos.

O que a Verificação do Número de Verificação Bancária (BVN) da Nigéria valida

Verifica os dados de entrada na base de dados da Indústria Bancária Nigeriana. A Didit expõe-no através de um único endpoint para que possa verificar os dados submetidos contra a rede nacional de bancos / propriedade de contas e receber um resultado estruturado e normalizado — não um despejo de registo bruto que tenha de analisar por si mesmo.

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

Por que é importante

Confirmar a identidade do titular da conta previne fraudes de pagamento e apoia a integração de pagamentos e folha de pagamentos.

Para empresas reguladas na Nigéria — fintechs, plataformas de criptomoedas, credores, mercados e operadores de jogos — a verificação contra uma fonte autoritária produz um registo defensável e auditável de que a identidade foi confirmada na fonte, e não apenas capturada de um formulário ou de uma fotografia.

Detalhes técnicos

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

Endpoint

POST /v3/database-validation/

Parâmetros do pedido

Parâmetro	Tipo	Obrigatório	Descrição
issuing_state	string	Sim	Código do país ISO 3166-1 alfa-3. Use NGA.
services	string	Sim	Identificador de serviço. Use nga_bank_verification_number.
first_name	string	Sim	Primeiro nome.
last_name	string	Sim	Último nome.
bvn	string	Sim	BVN.
date_of_birth	string	Não	Data de nascimento (verificação cruzada opcional).

Exemplo de pedido

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=NGA" \
  -F "services=nga_bank_verification_number" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "bvn=11111111111"

Exemplo de resposta (correspondência conclusiva)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "NGA",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "nga_bank_verification_number",
      "service_name": "Nigeria Bank Verification Number (BVN)",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "last_name": "Doe"
      },
      "validation": {
        "full_name": "full_match"
      }
    }
  ]
}

Desempenho e faturação

• Latência: tipicamente alguns segundos.
• Custo: 0,80$ por consulta conclusiva. Será faturado apenas por resultados conclusivos — sem custos por tempo de inatividade da fonte, campos em falta ou rejeições pré-fonte.
• Fiabilidade: funciona na infraestrutura da Didit com um objetivo de tempo de atividade trimestral de 99,9%.

Casos de uso

• Fintech e neobancos — confirme um titular de conta real e verificável antes de abrir uma carteira ou conceder crédito na Nigéria.
• Cripto e Web3 — cumpra os requisitos de integração VASP com prova de identidade de fonte autoritária.
• Empréstimos — reduza a fraude de identidade sintética e de primeira parte com dados verificados na fonte.
• Mercados e plataformas de gig — verifique os utilizadores com dados autoritários, não apenas um formulário auto-reportado.
• iGaming — satisfaça as verificações de identidade e elegibilidade para jogadores da Nigéria com um rasto auditável.

Como integrar com a Didit

Pode executar a Verificação do Número de Verificação Bancária (BVN) da Nigéria de duas maneiras:

1. Apenas API direta. Este serviço funciona através da API, em vez do construtor de fluxo de trabalho sem código.
2. API direta. Chame o endpoint /v3/database-validation/ mostrado acima com services=nga_bank_verification_number. Leia match_type e o bloco validation por campo para conduzir a sua lógica de aprovação / revisão / rejeição.

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

Perguntas frequentes

O que a verificação do Número de Verificação Bancária (BVN) da Nigéria confirma?

Valida os dados submetidos contra o BVN e devolve um resultado de correspondência normalizado, para que saiba se a conta bancária existe na fonte autoritária e quais os campos que corresponderam.

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

Não será cobrado. A faturação aplica-se apenas a resultados conclusivos — tempo de inatividade da fonte, campos em falta e rejeições pré-fonte são gratuitos.

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

A validação da base de dados normalmente retorna em alguns segundos, por isso é adequada para um fluxo de integração em tempo real.

Preciso de um SDK?

Não. A verificação é um único POST HTTPS para um endpoint.

Pronto para começar?

Valide a sua primeira conta bancária da Nigéria hoje mesmo.

• Leia a referência da API: Verificação do Número de Verificação Bancária (BVN) da Nigéria
• Veja todas as validações da base de dados: Preços e cobertura da Validação da Base de Dados
• Comece a construir: Crie uma conta Didit gratuita — 500 verificações por mês, gratuitas.