الانتقال إلى المحتوى الرئيسي
POST
يتحقق من بيانات الإدخال مقابل بيانات رأس الائتمان المستمدة من مكتب ائتمان في كندا، ويُرجع بيانات كافية لاستيفاء متطلبات FINTRAC. يلزم تقديم طلب من وكالة. لا يمكن حاليًا تضمين هذه الخدمة في Sequence Package. يوفّر Didit هذه الخدمة عبر POST /v3/database-validation/ لتتمكن من التحقق من البيانات المُرسلة مقابل المصدر الموثوق، والحصول على نتائج مطابقة موحّدة.

التغطية

  • التغطية: ~ 85%
  • الدولة: كندا
  • معرّف الخدمة: can_credit_bureau_fintrac
  • نطاق البيانات: مالي
  • الفئة: مكتب الائتمان

المدخلات

  • الحقول المطلوبة: first_name، last_name، address.street_1، address.postal_code، date_of_birth
  • الحقول الاختيارية: address.street_2، address.city، address.region، vendor_data
  • الموافقة: مطلوبة
  • توفر في سير العمل: متاح في سير العمل
  • التغطية: ~ 85%
  • السعر: $4.84 لكل استعلام ناجح

معاملات الجسم

string
افتراضي:"CAN"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: CAN
string
افتراضي:"can_credit_bureau_fintrac"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. يؤدي تثبيت الخدمة إلى قصر الطلب على قاعدة البيانات المحددة هذه تحديدًا.مثال: can_credit_bureau_fintrac
موافقة صريحة من المستخدم النهائي على هذه الخدمة.مثال: true
string
افتراضي:"John"
مطلوب
الاسم الأول المراد التحقق منه.مثال: John
string
افتراضي:"Doe"
مطلوب
اسم العائلة المراد التحقق منه.مثال: Doe
object
مطلوب
كائن عنوان سكني منظم. استخدم street_1 وstreet_2 وcity وregion وpostal_code وcountry. ما زالت سلسلة العنوان القديمة الكاملة مقبولة، لكن لا يُنصح بها.مثال: {"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}
string
افتراضي:"1990-01-01"
مطلوب
تاريخ الميلاد بصيغة YYYY-MM-DD.مثال: 1990-01-01
string
افتراضي:"user-1234"
مرجعك الثابت لهذا الشخص، مثل معرّف المستخدم الداخلي لديك. يستخدمه Didit لربط الفحوصات المستقلة بالمستخدم النهائي نفسه وتقليل الضوضاء في اكتشاف التكرار.مثال: user-1234

قواعد الإدخال وملاحظات التحقق

  • بالنسبة إلى خدمات العناوين، أرسل حقول العنوان المنظمة بدلًا من سلسلة address واحدة متى أمكن ذلك.
  • address.street_1 هو عنوان الشارع، ويشمل رقم المبنى ونوع الشارع.
  • address.street_2 هو الشقة أو الوحدة أو المبنى أو الطابق أو أي سطر إضافي للعنوان. أرسله فقط عند توفره لديك.
  • address.city هو المدينة أو الضاحية أو المنطقة أو الحي.
  • address.region هو الولاية أو المقاطعة أو الإقليم أو البلدة.
  • address.postal_code هو الرمز البريدي.
  • تتطلب خدمات قواعد البيانات القائمة على العنوان ما لا يقل عن عنوان الشارع والرمز البريدي؛ ولا تُحتسب الطلبات التي تُرفض قبل البحث في المصدر.

كيفية الاستدعاء

البيانات المُعادة

تعتمد الحقول الدقيقة المعروضة في source_data على ما يعيده السجل. يوثّق المثال المُنشأ لـ can_credit_bureau_fintrac حاليًا هذا الشكل الموحّد:
  • address
  • date_of_birth
  • first_name
  • last_name

الأسعار واتفاقيات مستوى الخدمة (SLA)

لا تُفرض رسوم على استعلامات Canada Credit Bureau (FINTRAC) إلا عندما تتلقى Didit نتيجة حاسمة من مصدر التحقق.
  • السعر لكل استدعاء: $4.84 USD.
  • الفوترة: لكل استعلام ناجح. لا تُفرض عليك رسوم عندما يتعذّر الوصول إلى السجل، أو عند غياب الحقول المطلوبة، أو عند رفض الطلب قبل وصوله إلى المصدر.
  • زمن الاستجابة: المئين 95 (p95) المعتاد أقل من ثانيتين.
  • التوفر: 99.9% في الربع الواحد من جهة Didit؛ ويختلف توفر المصدر التابع بحسب الدولة ومجموعة البيانات.

متابعة القراءة

آخر تعديل في ٧ نوفمبر ٢٠٢٦