API التحقق من رقم التعريف المصرفي النيجيري (BVN) (AR-1)

يتطلب ضم المستخدمين في نيجيريا التأكد من أنهم هم من يدعون أنهم. تتحقق هذه الخدمة من بيانات الإدخال مقابل قاعدة بيانات الصناعة المصرفية النيجيرية. يثبت المستند أو التفاصيل المكتوبة أن البيانات موجودة فقط — وليس أنها حقيقية أو تخص الشخص الذي أمامك. يغلق التحقق من رقم التعريف المصرفي النيجيري (BVN) هذه الفجوة عن طريق التحقق من البيانات مقابل BVN. يشرح هذا الدليل ما تفعله عملية التحقق، والتفاصيل الفنية الدقيقة، وكيفية دمجها في دقائق.

النقاط الرئيسية:

• ما الذي تتحقق منه — التحقق من رقم التعريف المصرفي النيجيري (BVN) يتحقق من صحة الحساب المصرفي مقابل BVN.
• ما الذي تحصل عليه في المقابل — match_type مُوحّد بالإضافة إلى نتائج على مستوى الحقل يمكنك توجيهها مباشرة إلى منطق الموافقة / المراجعة / الرفض.
• لماذا هو مهم — تأكيد هوية صاحب الحساب يمنع الاحتيال في المدفوعات ويدعم عمليات ضم الدفع والرواتب.
• كيفية استخدامه — طلب POST واحد إلى نقطة نهاية التحقق من قاعدة البيانات الخاصة بـ Didit. 0.80 دولار لكل استعلام حاسم، النتائج في ثوانٍ.

ما الذي يتحقق منه التحقق من رقم التعريف المصرفي النيجيري (BVN)

يتحقق من بيانات الإدخال مقابل قاعدة بيانات الصناعة المصرفية النيجيرية. تكشف Didit عن ذلك من خلال نقطة نهاية واحدة حتى تتمكن من التحقق من البيانات المقدمة مقابل شبكة البنوك / ملكية الحساب الوطنية وتلقي نتيجة منظمة وموحدة — وليس تفريغًا خامًا للسجل عليك تحليله بنفسك.

تعيد الاستجابة النهائية source_data المطابقة وكتلة validation على مستوى الحقل، بحيث تحصل محرك المخاطر الخاص بك على حكم واضح وقابل للقراءة آليًا.

لماذا هو مهم

يمنع تأكيد هوية صاحب الحساب الاحتيال في المدفوعات ويدعم عمليات ضم الدفع والرواتب.

بالنسبة للشركات المنظمة في نيجيريا — شركات التكنولوجيا المالية، ومنصات العملات المشفرة، والمقرضين، والأسواق، ومشغلي الألعاب — ينتج التحقق من مصدر موثوق سجلًا قابلاً للدفاع عنه والتدقيق يثبت أن الهوية قد تم تأكيدها من المصدر، وليس مجرد التقاطها من نموذج أو صورة.

التفاصيل الفنية

تكشف Didit عن هذه الخدمة من خلال نقطة نهاية التحقق من قاعدة البيانات الموحدة. إنها عملية POST واحدة — لا يلزم وجود SDK.

نقطة النهاية

POST /v3/database-validation/

معلمات الطلب

المعلمة	النوع	مطلوب	الوصف
issuing_state	سلسلة	نعم	رمز البلد ISO 3166-1 alpha-3. استخدم NGA.
services	سلسلة	نعم	معرف الخدمة. استخدم nga_bank_verification_number.
first_name	سلسلة	نعم	الاسم الأول.
last_name	سلسلة	نعم	اسم العائلة.
bvn	سلسلة	نعم	رقم التعريف المصرفي (BVN).
date_of_birth	سلسلة	لا	تاريخ الميلاد (تحقق اختياري).

مثال على الطلب

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=NGA" \
  -F "services=nga_bank_verification_number" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "bvn=11111111111"

مثال على الاستجابة (مطابقة حاسمة)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "NGA",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "nga_bank_verification_number",
      "service_name": "Nigeria Bank Verification Number (BVN)",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "last_name": "Doe"
      },
      "validation": {
        "full_name": "full_match"
      }
    }
  ]
}

الأداء والفوترة

• الاستجابة: عادة بضع ثوانٍ.
• التكلفة: 0.80 دولار لكل استعلام حاسم. يتم فوترتك فقط على النتائج الحاسمة — لا توجد رسوم على تعطل المصدر، أو الحقول المفقودة، أو الرفض قبل المصدر.
• الموثوقية: يعمل على بنية Didit التحتية بهدف تحقيق وقت تشغيل بنسبة 99.9% ربع سنويًا.

حالات الاستخدام

• التكنولوجيا المالية والبنوك الرقمية — تأكيد وجود صاحب حساب حقيقي وقابل للتحقق قبل فتح محفظة أو تقديم ائتمان في نيجيريا.
• العملات المشفرة و Web3 — تلبية متطلبات ضم VASP بإثبات هوية من مصدر موثوق.
• الإقراض — تقليل الاحتيال في الهوية الاصطناعية والاحتيال من الطرف الأول ببيانات تم التحقق منها من المصدر.
• الأسواق ومنصات العمل الحر — التحقق من المستخدمين مقابل البيانات الموثوقة، وليس مجرد نموذج يتم الإبلاغ عنه ذاتيًا.
• الألعاب عبر الإنترنت — تلبية فحوصات الهوية والأهلية للاعبين في نيجيريا بسجل تدقيق.

كيفية التكامل مع Didit

يمكنك تشغيل التحقق من رقم التعريف المصرفي النيجيري (BVN) بطريقتين:

1. API مباشر فقط. تعمل هذه الخدمة من خلال API بدلاً من منشئ سير العمل بدون رمز.
2. API مباشر. قم باستدعاء نقطة النهاية /v3/database-validation/ الموضحة أعلاه باستخدام services=nga_bank_verification_number. اقرأ match_type وكتلة validation على مستوى الحقل لدفع منطق الموافقة / المراجعة / الرفض الخاص بك.

يتضمن كل حساب Didit 500 عملية تحقق مجانية شهريًا، حتى تتمكن من اختبار التدفق الكامل من البداية إلى النهاية قبل أن تدفع مقابل استعلام واحد.

الأسئلة المتكررة

ماذا يؤكد التحقق من رقم التعريف المصرفي النيجيري (BVN)؟

يتحقق من صحة البيانات المقدمة مقابل BVN ويعيد نتيجة مطابقة موحدة، حتى تعرف ما إذا كان الحساب المصرفي موجودًا في المصدر الموثوق وأي الحقول تطابقت.

ماذا يحدث إذا كان المصدر غير متاح مؤقتًا؟

لا يتم محاسبتك. يتم تطبيق الفوترة فقط على النتائج الحاسمة — تعطل المصدر، والحقول المفقودة، والرفض قبل المصدر مجانية.

ما مدى سرعة التحقق؟

عادة ما يتم إرجاع التحقق من قاعدة البيانات في بضع ثوانٍ، لذلك فهو يناسب سير عمل الانضمام في الوقت الفعلي.

هل أحتاج إلى SDK؟

لا. التحقق هو طلب HTTPS POST واحد إلى نقطة نهاية واحدة.

هل أنت مستعد للبدء؟

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

• اقرأ مرجع API: التحقق من رقم التعريف المصرفي النيجيري (BVN)
• شاهد جميع عمليات التحقق من قاعدة البيانات: تسعير وتغطية التحقق من قاعدة البيانات
• ابدأ البناء: أنشئ حساب Didit مجانيًا — 500 عملية تحقق شهريًا، مجانًا.