واجهة برمجة تطبيقات التحقق من مكتب الشركات النيوزيلندي (AR)

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

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

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

ما الذي يتحقق منه مكتب الشركات النيوزيلندي

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

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

لماذا يهم

يربط التحقق من الهوية الضريبية مقدم الطلب بهوية مالية قابلة للتحقق، مما يقلل من الاحتيال بالهوية الاصطناعية والاحتيال من الطرف الأول.

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

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

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

نقطة النهاية

POST /v3/database-validation/

معلمات الطلب

المعلمة	النوع	مطلوب	الوصف
issuing_state	سلسلة	نعم	رمز البلد ISO 3166-1 alpha-3. استخدم NZL.
services	سلسلة	نعم	معرف الخدمة. استخدم nzl_zealand_companies_office.
first_name	سلسلة	نعم	الاسم الأول.
last_name	سلسلة	نعم	الاسم الأخير.
address	سلسلة	نعم	العنوان.

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

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=NZL" \
  -F "services=nzl_zealand_companies_office" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "address=123 Sample Street, Sample City, 10001"

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

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "NZL",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "nzl_zealand_companies_office",
      "service_name": "New Zealand Companies Office",
      "source_data": {
        "address": "123 Sample Street",
        "first_name": "John",
        "last_name": "Doe"
      },
      "validation": {
        "address": "full_match",
        "full_name": "full_match"
      }
    }
  ]
}

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

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

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

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

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

يمكنك تشغيل التحقق من مكتب الشركات النيوزيلندي بطريقتين:

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

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

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

ما الذي يؤكده التحقق من مكتب الشركات النيوزيلندي؟

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

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

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

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

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

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

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

هل أنت جاهز للبدء؟

تحقق من أول هوية ضريبية نيوزيلندية اليوم.

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