Sudafrica: verifica del titolare del conto bancario API

​

Copertura

• Copertura: –
• Paese: Sudafrica
• ID servizio: zaf_bank_account_holder
• Dominio dei dati: Finanziario
• Categoria: Bancario

​

Input

• Input obbligatori: national_id, bank_account_number, bank_name
• Input facoltativi: account_type, first_name, last_name, initials, email, phone_number, vendor_data
• Consenso: Obbligatorio
• Disponibilità nel workflow: Disponibile nel workflow con mappatura dei campi
• Copertura: –
• Prezzo: $0.40 per query riuscita

​

Parametri del body

​

Regole di input e note sulla validazione

• account_type deve essere uno dei tipi di conto AVS sudafricani: current, savings, transmission, subscriptionShare, notKnown. La corrispondenza non distingue tra maiuscole e minuscole. Ometti il campo se non conosci il tipo di conto: Didit invia allora notKnown e il controllo incrociato del tipo di conto viene riportato come non confermato, invece di far fallire la richiesta.

​

Come effettuare la chiamata

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"

Ogni chiamata riuscita restituisce HTTP 200. Il campo outcome_code indica cosa è realmente accaduto, distinguendo ad esempio una vera mancata corrispondenza biometrica (BIOMETRIC_NO_MATCH) da un selfie che non è stato possibile leggere (BIOMETRIC_IMAGE_UNUSABLE). Lo status mostrato è lo stato predefinito della funzionalità; le azioni configurate per Partial Match / No Match possono sostituirlo.

{
  "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"
      }
    }
  ]
}

​

Dati restituiti

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

​

Prezzi e SLA

• Prezzo per chiamata: $0.40 USD.
• Fatturazione: per query riuscita. Non ti viene addebitato nulla quando il registro non è raggiungibile, quando mancano campi obbligatori o quando la richiesta viene respinta prima di raggiungere la fonte.
• Latenza: p95 tipico < 2 s.
• Disponibilità: 99.9% per trimestre dal lato di Didit; la disponibilità della fonte a valle varia in base al paese e al dataset.

​

Cosa conferma un MATCH

• account_found: la banca possiede un conto con questo numero. Tutto il resto non ha significato quando questo valore è false.
• account_open: il conto è aperto. Un conto può essere trovato ma chiuso.
• id_match: il conto è intestato al titolare dell’identificativo nazionale che hai inviato. È il controllo per cui esiste il servizio.
• initials_match, surname_match: initials e last_name inviati corrispondono al titolare del conto registrato.
• account_type_match: account_type inviato corrisponde al tipo reale del conto.
• email_match, phone_match: email e phone_number inviati corrispondono ai recapiti che la banca possiede.
• accepts_debits, accepts_credits: il conto può ricevere ordini di addebito diretto e accredito.
• account_number_length_valid: il numero di conto ha la lunghezza prevista dalla banca.

• MATCH: il conto esiste e ogni campo inviato corrisponde, incluso id_match.
• PARTIAL_MATCH: il conto è intestato al titolare dell’identificativo nazionale inviato, ma almeno un altro campo inviato non corrisponde (ad esempio un cognome scritto diversamente nei registri della banca). outcome_detail indica i campi che non hanno superato il controllo.
• NO_MATCH: la banca non possiede alcun conto con questo numero, oppure il conto esiste ma appartiene a un’altra persona. Entrambe sono risposte conclusive sulla persona.

​

Valori accettati per bank_name e account_type

​

Distinguere un conto inesistente da una fonte non disponibile

• Il conto non esiste: 200 OK, match_type: "no_match", outcome_code: "NO_MATCH", source_data.account_found: false. È una risposta reale della banca. Viene fatturata e si applica la tua azione per il caso di mancata corrispondenza.
• La fonte non ha risposto: 502 Bad Gateway con validation_errors[].code = empty_provider_response e retryable: true. Non è stato accertato nulla sulla persona, non viene addebitato nulla e la richiesta può essere ripetuta in sicurezza.
• La fonte ha rifiutato di eseguire la query: 400 Bad Request con validation_errors[].code = provider_rejected_input e retryable: false. La fonte non ha mai effettuato la ricerca, perché non avrebbe accettato ciò che le è stato inviato. Correggi i dati: ripetere la richiesta con gli stessi valori non può riuscire. Non viene addebitato nulla.
• La fonte ha risposto e ha rifiutato il tuo input: 502 Bad Gateway con validation_errors[].code = provider_invalid_input (ad esempio un numero di conto che non supera il controllo di formato della banca). Ripetere la richiesta non ha senso finché l’input non viene corretto; non viene addebitato nulla.
• La richiesta non ha mai lasciato Didit: 400 Bad Request, con l’elenco del campo da correggere. Non viene addebitato nulla.

​

Continua a leggere

• Panoramica della Validazione su database per il Sudafrica
• Panoramica della Validazione su database
• Codici di esito