Verificação de titular de conta bancária na África do Sul

​

Cobertura

• Cobertura: —
• País: África do Sul
• ID do serviço: zaf_bank_account_holder
• Domínio de dados: Financeiro
• Categoria: Serviços bancários

​

Entradas

• Entradas obrigatórias: national_id, bank_account_number, bank_name
• Entradas opcionais: account_type, first_name, last_name, initials, email, phone_number, vendor_data
• Consentimento: Obrigatório
• Disponibilidade no fluxo de verificação (workflow): Disponível no fluxo com mapeamento de campos
• Cobertura: —
• Preço: $0.40 por consulta bem-sucedida

​

Parâmetros do corpo

​

Regras de entrada e observações de validação

• account_type deve ser um dos tipos de conta do AVS sul-africano: current, savings, transmission, subscriptionShare, notKnown. A correspondência não diferencia maiúsculas de minúsculas. Omita o campo quando você não souber o tipo de conta: nesse caso, a Didit envia notKnown e a verificação cruzada do tipo de conta é informada como não confirmada, em vez de fazer a requisição falhar.

​

Como fazer a chamada

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_bank_account_holder" \
  -F "vendor_data=user-1234" \
  -F "consent=true" \
  -F "national_id=8708150847085" \
  -F "bank_account_number=1234567890" \
  -F "bank_name=ABSA" \
  -F "account_type=current" \
  -F "last_name=Doe" \
  -F "initials=JD"

Toda chamada bem-sucedida retorna HTTP 200. O campo outcome_code informa o que de fato aconteceu, distinguindo, por exemplo, uma divergência biométrica real (BIOMETRIC_NO_MATCH) de uma selfie que não pôde ser lida (BIOMETRIC_IMAGE_UNUSABLE). O status exibido é o status padrão do recurso; as ações de Partial Match / No Match que você configurou podem substituí-lo.

{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_bank_account_holder",
      "service_name": "South Africa - Bank Account Holder Verification",
      "source_data": {
        "accepts_credits": true,
        "accepts_debits": true,
        "account_found": true,
        "account_number_length_valid": true,
        "account_open": true,
        "account_type_match": true,
        "id_match": true,
        "identification_number": "SAMPLE-ID-12345",
        "initials_match": true,
        "surname_match": true
      },
      "validation": {
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

{
  "request_id": "req_01H…",
  "status": "In Review",
  "issuing_state": "ZAF",
  "match_type": "partial_match",
  "validations": [
    {
      "outcome_code": "PARTIAL_MATCH",
      "service_id": "zaf_bank_account_holder",
      "service_name": "South Africa - Bank Account Holder Verification",
      "source_data": {
        "accepts_credits": true,
        "accepts_debits": true,
        "account_found": true,
        "account_number_length_valid": false,
        "account_open": true,
        "account_type_match": true,
        "id_match": true,
        "identification_number": "SAMPLE-ID-12345",
        "initials_match": true,
        "surname_match": false
      },
      "validation": {
        "full_name": "partial_match",
        "identification_number": "full_match"
      }
    }
  ]
}

{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "ZAF",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "zaf_bank_account_holder",
      "service_name": "South Africa - Bank Account Holder Verification",
      "source_data": {
        "accepts_credits": false,
        "accepts_debits": false,
        "account_found": false,
        "account_number_length_valid": false,
        "account_open": false,
        "account_type_match": false,
        "id_match": false,
        "identification_number": "NO_MATCH",
        "initials_match": false,
        "surname_match": false
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}

​

Dados retornados

• accepts_credits
• accepts_debits
• account_found
• account_number_length_valid
• account_open
• account_type_match
• id_match
• identification_number
• initials_match
• surname_match

​

Preços e SLAs

• Preço por chamada: $0.40 USD.
• Faturamento: por consulta bem-sucedida. Você não é cobrado quando o registro 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 do lado da Didit; a disponibilidade da fonte externa varia conforme o país e o conjunto de dados.

​

O que um MATCH confirma

• account_found - o banco tem uma conta com esse número. Todos os demais indicadores perdem o sentido quando este é false.
• account_open - a conta está aberta. Uma conta pode ser encontrada, mas estar encerrada.
• id_match - a conta pertence ao documento de identidade nacional que você enviou. É para esta verificação que o serviço existe.
• initials_match, surname_match - os valores de initials e last_name enviados correspondem ao titular da conta registrado.
• account_type_match - o account_type enviado corresponde ao tipo real da conta.
• email_match, phone_match - os valores de email e phone_number enviados correspondem aos dados de contato que o banco tem.
• accepts_debits, accepts_credits - a conta pode receber débitos automáticos e créditos.
• account_number_length_valid - o número da conta tem o comprimento que o banco espera.

• MATCH - a conta existe e todos os campos que você enviou corresponderam, incluindo id_match.
• PARTIAL_MATCH - a conta pertence ao documento de identidade nacional enviado, mas pelo menos um dos outros campos que você enviou não correspondeu (por exemplo, um sobrenome grafado de forma diferente nos registros do banco). outcome_detail indica os campos que falharam.
• NO_MATCH - o banco não tem essa conta, ou a conta existe, mas pertence a outra pessoa. As duas são respostas conclusivas sobre a pessoa.

​

Valores aceitos de bank_name e account_type

​

Como distinguir uma conta inexistente de uma fonte indisponível

• A conta não existe - 200 OK, match_type: "no_match", outcome_code: "NO_MATCH", source_data.account_found: false. Uma resposta real do banco. É cobrada, e a sua ação para ausência de correspondência é aplicada.
• A fonte não respondeu - 502 Bad Gateway com validation_errors[].code = empty_provider_response e retryable: true. Nada foi apurado sobre a pessoa, nada é cobrado e é seguro tentar a requisição novamente.
• A fonte se recusou a executar a consulta - 400 Bad Request com validation_errors[].code = provider_rejected_input e retryable: false. A fonte nem chegou a pesquisar, porque não aceitou o que recebeu. Corrija os dados; tentar novamente com os mesmos valores não terá sucesso. Nada é cobrado.
• A fonte respondeu e rejeitou os seus dados - 502 Bad Gateway com validation_errors[].code = provider_invalid_input (por exemplo, um número de conta que não passa na verificação de formato do próprio banco). Não adianta tentar novamente até que os dados sejam corrigidos; nada é cobrado.
• A sua requisição nunca saiu da Didit - 400 Bad Request, indicando o campo a corrigir. Nada é cobrado.

​

Continue lendo

• Visão geral da Validação de banco de dados da África do Sul
• Visão geral da Validação de banco de dados
• Códigos de resultado