سرویس «تطبیق شماره شبا و کد ملی» در دسته احراز هویت و شناخت مشتری فینوتک، یک شماره شبا و یک کد ملی میگیرد و مشخص میکند آن حساب به همان شخص تعلق دارد یا نه. با این پاسخ میتوانید پیش از واریز یا ثبت حساب، جلوی نشستن پول روی حساب شخص ثالث را بگیرید.
تطبیق شماره شبا و کد ملی چه مشکلی را حل میکند؟
وقتی کاربر در فرم ثبتنام یا تسویه، شماره شبا وارد میکند، هیچ چیزی در خود شبا نشان نمیدهد که این حساب متعلق به همان کسی است که پرونده به نامش تشکیل شده. راه سنتی، درخواست تصویر برگه حساب یا کارت بانکی از مشتری است؛ مدرکی که خواندن و تایید آن زمانبر است، بهراحتی قابل دستکاری است و اغلب کاربر را در میانه فرآیند رها میکند. در عمل، بسیاری از کسبوکارها این کنترل را تا زمان بروز اختلاف به تعویق میاندازند.
این سرویس همان کنترل را به یک فراخوانی پیش از پرداخت تبدیل میکند: شبا و کد ملی را میفرستید و نتیجه تطابق را میگیرید. خروجی یک وضعیت روشن است و میتوانید آن را به قاعدههای کسبوکاری خود وصل کنید؛ مثلا تایید خودکار حساب در پروفایل کاربر، جلوگیری از ثبت شبای متعلق به شخص دیگر، یا متوقف کردن دستور پرداخت پیش از ارسال.
کاربردهای تطبیق شماره شبا و کد ملی
- ثبت شماره شبا در پروفایل کاربر — کاربر شبا را وارد میکند و تعلق حساب به کد ملی او همان لحظه تایید یا رد میشود، بدون آپلود مدرک.
- تسویه با فروشندگان و همکاران — پیش از دوره تسویه، شبای اعلامی هر فروشنده با کد ملی ثبتشده در قرارداد تطبیق داده میشود.
- بازپرداخت و استرداد وجه به مشتری — پیش از عودت وجه، تعلق حساب مقصد به همان مشتری بررسی میشود تا وجه به حساب شخص ثالث نرود.
- پرداخت خسارت، پاداش و حقالزحمه — در پرداختهای گروهی، فهرست شباهای مقصد پیش از صدور دسته پرداخت کنترل میشود.
- کنترل انطباق و مبارزه با پولشویی — قاعده «پرداخت فقط به حساب متعلق به خود مشتری» بهصورت خودکار و قابل ممیزی اجرا میشود.
مزایای تطبیق شماره شبا و کد ملی
- ورودی کم، تصمیم روشن — تنها با دو ورودی شبا و کد ملی، وضعیت تطابق مشخص میشود و فرم شما کوتاه میماند.
- حذف مدرک بانکی از جریان ثبتنام — نیازی به تصویر کارت، برگه حساب یا تاییدیه شعبه نیست.
- پیشگیری بهجای رسیدگی پس از خطا — تصمیم پیش از صدور دستور پرداخت گرفته میشود، نه بعد از بازگشت یا اعتراض.
- قابل استفاده در لحظه و بهصورت دستهای — هم در فرم زنده کاربر و هم در بازبینی فهرست حسابهای ذخیرهشده کاربرد دارد.
- بدون نیاز به رضایت پیامکی — فراخوانی با توکن Client Credential انجام میشود و مرحلهای به تجربه کاربری اضافه نمیکند.
چه چیزی از تطبیق شماره شبا و کد ملی دریافت میکنید؟
جزئیات ورودی، خروجی و نمونه پاسخ در مستندات فنی آمده است.
جریان کار تطبیق شماره شبا و کد ملی
- ۱. ساخت کلاینت و گرفتن توکن — با اسکوپ
kyc:iban-owner-verification:getتوکن Client Credential بگیرید. - ۲. گرفتن شبا از کاربر — شماره شبا را در فرم دریافت و پیش از ارسال، قالب آن را در سمت کلاینت بررسی کنید.
- ۳. فراخوانی تطبیق — شبا و کد ملی را همراه یک شناسه پیگیری یکتا ارسال کنید.
- ۴. اعمال قاعده کسبوکاری — در صورت عدم تطابق، ثبت حساب یا واریز را متوقف و به کاربر پیام مشخص نمایش دهید.
- ۵. ذخیره نتیجه — وضعیت تطابق و شناسه پیگیری را برای ممیزی و رسیدگی به اختلافهای بعدی نگه دارید.
نحوه شروع تطبیق شماره شبا و کد ملی
این سرویس با رویکرد Client Credential (بدون رضایت پیامکی) فراخوانی میشود. اسکوپ مورد نیاز: kyc:iban-owner-verification:get. ابتدا کلاینت بسازید و توکن بگیرید: راهنمای شروع. سپس از مستندات فنی برای پیادهسازی استفاده کنید.
محدودیتها و نکات تطبیق شماره شبا و کد ملی
- شبا را بدون فاصله و کاراکتر اضافه بفرستید؛ حروف
IRبخشی از شماره شبا است. - خروجی این سرویس فقط وضعیت تطابق است؛ اگر به نام بانک، شماره حساب یا وضعیت حساب نیاز دارید، باید از سرویس استعلام شبا استفاده کنید.
- برای حسابهای مشترک، عدم تطابق را با احتیاط تفسیر کنید و در صورت نیاز مسیر بررسی دستی را باز بگذارید.
- اگر میخواهید تاریخ تولد هم در تطبیق دخیل شود، نسخه سهورودی این سرویس را به کار ببرید.
- نتیجه تصویری از همان لحظه است؛ اگر کاربر بعدا شبای خود را تغییر داد، تطبیق باید دوباره اجرا شود.
- برای هر فراخوانی شناسه پیگیری یکتا بفرستید و کد ملی و شبا را فقط برای همان هدف کسبوکاری نگه دارید.
سوالات متداول تطبیق شماره شبا و کد ملی
تطبیق شماره شبا و کد ملی چیست؟
سرویسی است که با دریافت شماره شبا و کد ملی، تطبیق یا عدم تطبیق آنها را برمیگرداند تا پیش از واریز یا ثبت حساب، تعلق حساب به خود مشتری تایید شود.
تفاوت این سرویس با تطبیق شماره شبا، کد ملی و تاریخ تولد چیست؟
این سرویس فقط شبا و کد ملی را میگیرد؛ تطبیق شماره شبا، کد ملی و تاریخ تولد تاریخ تولد را هم در تطبیق دخالت میدهد و نتیجه آن سهحالته است.
آیا این سرویس نام صاحب حساب را برمیگرداند؟
خیر؛ خروجی آن وضعیت تطابق است. برای دریافت نام بانک، شماره حساب، وضعیت حساب و صاحبان حساب از استعلام شبا و صاحبان حساب استفاده کنید.
اگر نتیجه عدم تطابق باشد چه باید کرد؟
ثبت حساب یا واریز را متوقف کنید، از کاربر بخواهید شبای متعلق به خودش را وارد کند و در صورت نیاز مسیر بررسی دستی را برای موارد خاص مانند حساب مشترک در نظر بگیرید.
مستندات فنی این سرویس کجاست؟
صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.
چه نوع احراز هویتی لازم است؟
Grant type: client_credentials. جزئیات در راهنمای توکن.
آیا رضایت پیامکی کاربر لازم است؟
خیر. این سرویس با Client Credential و بدون رضایت پیامکی قابل فراخوانی است.
مستندات فنی تطبیق شماره شبا و کد ملی
مشاهده مستندات فنی «تطبیق شماره شبا و کد ملی» — endpoint، پارامترها، نمونه درخواست و پاسخ.