ملی ای‌پی‌آی

چرا تطبیق نام و شماره حساب «خیر» می‌دهد؟

«خیر» یعنی با این سه ورودی بانک، شماره حساب و نام تطابقی پیدا نشد؛ پیش از نتیجه‌گیری خطا، بانک، قالب شماره، نوشتار نام و نوع حساب را بررسی کنید.

پاسخ «خیر» در تطبیق نام و شماره حساب یعنی سرویس با این سه ورودی بانک، شماره حساب و نام، تطابقی پیدا نکرده؛ نه بیشتر. این با «حساب مال شخص دیگری است» یکی نیست، و اگر آن را یکی بگیرید، به مشتری درست‌کار شک می‌کنید.

سرویس تطبیق شماره حساب و نام فقط یک چیز برمی‌گرداند: matched که درست یا نادرست است. نام صاحب حساب را نشان نمی‌دهد، پس دلیل «خیر» را هم نمی‌گوید. در نتیجه تشخیص علت با شماست. این مقاله فهرست جاهایی است که باید پیش از نتیجه‌گیری ببینید.

اول: خطا، نه خیر

پیش از هر چیز، «خیر» را از «انجام نشد» جدا کنید. matched: false یعنی استعلام انجام شد و نام نخواند. اما اگر پاسخ ok: false با کد خطا بود، هنوز هیچ نتیجه‌ای نگرفته‌اید.

در عمل:

  • invalid_input یعنی ورودی ناقص بوده و هزینه‌ای کسر نشده.
  • provider_failed_retryable یا temporarily_unavailable یعنی گذرا؛ بعداً تلاش کنید و هزینه ندارد.
  • not_found پاسخ معتبری است که هزینه دارد و یعنی رکوردی پیدا نشد. معنایش «به نام دیگری است» نیست.

اگر در گزارش‌هایتان این‌ها را در ستون «ناموفق» جمع کنید، آمار «چند درصد تطبیق ندادند» بی‌معنا می‌شود. سه ستون جدا بگذارید: تطبیق داد، نداد، انجام نشد.

دوم: بانک و قالب شماره حساب

شماره حساب بدون بانک معنای یکتا ندارد، و این از دلایل رایج «خیر» است. دو چیز را وارسی کنید:

بانک را از فهرست انتخاب کنید. مقدار bank باید یکی از شناسه‌های لاتین مستندات باشد، نه نام تایپ‌شده. «ملت» و «بانک ملت» و املای دیگر ممکن است به مقصد درست نرسد؛ فهرست بانک‌ها در مستندات آمده.

قالب شماره حساب را دست نزنید. شماره حساب بعضی بانک‌ها خط تیره یا اسلش دارد و آن را همان‌طور که بانک چاپ کرده بفرستید. ما جداکننده‌ها را برنمی‌داریم، چون شماره بدون آن ممکن است برای بعضی بانک‌ها شماره دیگری شود. اگر کاربرتان آن را بی‌فاصله و بی‌خط تایپ می‌کند، دقیقاً از همین‌جا خطای ظاهراً بی‌دلیل می‌آید.

یک آزمون ساده: همان حساب را یک بار با قالبی که روی دفترچه یا برنامهٔ بانک نوشته شده بفرستید.

سوم: نام، جایی که بیشتر اختلاف درمی‌آید

قاعدهٔ دقیق مقایسهٔ نام با رکورد بانکی را نمی‌دانیم؛ نمی‌دانیم کاملاً سخت‌گیر است یا تحمل دارد. پس درباره آن حدس نمی‌زنیم؛ به‌جایش فهرستی از چیزهایی می‌دهیم که اگر نام شما با ثبت بانک فرق داشته باشد، معمولاً از همین‌جاها می‌آید:

  • یای و کاف عربی در برابر فارسی. دو نوشتار «علی» با دو یای متفاوت برای آدم یکی‌اند، برای رشته نه. پیش از فرستادن، ورودی را نرمال کنید.
  • ترتیب نام و نام خانوادگی. بعضی فرم‌ها اول نام خانوادگی می‌گیرند. همان ترتیبی را بفرستید که کاربر عادت دارد، و اگر خیر آمد، یک بار برعکس را هم امتحان کنید.
  • فاصله و نیم‌فاصله. «عبدالله» و «عبد الله»، «زاده» و «زاده» با نیم‌فاصله.
  • نام کامل در برابر نام مصطلح. کسی که همه او را «علی» می‌نامند ممکن است در بانک «محمدعلی» ثبت باشد.
  • نام اضافه. عنوان (دکتر، مهندس) و پسوند را حذف کنید، مگر اینکه در ثبت بانک باشد.

مهم این است که این فهرست حدس‌های قابل آزمایش‌اند. اگر همان کاربر را با دو سه نوشتار بفرستید، می‌بینید کدام مشکل دارد. فقط یادتان باشد هر استعلام پاسخ‌داده‌شده هزینه دارد، پس این آزمایش را روی چند نمونه بکنید، نه روی هر مشتری.

چهارم: حساب شرکتی

برای حساب حقوقی، نامی که مقایسه می‌شود نام شرکت است، نه نام مدیرعامل. اگر فرم شما این دو را یکی می‌گیرد، همهٔ مشتریان شرکتی «خیر» می‌گیرند. نام شرکت را از استعلام اطلاعات شرکت بخوانید و بدون «شرکت» و «سهامی خاص» هم یک بار امتحان کنید؛ این دو در پاسخ استعلام شرکت جدا آمده‌اند و بانک ممکن است هرکدام را متفاوت ثبت کرده باشد.

پنجم: خود حساب

آخرین احتمال، و یکی که از دست شما خارج است: حساب بسته شده، مسدود است یا نوع حسابی است که تطبیق را ممکن نمی‌کند. پاسخ این سرویس بین «نام نخواند» و «حساب دیگر وجود ندارد» فرق نمی‌گذارد. این را همین‌جا صریح بگوییم تا کسی از «خیر» نتیجهٔ بیشتری نگیرد.

«خیر» چه تصمیمی را پشتیبانی می‌کند

به نظر من «خیر» باید به «بازبینی» برسد، نه «رد». یک مسیر ساده:

  1. «بله»: ادامه.
  2. «خیر»: از کاربر بخواهید نام را همان‌طور که در بانک است بنویسد یا شبا بدهد.
  3. «خیر» دوباره: ارجاع به بازبینی انسانی یا درخواست مدرک.
  4. خطا: بعداً دوباره، بدون شمردن به‌عنوان «خیر».

اگر شبا دارید، راهنمای تطبیق شبا با نام راه دیگری را نشان می‌دهد که قالب شماره حساب را حذف می‌کند.

آنچه این سرویس نمی‌کند

نام صاحب حساب را نشان نمی‌دهد. شبا را برنمی‌گرداند (تبدیل حساب به شبا سرویس جداست). دلیل «خیر» را نمی‌گوید. و تقلب را تشخیص نمی‌دهد؛ فقط تطابق نام را می‌سنجد.

یک جدول برای عیب‌یابی

وقتی «خیر» دیدید، به ترتیب این را پیش ببرید:

پرسشاگر پاسخ «نه» بود
پاسخ ok: true بود و matched نادرست؟خطا بوده، خیر نبوده
بانک از فهرست انتخاب شده؟اصلاح و دوباره
شماره با قالب بانک است؟با قالب بانک امتحان کنید
نام نرمال شده؟نرمال کنید
حساب شرکتی است؟نام شرکت را بدهید

بعد از این پنج پرسش، هنوز می‌توانید سرویس تطبیق نام و حساب را با نسخه‌ای دیگر از نام امتحان کنید، ولی هر پاسخ معتبر هزینه دارد. بهتر است پیش از آن از خود کاربر بخواهید نام را دقیقاً مطابق بانک بنویسد.

تفاوت «خیر» با «شک»

یک اشتباه رایج در محصول این است که «خیر» را مستقیم به برچسب «مشکوک» وصل کنند. «خیر» یک داده است، نه حکم. کاربری که حسابش را به نام همسرش یا شرکتش دارد، یا اسمش را با املای متفاوت ثبت کرده، همان‌قدر جدی‌ست که کلاهبردار. تفاوتشان در رفتار بعدی است: درست‌کار معمولاً اصلاح می‌کند و دوباره می‌فرستد، و تلاش‌های متعدد بدون تغییر منطقی، نشانهٔ دیگری است. پس بهتر است تعداد تلاش و تغییرات بین تلاش‌ها را هم ثبت کنید، نه فقط نتیجه.

همین ثبت، پشتیبانی را هم راحت می‌کند. وقتی کاربر زنگ می‌زند و می‌گوید «چندبار امتحان کردم»، می‌توانید ببینید دقیقاً چه فرستاده شده و چه برگشته.

اگر عجله دارید

پیش از اینکه «خیر» را جدی بگیرید: مطمئن شوید خطا نبوده، بانک را از فهرست انتخاب کرده‌اید، شماره را با قالب بانک فرستاده‌اید، نام را نرمال کرده‌اید و اگر حساب شرکتی است نام شرکت را داده‌اید. بعد از آن، «خیر» هنوز یعنی «این سه ورودی تطابق نداشتند» و تصمیم نهایی با شماست.

آخرین بازبینی: تیم تحریریه ملی ای‌پی‌آی

وب‌سرویس مرتبط با این راهنما

API تطابق شماره حساب و نام

بررسی اینکه یک شماره حساب به نام فرد موردنظر است یا نه.

مشاهده مشخصات فنی و تعرفه

راهنماهای مرتبط

پرسش و تجربه کاربران

اگر این راهنما جوابتان را نداد، همین‌جا بپرسید. پرسش‌ها را تیمملی ای‌پی‌آی پاسخ می‌دهد و هر نظر پیش از انتشار بررسی می‌شود.

هنوز پرسشی ثبت نشده، اولین نفر باشید.