दक्षिण अफ़्रीका बैंक खाता सत्यापन API

​

कवरेज

• कवरेज: —
• देश: दक्षिण अफ़्रीका
• सेवा ID: zaf_bank_account_holder
• डेटा डोमेन: वित्तीय
• श्रेणी: बैंकिंग

​

इनपुट

• आवश्यक इनपुट: national_id, bank_account_number, bank_name
• वैकल्पिक इनपुट: account_type, first_name, last_name, initials, email, phone_number, vendor_data
• सहमति: आवश्यक
• वर्कफ़्लो में उपलब्धता: वर्कफ़्लो में फ़ील्ड मैपिंग के साथ उपलब्ध
• कवरेज: —
• कीमत: प्रति सफल क्वेरी $0.40

​

बॉडी पैरामीटर

​

इनपुट नियम और सत्यापन नोट्स

• account_type दक्षिण अफ़्रीकी AVS खाता प्रकारों में से एक होना चाहिए: current, savings, transmission, subscriptionShare, notKnown। मिलान केस-इनसेंसिटिव है। अगर आपको खाता प्रकार पता नहीं है तो यह फ़ील्ड छोड़ दें। तब Didit notKnown भेजता है और खाता-प्रकार की जाँच को अनुरोध विफल करने के बजाय “पुष्ट नहीं” के रूप में दर्ज करता है।

​

इसे कैसे कॉल करें

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"

हर सफल कॉल HTTP 200 लौटाती है। outcome_code फ़ील्ड बताता है कि वास्तव में क्या हुआ, उदाहरण के लिए असली बायोमेट्रिक मिलान न होना (BIOMETRIC_NO_MATCH) और ऐसी सेल्फ़ी जिसे पढ़ा नहीं जा सका (BIOMETRIC_IMAGE_UNUSABLE) में अंतर। दिखाया गया status डिफ़ॉल्ट सुविधा स्थिति है; आपकी कॉन्फ़िगर की गई Partial Match / No Match कार्रवाइयाँ इसे बदल सकती हैं।

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

​

लौटाया गया डेटा

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

​

मूल्य निर्धारण और SLA

• प्रति कॉल मूल्य: $0.40 USD।
• बिलिंग: प्रति सफल क्वेरी। जब रजिस्ट्री पहुँच से बाहर हो, आवश्यक फ़ील्ड गायब हों, या अनुरोध स्रोत तक पहुँचने से पहले ही अस्वीकार हो जाए, तब आपसे शुल्क नहीं लिया जाता।
• विलंबता: सामान्यतः p95 2 s से कम।
• उपलब्धता: Didit की ओर से प्रति तिमाही 99.9%। डाउनस्ट्रीम स्रोत की उपलब्धता देश और डेटासेट के अनुसार अलग होती है।

​

MATCH क्या पुष्टि करता है

• account_found: बैंक के पास इस नंबर का खाता है। यह false हो तो बाकी सब अर्थहीन है।
• account_open: खाता खुला है। खाता मिल सकता है और फिर भी बंद हो सकता है।
• id_match: खाता उसी राष्ट्रीय ID के नाम पर है जो आपने भेजी। यही वह जाँच है जिसके लिए यह सेवा बनी है।
• initials_match, surname_match: आपके भेजे initials और last_name बैंक के रिकॉर्ड में दर्ज खाताधारक से मेल खाते हैं।
• account_type_match: आपका भेजा account_type खाते के वास्तविक प्रकार से मेल खाता है।
• email_match, phone_match: आपके भेजे email और phone_number बैंक के पास मौजूद संपर्क विवरणों से मेल खाते हैं।
• accepts_debits, accepts_credits: खाता डेबिट ऑर्डर और क्रेडिट प्राप्त कर सकता है।
• account_number_length_valid: खाता नंबर उतनी लंबाई का है जितनी बैंक अपेक्षित करता है।

• MATCH: खाता मौजूद है और आपके भेजे हर फ़ील्ड का मिलान हुआ, id_match सहित।
• PARTIAL_MATCH: खाता आपके द्वारा भेजी गई राष्ट्रीय ID के धारक के नाम पर है, लेकिन आपके भेजे कम से कम एक और फ़ील्ड का मिलान नहीं हुआ (उदाहरण के लिए, बैंक के रिकॉर्ड में अलग वर्तनी वाला उपनाम)। outcome_detail उन फ़ील्ड के नाम बताता है जो मेल नहीं खाए।
• NO_MATCH: या तो बैंक के पास ऐसा कोई खाता नहीं है, या खाता है पर किसी और का है। दोनों ही व्यक्ति के बारे में निर्णायक उत्तर हैं।

​

स्वीकृत bank_name और account_type मान

​

गायब खाते और अनुपलब्ध स्रोत में अंतर

• खाता मौजूद नहीं है: 200 OK, match_type: "no_match", outcome_code: "NO_MATCH", source_data.account_found: false। यह बैंक का वास्तविक उत्तर है। बिल होता है, और आपकी नो-मैच कार्रवाई लागू होती है।
• स्रोत ने उत्तर नहीं दिया: 502 Bad Gateway, जिसमें validation_errors[].code = empty_provider_response और retryable: true है। व्यक्ति के बारे में कुछ भी स्थापित नहीं हुआ, कोई शुल्क नहीं लगता, और अनुरोध दोबारा भेजना सुरक्षित है।
• स्रोत ने क्वेरी चलाने से इनकार किया: 400 Bad Request, जिसमें validation_errors[].code = provider_rejected_input और retryable: false है। स्रोत ने खोज ही नहीं की, क्योंकि उसने भेजी गई जानकारी को स्वीकार करने से मना कर दिया। डेटा सुधारें; वही मान फिर भेजने से सफलता नहीं मिलेगी। कोई शुल्क नहीं।
• स्रोत ने उत्तर दिया और आपके इनपुट को अस्वीकार किया: 502 Bad Gateway, जिसमें validation_errors[].code = provider_invalid_input है (उदाहरण के लिए, ऐसा खाता नंबर जो बैंक की अपनी फ़ॉर्मैट जाँच में विफल हो)। इनपुट सुधरने तक दोबारा भेजने का कोई अर्थ नहीं है; कोई शुल्क नहीं।
• आपका अनुरोध Didit से बाहर नहीं गया: 400 Bad Request, जिसमें सुधारने योग्य फ़ील्ड सूचीबद्ध होते हैं। कोई शुल्क नहीं।

​

आगे पढ़ें

• दक्षिण अफ़्रीका डेटाबेस सत्यापन अवलोकन
• डेटाबेस सत्यापन अवलोकन
• परिणाम कोड