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

Integrar usuários na Nigéria significa confirmar que são quem afirmam ser. Verifica os dados de entrada em relação ao banco de dados da Indústria Bancária Nigeriana. Um documento ou um detalhe digitado apenas prova que os dados existem — não que sejam genuínos ou pertençam à pessoa à sua frente. A Verificação do Número de Verificação Bancária da Nigéria (BVN) preenche essa lacuna, verificando os dados em relação ao 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 em relação ao BVN.
• O que você recebe de volta — um match_type normalizado, além de resultados em nível de campo que você pode direcionar 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 pagamento.
• Como usar — um único POST para o endpoint de validação de banco de dados do Didit. US$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 em relação ao banco de dados da Indústria Bancária Nigeriana. O Didit o expõe através de um único endpoint para que você possa verificar os dados enviados em relação à rede nacional de bancos / propriedade de contas e receber um resultado estruturado e normalizado — não um despejo de registro bruto que você precisa analisar por conta própria.

Uma resposta conclusiva retorna os source_data correspondentes e um bloco de validation por campo, para que seu motor de risco obtenha um veredito 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 pagamento.

Para empresas regulamentadas na Nigéria — fintechs, plataformas de cripto, credores, marketplaces e operadores de jogos — a verificação contra uma fonte autoritativa produz um registro defensável e auditável de que a identidade foi confirmada na fonte, e não apenas capturada de um formulário ou uma foto.

Detalhes técnicos

O 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 do país ISO 3166-1 alpha-3. Use NGA.
services	string	Sim	Identificador de serviço. Use nga_bank_verification_number.
first_name	string	Sim	Nome.
last_name	string	Sim	Sobrenome.
bvn	string	Sim	Bvn.
date_of_birth	string	Não	Data de nascimento (verificação cruzada opcional).

Exemplo de solicitação

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: SUA_CHAVE_API" \
  -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 faturamento

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

Casos de uso

• Fintech e Neobancos — confirmam um titular de conta real e verificável antes de abrir uma carteira ou estender crédito na Nigéria.
• Cripto e Web3 — cumprem os requisitos de integração VASP com prova de identidade de fonte autoritativa.
• Empréstimos — reduzem fraudes de identidade sintética e de primeira parte com dados verificados na fonte.
• Marketplaces e plataformas de 'gig' — verificam usuários contra dados autoritativos, não apenas um formulário autorrelatado.
• iGaming — satisfazem verificações de identidade e elegibilidade para jogadores nigerianos com um rastro auditável.

Como integrar com o Didit

Você 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 é executado via API, e não através 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 de validation por campo para direcionar sua lógica de aprovação / revisão / rejeição.

Cada conta Didit inclui 500 verificações gratuitas por mês, para que você 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?

Ela valida os dados enviados contra o BVN e retorna um resultado de correspondência normalizado, para que você saiba se a conta bancária existe na fonte autoritativa e quais campos corresponderam.

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

Você não é cobrado. O faturamento se aplica apenas a resultados conclusivos — tempo de inatividade da fonte, campos ausentes e rejeições pré-fonte são gratuitos.

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

A validação do banco de dados geralmente retorna em alguns segundos, por isso 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.

Pronto para começar?

Valide sua primeira conta bancária na Nigéria hoje.

• 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 de banco de dados: Preços e cobertura de validação de banco de dados
• Comece a construir: Crie uma conta Didit gratuita — 500 verificações por mês, grátis.