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

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

ورودی شبا و نام و نام خانوادگی است و پاسخ در data یک مقدار منطقی به نام matched دارد. خود نام صاحب حساب برنمی‌گردد.

چرا یک بار در زمان ثبت کافی است

شبای یک حساب تا وقتی حساب باز است عوض نمی‌شود. برای همین بهترین لحظهٔ استعلام، هنگام ثبت شبا در پروفایل است و نه موقع هر واریز. کنترل را به ثبت یا ویرایش شبا ببندید و در خود پایگاه داده‌تان ثبت کنید که چه زمانی و با چه نامی تأیید شده است. اگر کاربر شبا را عوض کرد، همان لحظه دوباره بپرسید.

شبا را در فرم خودتان یکدست کنید

شبا پیش از ارسال به حروف بزرگ تبدیل می‌شود و فاصله‌هایش برداشته می‌شود. باید با IR شروع شود و رقم کنترلی درست داشته باشد. شبای نامعتبر پاسخ invalid_input می‌گیرد و هزینه ندارد، پس اگر ساختار را سمت خودتان بسنجید، فراخوان بی‌جهت نمی‌زنید.

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

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

پاسخ منفی خطا نیست

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