التحقق من الهوية الوطنية الإندونيسية عبر API

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

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

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

ماذا يتحقق التحقق من بطاقة الهوية السكنية الإندونيسية

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

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

لماذا يهم

يؤكد التحقق من العنوان مقابل بيانات موثوقة أن مقدم الطلب يعيش بالفعل حيث يدعي — وهي إشارة أساسية لمكافحة الاحتيال والامتثال.

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

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

تعرض Didit هذه الخدمة من خلال نقطة نهاية التحقق من قاعدة البيانات الموحدة. وهي طلب POST واحد — لا يتطلب SDK.

نقطة النهاية

POST /v3/database-validation/

معلمات الطلب

المعلمة	النوع	مطلوب	الوصف
issuing_state	سلسلة	نعم	رمز الدولة ISO 3166-1 alpha-3. استخدم IDN.
services	سلسلة	نعم	معرف الخدمة. استخدم idn_residential_identity_card.
full_name	سلسلة	نعم	الاسم الكامل.
date_of_birth	سلسلة	نعم	تاريخ الميلاد.
national_id	سلسلة	نعم	الرقم الوطني.
address	سلسلة	نعم	العنوان.
address	سلسلة	لا	العنوان (تحقق متقاطع اختياري).
gender	سلسلة	لا	الجنس (تحقق متقاطع اختياري).

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

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=IDN" \
  -F "services=idn_residential_identity_card" \
  -F "full_name=John Doe" \
  -F "date_of_birth=1990-01-01" \
  -F "national_id=1111111" \
  -F "address=123 Sample Street, Sample City, 10001"

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

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "IDN",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "idn_residential_identity_card",
      "service_name": "Indonesia Residential Identity Card",
      "source_data": {
        "address": "123 Sample Street",
        "address_match_score": "1.000",
        "city": "Sample City",
        "date_of_birth": "1990-01-01",
        "identification_number": "SAMPLE-ID-12345",
        "postal_code": "10001",
        "state": "Sample State",
        "street": "sample_value"
      },
      "validation": {
        "address": "full_match",
        "date_of_birth": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

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

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

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

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

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

يمكنك تشغيل التحقق من بطاقة الهوية السكنية الإندونيسية بطريقتين:

1. سير عمل بدون كود. في Didit Business Console، افتح Workflow Builder، أضف وحدة Database Validation، حدد Indonesia → Indonesia Residential Identity Card Verification، وقم بتنشيطها. يتم توجيه المستخدمين المطابقين تلقائيًا — لا يتطلب أي هندسة.
2. واجهة برمجة تطبيقات مباشرة. استدعاء نقطة النهاية /v3/database-validation/ الموضحة أعلاه مع services=idn_residential_identity_card. اقرأ match_type وكتلة validation لكل حقل لتشغيل منطق الموافقة / المراجعة / الرفض الخاص بك.

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

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

ماذا يؤكد التحقق من بطاقة الهوية السكنية الإندونيسية؟

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

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

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

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

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

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

لا. التحقق هو طلب HTTPS POST واحد إلى نقطة نهاية واحدة. يمكنك أيضًا ربطه بسير عمل بدون كود في Business Console.

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

تحقق من صحة عنوانك الأول وبياناتك السكنية في إندونيسيا اليوم.

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