account_lookup. يظل رفع كشف الحساب والإيداعات الصغيرة بمثابة بدائل احتياطية بعد كلتيهما، ويمكن للشخص دائمًا المتابعة بدون بنك. للتحقق من حساب عبر الواجهة الخلفية لديك بدون جلسة، على سبيل المثال قبل صرف مدفوعات، استخدم واجهة API للتحقق من الحساب.
يؤكد التحقق البنكي ملكية الحساب بمطابقته مع هوية أثبتتها خطوة أخرى، لذا فهو لا يعد إثباتاً للهوية بحد ذاته. ضع التحقق من الهوية، أو التحقق من قواعد البيانات، أو استبياناً، أو
expected_details قبل هذه الخطوة. لا يقوم الشخص مطلقاً بكتابة اسم لغرض الفحص: تقارن Didit دائماً الاسم الذي تحققت منه الجلسة بالفعل.كيف يعمل
1
يختار الشخص دولته
في خطوة التحقق البنكي، يختار الشخص دولة من بين الدول التي توفرها الخطوة. وإذا كان فحص الحساب يأتي أولاً هناك، تفتح الخطوة نموذجاً قصيراً بتنسيق الحساب الخاص بتلك الدولة. أما إذا كان تسجيل الدخول البنكي يأتي أولاً، فيختار الشخص أدخل بيانات حسابك للوصول إلى النموذج.
2
يُدخل الشخص حسابه
على سبيل المثال رقم IBAN، أو رمز الفرز ورقم الحساب، أو رقم CLABE. يبني مسار التحقق النموذج بناءً على ما تُرجعه API لتلك الدولة، وبالتالي فإن أي دولة تضيفها Didit لاحقاً لن تتطلب أي تغيير من جانبك.
3
تتحقق Didit من التنسيق أولاً
قبل فوترة أي شيء، تتحقق Didit من كل قيمة: طولها، وحروفها، وأرقام التحقق الخاصة بها، وبالنسبة إلى رقم IBAN، التحقّق من انتمائه إلى الدولة المحددة. تُرْفَض القيمة التي تفشل في الفحص مع توضيح الحقل الذي يجب تصحيحه. يقوم الشخص بتصحيحه في مكانه، ولا تُستَهلك أي محاولة.
4
يتحقق البنك من الاسم المسجل في الحساب
تُجري Didit فحصاً واحداً مقابل الاسم الذي تحققت منه الجلسة. وأي شيء آخر يُرسله العميل يجري تجاهله.
5
تتخذ الخطوة القرار
تتحول الإجابة إلى نتيجة ملكية، وتحولها إجراءات الخطوة إلى القرار النهائي تماماً كما تفعل في تسجيل الدخول البنكي.
أين يتوفر الفحص
التغطية تكون بحسب الدولة. يعمل الفحص حالياً في الإنتاج في نيجيريا، وغانا، وكينيا. تقوم Didit بتفعيله دولة تلو الأخرى بمجرد توفر مسار محدد السعر فيها؛ والدولة التي لا يتوفر فيها مسار لا تقدم هذا الفحص، وتوضح أسعار التحقق البنكي دائماً القائمة الحالية. تتم إضافة الدول بمرور الوقت، وتقرأ الخطوة القائمة الحالية دائماً، لذا لن تحتاج أبداً إلى تعديل التكامل لديك عند إضافة دولة ما. داخل الدولة المشمولة بالتغطية، تحدد طرق الخطوة ما إذا كان الشخص سيراها:- ترتيب الخطوة. يحدد
bank_method_orderالطرق التي توفرها كل دولة وأيها تأتي أولاً. يبدأ الإعداد الافتراضي،["open_banking", "account_lookup"]، بتسجيل الدخول البنكي ويقدم فحص الحساب كخيار احتياطي له. - ترتيب الدولة الخاص. يتجاوز المعامل
methodsفي دولة معينة ضمنbank_countriesترتيب الخطوة هناك، على سبيل المثال["account_lookup"]لفحص الحساب فقط، أو["account_lookup", "open_banking"]للبدء به. - تعطل البنك. في الحالات التي توفر فيها الدولة فحص الحساب، فإنه يعمل أيضاً كبديل احتياطي للبنك الذي يشهد تسجيل الدخول البنكي فيه تدهوراً في الأداء أو تعطلاً: تنتقل الخطوة إلى نموذج الحساب قبل طلب أي موافقة، ما دامت لا تزال لديه عمليات فحص حساب متاحة.
- يعمل الفحص عبر مسارات Didit الخاصة. الخطوة التي تعمل عبر موفّر السوق الخاص بك (
provider_key) لا توفره إلا عند تفعيلfallback_to_native. - حسابات الشركات. في جلسة التحقق من الشركات (KYB)، يقارن الفحص حساب الشركة مع الشركة التي تم التحقق منها، في الدول التي تتحقق فيها Didit من حسابات الشركات.
ما يدخله الشخص
هذه هي تنسيقات الحساب التي يفهمها النموذج. وهي ليست قائمة بالتغطية: إذ يعتمد تشغيل الفحص في دولة ما على توفره فيها، وتُظهر الخطوة دائماً الحقول الدقيقة الخاصة بتلك الدولة.
في بعض الدول، يطلب النموذج أيضاً رقم التسجيل: بالنسبة لحسابات الشركات، وفي دول قليلة لجميع الحسابات.
تُزال المسافات والشرطات والنقاط وتُحوّل الحروف إلى أحرف كبيرة قبل فحص القيمة، حتى يتمكن الشخص من إدخال الحساب بالطريقة التي يطبعه بها بنكه.
تفعيل الميزة
تُقدّم الخطوة الجديدة خيار التحقق من الحساب افتراضياً، كبديل احتياطي لتسجيل الدخول البنكي. للبدء به، أو لتقديمه منفرداً، ضعaccount_lookup أولاً في الترتيب:
النتائج
عمليات الفحص التي تُرجع إجابة
تُفوتر كل عملية من هذه العمليات مرة واحدة وتستهلك إحدى محاولات التحقق من الحساب المتاحة للشخص (bank_account_check_max_attempts). حتى تكتمل الخطوة، يمكن للشخص المحاولة مرة أخرى باستخدام حساب آخر طالما بقيت لديه محاولات. تظهر النتيجة في ownership.result، باستثناء الحساب غير الموجود، الذي يظهر في connection.reason_code.
مع تعطيل
bank_account_check_accept_close_match، يتحول كلا التطابقين المتقاربين إلى no_match بدلاً من ذلك، مع رمز السبب OWNER_NAME_MISMATCH: لا يُطلب من الشخص أبداً تأكيد الاسم، ويفصل bank_no_match_action في القرار. ويحتفظ تسجيل الدخول البنكي بتطابقاته المتقاربة في كلتا الحالتين.
بمجرد أن يستهلك الشخص كل محاولات التحقق من الحساب، وكل محاولات تسجيل الدخول البنكي في الحالات التي تُقدّم فيها الدولة تسجيل الدخول البنكي أيضاً، دون اتصال ناجح، تظل الخطوة مفتوحة طالما أنها لا تزال تُقدّم له خيار تحميل كشف الحساب مع بقاء محاولات متاحة: راجع تحميل كشف الحساب. وعند عدم بقاء أي وسيلة، تنتهي الخطوة بالحالة التي يحددها bank_attempts_exhausted_action (DECLINE افتراضياً)، ما لم تكن محاولة سابقة قد توصلت بالفعل إلى حكم نهائي، مثل عدم تطابق الاسم. ويبقى ذلك الحكم سارياً حينها.
النتائج التي لا تُفوتر أبداً
لا تستهلك أي من هذه الحالات أي محاولة فحص. وتظهر كل منها فيconnection.reason_code.
في القرار
يُدرج قرار الجلسة الخطوة ضمنbank_verifications[]. بمجرد تقييم الحساب، تكون قيمة method هي account_lookup. طالما لم يتم تقييم أي حساب، تكون قيمة method وownership هي null، ويوضح connection.reason_code السبب، على سبيل المثال ACCOUNT_NOT_FOUND أو PROVIDER_UNAVAILABLE أو REFERENCE_IDENTITY_MISSING.
لا يتم اختيار أي بنك للفحص، لذا تكون قيم connection.institution_id وconnection.institution_name وconnection.oauth هي null، وتكون قيمة connection.institution_country هي الدولة التي اختارها الشخص. لا يعود لدى Didit أي وصول إلى الحساب بمجرد اكتمال الخطوة، لذا فإن الفحص الذي انتهى بتطابق يظهر كـ connection.status: revoked مع reason_code: VERIFICATION_COMPLETED. وتبقى النتيجة نفسها مسجلة في الجلسة.
لا يقرأ فحص الحساب أي أرصدة أو معاملات أو دخل. عندما تطلب الخطوة ذلك، تسردها financial_data.not_collected؛ راجع البيانات المالية تتطلب تسجيل الدخول البنكي.
method لتمييز فحص الحساب عن تسجيل الدخول البنكي: فهو الحقل الوحيد المخصص لذلك.
في قواعد سير العمل والتقارير
- الفروع وقواعد الحالة: تكون قيمة
bank.methodهيaccount_lookup(التحقق من الحساب في أداة إنشاء القواعد)، ويمكن أن تكون قيمةbank.reason_codeهيACCOUNT_NOT_FOUND. - تقرير الجلسة بتنسيق PDF: يُظهر صف طريقة التحقق القيمة التحقق من الحساب.
الأسعار
تُحتسب كل عملية فحص تُرجع إجابة كرسوم تحقق بنكي واحدة: فالتطابق، والتطابق القريب، وعدم التطابق، والحساب الذي تعذر التحقق منه، والحساب الذي لم يُعثر عليه، كلها عمليات تخضع للفوترة. أما القيمة المرفوضة قبل الفحص، والفحص غير المتاح، والجلسة التي لا تحتوي على اسم تم التحقق منه للمقارنة، فلا تخضع للفوترة أبداً. يُحدد السعر لكل دولة: راجع أسعار التحقق البنكي. يُعد فحص الحساب طريقة مدفوعة بذاتها، وليس خياراً بديلاً على الإطلاق: لذلك لا يعملbank_fallback_used_action معه. بعد إجراء فحص خاضع للفوترة، يتم تضمين الإيداعات الصغيرة ورفع كشف الحساب دون أي تكلفة إضافية في الجلسة نفسها، إذا كانت الخطوة تُفعّلهما وتوفرهما الدولة.
اختباره في البيئة التجريبية
في تطبيق البيئة التجريبية، يعمل الفحص عبر خدمة محاكاة ولا تتم فوترة أي شيء. تتيح البيئة التجريبية كلتا الطريقتين في كل دولة، بالترتيب الذي تحدده الخطوة: بالترتيب الافتراضي، اختر أدخل بيانات حسابك لتشغيل الفحص، أو اضبطbank_method_order على ["account_lookup", "open_banking"] للبدء به.
تحدد آخر أربعة أحرف من الحساب الذي يكتبه الشخص (رقم IBAN، أو رقم الحساب بدلاً من ذلك) الإجابة. أي نهاية أخرى تتطابق مع الاسم الذي تم التحقق منه.
تسجل البيئة التجريبية كل فحص تمت الإجابة عليه كاستخدام دون أي تكلفة، حتى تتمكن من معرفة الفحوصات التي ستتم فوترتها في جلسة حية.
يحتوي كل من IBAN وCLABE وCBU على أرقام تحقق، لذا لا يمكنك ببساطة تغيير آخر أربعة أحرف منها. استخدم هذه القيم، التي تجتاز كل عمليات فحص التنسيق:
- ألمانيا (IBAN)
- المملكة المتحدة
- الولايات المتحدة
- المكسيك (CLABE)
- الأرجنتين (CBU)
- الهند