Afrique du Sud - vérification du titulaire de compte

​

Couverture

• Couverture : —
• Pays : Afrique du Sud
• Identifiant du service : zaf_bank_account_holder
• Domaine de données : Financier
• Catégorie : Banque

​

Entrées

• Entrées obligatoires : national_id, bank_account_number, bank_name
• Entrées facultatives : account_type, first_name, last_name, initials, email, phone_number, vendor_data
• Consentement : Obligatoire
• Disponibilité dans le workflow : Disponible dans un workflow avec mappage des champs
• Couverture : —
• Prix : $0.40 par requête réussie

​

Paramètres du corps de requête

​

Règles de saisie et notes de validation

• account_type doit être l’une des valeurs de type de compte AVS sud-africaines : current, savings, transmission, subscriptionShare, notKnown. La correspondance ne tient pas compte de la casse. Omettez le champ lorsque vous ne connaissez pas le type de compte : Didit envoie alors notKnown, et le contrôle croisé du type de compte est signalé comme non confirmé au lieu de faire échouer la requête.

​

Comment l’appeler

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"

Chaque appel réussi renvoie un code HTTP 200. Le champ outcome_code indique ce qui s’est réellement passé, en distinguant par exemple une véritable non-correspondance biométrique (BIOMETRIC_NO_MATCH) d’un selfie illisible (BIOMETRIC_IMAGE_UNUSABLE). Le status affiché est le statut par défaut de la fonctionnalité ; vos actions Partial Match / No Match configurées peuvent le remplacer.

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

​

Données renvoyées

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

​

Tarifs et SLA

• Prix par appel : $0.40 USD.
• Facturation : par requête réussie. Vous n’êtes pas facturé lorsque le registre est injoignable, lorsque des champs obligatoires sont manquants, ou lorsque la requête est rejetée avant d’atteindre la source.
• Latence : p95 typique < 2 s.
• Disponibilité : 99.9 % par trimestre du côté de Didit ; la disponibilité de la source en aval varie selon le pays et le jeu de données.

​

Ce que confirme un MATCH

• account_found - la banque détient un compte portant ce numéro. Tout le reste est sans signification lorsque cette valeur est false.
• account_open - le compte est ouvert. Un compte peut être trouvé et pourtant fermé.
• id_match - le compte est associé au numéro d’identité national que vous avez soumis. C’est le contrôle pour lequel le service existe.
• initials_match, surname_match - les initials et last_name soumis correspondent au titulaire enregistré.
• account_type_match - le account_type soumis correspond au type réel du compte.
• email_match, phone_match - l’email et le phone_number soumis correspondent aux coordonnées que la banque détient.
• accepts_debits, accepts_credits - le compte peut recevoir des ordres de prélèvement et des crédits.
• account_number_length_valid - le numéro de compte a la longueur attendue par la banque.

• MATCH - le compte existe et chaque champ soumis correspond, id_match compris.
• PARTIAL_MATCH - le compte appartient au numéro d’identité national soumis, mais au moins un autre champ envoyé ne correspond pas (un nom de famille orthographié différemment dans les registres de la banque, par exemple). outcome_detail indique les champs en échec.
• NO_MATCH - soit la banque ne détient aucun compte correspondant à ce numéro, soit le compte existe mais appartient à une autre personne. Ce sont deux réponses concluantes sur la personne.

​

Valeurs acceptées pour bank_name et account_type

​

Distinguer un compte inexistant d’une source indisponible

• Le compte n’existe pas - 200 OK, match_type: "no_match", outcome_code: "NO_MATCH", source_data.account_found: false. Une vraie réponse de la banque. Facturée, et votre action en cas d’absence de correspondance s’applique.
• La source n’a pas répondu - 502 Bad Gateway avec validation_errors[].code = empty_provider_response et retryable: true. Rien n’a été établi concernant la personne, rien n’est facturé, et la requête peut être relancée sans risque.
• La source a refusé d’exécuter la requête - 400 Bad Request avec validation_errors[].code = provider_rejected_input et retryable: false. La source n’a jamais effectué la recherche, car elle n’aurait pas accepté ce qui lui a été envoyé. Corrigez les données ; réessayer avec les mêmes valeurs ne peut pas réussir. Rien n’est facturé.
• La source a répondu et rejeté votre saisie - 502 Bad Gateway avec validation_errors[].code = provider_invalid_input (par exemple un numéro de compte qui échoue au contrôle de format de la banque). Réessayer ne sert à rien tant que la saisie n’est pas corrigée ; rien n’est facturé.
• Votre requête n’a jamais quitté Didit - 400 Bad Request, indiquant le champ à corriger. Rien n’est facturé.

​

Pour aller plus loin

• Vue d’ensemble de la validation en base de données pour l’Afrique du Sud
• Vue d’ensemble de la validation en base de données
• Codes de résultat