التحقق من صاحب الحساب البنكي في جنوب أفريقيا - API

​

التغطية

• التغطية: —
• الدولة: جنوب أفريقيا
• معرّف الخدمة: 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 النموذجي أقل من ثانيتين.
• التوفر: 99.9% لكل ربع سنة من جهة Didit؛ ويختلف توفر المصادر الخارجية بحسب الدولة ومجموعة البيانات.

​

ما الذي تؤكده نتيجة MATCH

• account_found - يحتفظ البنك بحساب بهذا الرقم. تفقد بقية العلامات معناها عندما تكون القيمة false.
• account_open - الحساب مفتوح. قد يُعثر على حساب ويكون مغلقًا.
• id_match - الحساب مملوك لحامل رقم الهوية الوطنية الذي أرسلته. وهذه هي المطابقة التي وُجدت الخدمة من أجلها.
• 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 - الحساب مملوك لحامل رقم الهوية الوطنية المرسلة، لكن حقلًا واحدًا على الأقل من الحقول الأخرى التي أرسلتها لم يتطابق (مثل لقب مكتوب بشكل مختلف في سجلات البنك، على سبيل المثال). يذكر 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 يسرد الحقل الذي يجب تصحيحه. لا تُحتسب أي رسوم.

​

متابعة القراءة

• نظرة عامة على التحقق من قواعد البيانات في جنوب أفريقيا
• نظرة عامة على التحقق من قواعد البيانات
• رموز النتائج