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