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