Pular para o conteúdo principal
POST
Verifica os dados informados na base do setor bancário nigeriano. Exige uma selfie: a foto de cadastro associada ao BVN é comparada facialmente à selfie, e o registro só é retornado quando ambas pertencem à mesma pessoa. A Didit disponibiliza este serviço por meio de POST /v3/database-validation/, para que você verifique os dados enviados na fonte oficial e receba resultados de correspondência normalizados.

Cobertura

  • Cobertura: ~ 100%
  • País: Nigéria
  • ID do serviço: nga_bank_verification_number
  • Domínio de dados: Financeiro
  • Categoria: Bancário

Entradas

  • Entradas obrigatórias: bvn, selfie
  • Entradas opcionais: first_name, last_name, date_of_birth, vendor_data
  • Consentimento: Não obrigatório
  • Disponibilidade no fluxo: Disponível no fluxo de verificação (workflow) com mapeamento de campos
  • Cobertura: ~ 100%
  • Preço: $0.35 por consulta bem-sucedida
Em um fluxo, o bvn não vem impresso em um documento de identidade, então nenhuma etapa o gera por conta própria. Colete-o a partir de uma resposta a um Questionário, de um campo de extração do Document AI ou de um valor que você envia ao criar a sessão, e mapeie-o na etapa de Validação de banco de dados. Enquanto ele não for mapeado, o editor de fluxos mostra este serviço desativado e indica a entrada que falta; durante a execução, uma entrada ausente faz com que a verificação seja ignorada antes de qualquer consulta, então você nunca é cobrado por uma consulta a uma base de dados que não pôde ser realizada.

Parâmetros do corpo

string
padrão:"NGA"
obrigatório
Código de país ISO 3166-1 alpha-3 deste serviço de banco de dados.Exemplo: NGA
string
padrão:"nga_bank_verification_number"
obrigatório
Array que contém este ID de serviço. Fixar o serviço mantém a requisição restrita exatamente a esta base de dados.Exemplo: nga_bank_verification_number
string
padrão:"11111111111"
obrigatório
Bank Verification Number (número de verificação bancária).Exemplo: 11111111111
file
obrigatório
Arquivo de imagem da selfie para enviar para validação em um banco de dados biométricos. Formatos aceitos: JPEG, PNG ou WebP.Exemplo: @./selfie.jpg
string
Primeiro nome a validar.Exemplo: John
string
Sobrenome a validar.Exemplo: Doe
string
padrão:"1990-01-01"
Data de nascimento no formato YYYY-MM-DD.Exemplo: 1990-01-01
string
padrão:"user-1234"
Sua referência estável de usuário para esta pessoa, como o seu ID interno de usuário. A Didit a usa para vincular verificações avulsas ao mesmo usuário final e reduzir o ruído na detecção de duplicados.Exemplo: user-1234

Regras de entrada e notas de validação

  • Bank Verification Number nigeriano (exatamente 11 dígitos)
  • O bvn deve conter apenas dígitos; remova espaços, hifens e pontuação antes de enviar a requisição.
  • O bvn deve ter exatamente 11 caracteres.

Como chamar

Dados retornados

Os campos exatos expostos em source_data dependem do que o cadastro retorna. O exemplo gerado para nga_bank_verification_number documenta atualmente este formato normalizado:
  • date_of_birth
  • first_name
  • last_name

Preços e SLAs

As consultas de Bank Verification Number (BVN) da Nigéria são cobradas somente quando a Didit recebe um resultado conclusivo da fonte de validação.
  • Preço por chamada: $0.35 USD.
  • Faturamento: por consulta bem-sucedida. Você não é cobrado quando o registro de empresas está inacessível, quando faltam campos obrigatórios ou quando a requisição é rejeitada antes de chegar à fonte.
  • Latência: p95 típico < 2 s.
  • Disponibilidade: 99.9% por trimestre no lado da Didit; a disponibilidade da fonte externa varia conforme o país e o conjunto de dados.

Continue a leitura

Última modificação em 1 de novembro de 2026