Verificació del titular del compte bancari a Sud-àfrica

​

Cobertura

• Cobertura: —
• País: Sud-àfrica
• ID del servei: zaf_bank_account_holder
• Domini de dades: Financera
• Categoria: Banca

​

Entrades

• Entrades obligatòries: national_id, bank_account_number, bank_name
• Entrades opcionals: account_type, first_name, last_name, initials, email, phone_number, vendor_data
• Consentiment: Obligatori
• Disponibilitat al flux de treball: Disponible en un flux de treball amb mapatge de camps
• Cobertura: —
• Preu: $0.40 per consulta satisfactòria

​

Paràmetres del cos

​

Regles d’entrada i notes de validació

• account_type ha de ser un dels tipus de compte AVS de Sud-àfrica: current, savings, transmission, subscriptionShare, notKnown. La comparació no distingeix entre majúscules i minúscules. Omet el camp si no saps el tipus de compte: Didit aleshores envia notKnown i la verificació creuada del tipus de compte s’informa com a no confirmada, en lloc de fer fallar la sol·licitud.

​

Com fer la crida

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"

Cada crida satisfactòria retorna HTTP 200. El camp outcome_code t’indica què ha passat realment, i distingeix, per exemple, una discrepància biomètrica real (BIOMETRIC_NO_MATCH) d’una selfie que no s’ha pogut llegir (BIOMETRIC_IMAGE_UNUSABLE). L’status que es mostra és l’estat per defecte de la funcionalitat; les teves accions de coincidència parcial / sense coincidència configurades el poden substituir.

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

​

Dades retornades

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

​

Preus i SLA

• Preu per crida: $0.40 USD.
• Facturació: per consulta satisfactòria. No se’t cobrarà quan el registre sigui inaccessible, quan falti algun camp obligatori o quan la sol·licitud es rebutgi abans d’arribar a la font.
• Latència: p95 típic < 2 s.
• Disponibilitat: 99.9% per trimestre per part de Didit; la disponibilitat de la font externa varia segons el país i el conjunt de dades.

​

Què confirma una COINCIDÈNCIA

• account_found: el banc té un compte amb aquest número. Tota la resta no té sentit quan és false.
• account_open: el compte està obert. Un compte pot existir però estar tancat.
• id_match: el compte està associat a l’identificador nacional que has enviat. Aquesta és la comprovació per a la qual existeix el servei.
• initials_match, surname_match: les initials i el last_name enviats coincideixen amb el titular registrat.
• account_type_match: el account_type enviat coincideix amb el tipus real del compte.
• email_match, phone_match: el email i el phone_number enviats coincideixen amb les dades de contacte que té el banc.
• accepts_debits, accepts_credits: el compte pot rebre ordres de dèbit i abonaments.
• account_number_length_valid: el número de compte té la longitud que espera el banc.

• MATCH: el compte existeix i tots els camps que has enviat coincideixen, inclòs id_match.
• PARTIAL_MATCH: el compte està associat a l’identificador nacional enviat, però com a mínim un altre camp que has enviat no coincideix (per exemple, un cognom escrit de manera diferent als registres del banc). outcome_detail indica els camps que han fallat.
• NO_MATCH: o bé el banc no té cap compte amb aquest número, o bé el compte existeix però pertany a una altra persona. Les dues són respostes concloents sobre la persona.

​

Valors acceptats de bank_name i account_type

​

Distingir un compte inexistent d’una font no disponible

• El compte no existeix: 200 OK, match_type: "no_match", outcome_code: "NO_MATCH", source_data.account_found: false. És una resposta real del banc. Es factura i s’aplica la teva acció per a les no coincidències.
• La font no va respondre: 502 Bad Gateway amb validation_errors[].code = empty_provider_response i retryable: true. No s’ha establert res sobre la persona, no es factura res i la sol·licitud es pot reintentar sense risc.
• La font es va negar a executar la consulta: 400 Bad Request amb validation_errors[].code = provider_rejected_input i retryable: false. La font mai no va fer la cerca, perquè no acceptava el que se li havia enviat. Corregeix les dades; reintentar els mateixos valors no pot tenir èxit. No es factura res.
• La font va respondre i va rebutjar la teva entrada: 502 Bad Gateway amb validation_errors[].code = provider_invalid_input (per exemple, un número de compte que no supera la validació de format del propi banc). Reintentar no té sentit fins que no es corregeixi l’entrada; no es factura res.
• La sol·licitud no va sortir de Didit: 400 Bad Request, que indica el camp a corregir. No es factura res.

​

Continua llegint

• Visió general de la validació de bases de dades de Sud-àfrica
• Visió general de la validació de bases de dades
• Codis de resultat