واجهة برمجة تطبيقات التحقق من رقم التعريف المصرفي النيجيري (BVN)

يتطلب ضم المستخدمين في نيجيريا التأكد من أنهم من يدعون أنهم. تتحقق هذه الخدمة من بيانات الإدخال مقابل قاعدة بيانات الصناعة المصرفية النيجيرية. يثبت المستند أو التفاصيل المكتوبة أن البيانات موجودة فقط - وليس أنها أصلية أو تخص الشخص الذي أمامك. يغلق التحقق من رقم التعريف المصرفي النيجيري (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 بإثبات هوية من مصدر موثوق.
• الإقراض — تقليل الاحتيال في الهوية الاصطناعية والاحتيال من الطرف الأول باستخدام بيانات تم التحقق منها من المصدر.
• الأسواق ومنصات العمل الحر — التحقق من المستخدمين مقابل البيانات الموثوقة، وليس مجرد نموذج يتم الإبلاغ عنه ذاتيًا.
• iGaming — تلبية فحوصات الهوية والأهلية للاعبين النيجيريين بسجل قابل للتدقيق.

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

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

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

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

الأسئلة الشائعة

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

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

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

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

ما مدى سرعة الفحص؟

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

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

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

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

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

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