التحقق من الهوية السكنية في إندونيسيا عبر واجهة برمجة التطبيقات (AR-1)

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

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

• ما الذي تتحقق منه — تتحقق خدمة التحقق من بطاقة الهوية السكنية الإندونيسية من صحة بيانات العنوان والإقامة مقابل مصادر البيانات السكنية والاستهلاكية الموثوقة.
• ماذا تستقبل — 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.

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

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

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