API و وب سرویس تطابق کارت و نام
شماره کارت و نام اعلام‌شده را کنار هم می‌سنجد تا پیش از ثبت کارت یا بازگشت وجه معلوم شود کارت به همان آدم تعلق دارد یا نه.
این سرویس چه می‌کند
فرض کنید فروشگاهی برای بازگشت وجه از مشتری شماره کارت میگیرد. اگر کارت مال شخص دیگری باشد، پول رفته است و پس‌گرفتنش هفته‌ها طول می‌کشد. تطابق کارت و نام همین را پیش از ثبت کارت می‌پرسد: این شماره کارت به نامی که مشتری گفته ثبت شده است؟
ورودی دو چیز است، شماره کارت شانزدهرقمی و نام و نام خانوادگی. رمز، CVV2 و تاریخ انقضا نه لازم است و نه پذیرفته میشود. سایتی که برای دیدن نام صاحب کارت از شما رمز بخواهد، به این سرویس شبیه نیست.
کارت چیزی دارد که شبا ندارد
کارت می‌تواند منقضی یا گمشده باشد و حساب پشتش هم می‌تواند غیرفعال باشد. در توضیح سرویس مرجع برای همین سه حالت پیام جدا آمده است: کارت منقضی، کارت گمشده و حساب غیرفعال. پس نتیجهٔ «نام نخواند» همیشه به معنای نام اشتباه نیست و گاهی خودِ کارت قابل‌استفاده نیست. اگر مبلغی قرار است به این کارت برود، این تفاوت را در پیام کاربر نشان بدهید.
شماره کارت را پیش از فراخوان بررسی کنید
شمارهٔ کارت پیش از رفتن به سرویس مرجع سنجیده میشود: شانزده رقم، رقم کنترلی درست، و نه شانزده رقم یکسان. فاصله و خط تیره حذف میشود، پس شمارهٔ چهارتا چهارتا هم پذیرفته است. کارتی که از این بررسی رد شود، پاسخ invalid_input میگیرد و هزینه‌ای ندارد. اگر همین رقم کنترلی را در فرم خودتان هم بگیرید، خطای تایپی هرگز به سرویس نمی‌رسد.
آنچه این سرویس نمی‌کند
موجودی، گردش حساب و شمارهٔ حساب نمی‌دهد. تضمین نمی‌کند که واریز به مقصد می‌نشیند و فقط رابطهٔ کارت و نام را می‌گوید. همچنین نام را برای شما اصلاح نمی‌کند: فاصلهٔ اضافه و ارقام فارسی یکدست میشود، ولی ی و ک عربی، ترتیب نام و نام خانوادگی و نام کوچک یا مستعار با خودتان است.
با نتیجه چه کنیم
نتیجهٔ منفی را به تقلب نسبت ندهید. کارت همسر، کارت شراکتی و نامی که یک حرفش فرق دارد همه می‌توانند نتیجهٔ منفی بدهند. راه امن‌تر این است که کاربر را به یک بار اصلاح نام یا ارائهٔ کارت دیگر هدایت کنید و فقط پس از دو بار ناکامی به بررسی دستی بروید.
کجا به کار می‌آید
- بازگشت وجه به کارت مشتری در فروشگاه اینترنتیپیش از ثبت دستور بازگشت وجه، کارتی که مشتری وارد کرده با نام صاحب حساب سفارش سنجیده میشود تا برگشت به کارت شخص دیگر رخ ندهد.
- برداشت از کیف پول در اپلیکیشن خدماتیراننده یا فروشنده هنگام ثبت کارت برای برداشت، نامش با کارت مقایسه میشود و کارت قرضی از همان ابتدا رد میشود.
- ثبت کارت قسط‌کش در خرید اقساطیکارتی که قرار است قسط از آن کسر شود باید به نام خریدار باشد؛ ناهماهنگی همان لحظهٔ ثبت‌نام دیده میشود، نه سرِ سررسید.
ورودی و خروجی
ورودی
cardNumberstringشمارهٔ کارتشانزده رقم، بی فاصله یا با فاصله.namestringنامنام و نام خانوادگی به فارسی، دست‌کم سه حرف.خروجی
namestringنام صاحب کارتقیمت و شرط پرداخت
قیمت هر فراخوان API تطابق کارت و نام ۸۰۰ تومان است.
| تعداد استعلام در ماه | قیمت هر استعلام |
|---|---|
| همهٔ فراخوان‌ها | ۸۰۰ تومان |
آخرین تغییر قیمت:
مبلغ پیش از تماس با سرویس مرجع از موجودی پنل قفل میشود و اگر پاسخی نیاید، آزاد میشود. ورودی نامعتبر، در دسترس نبودن سرویس مرجع و عبور از سقف نرخ هزینه‌ای ندارند. «رکوردی یافت نشد» یک پاسخ معتبر است و هزینه دارد.
کمترین مبلغ شارژ پنل: ۵۰۰٬۰۰۰ تومان
پرسش‌های متداول
اگر فقط شماره کارت دارم و شبا ندارم، چطور نام صاحبش را بسنجم؟
شماره کارت و نامی را که انتظار دارید همینجا بفرستید تا رابطهٔ آن دو سنجیده شود. اگر شبای کارت هم لازم است، تبدیل کارت به شبا سرویس جداگانهای است و در این فراخوان برنمیگردد.
اگر نتیجه منفی بود پیش از واریز چه کار کنم؟
شماره کارت و املای نام را دوباره با آنچه صاحب کارت گفته مقایسه کنید. اگر هنوز نخواند، از خود او بخواهید نامی را که روی برنامهٔ بانکش دیده تأیید کند یا کارت دیگری بدهد. تا آن زمان پولی نفرستید.
آیا این استعلام موجودی یا گردش حساب را هم نشان می‌دهد؟
نه. ورودی فقط شماره کارت و نام است و خروجی فقط به رابطهٔ این دو می‌پردازد. موجودی، گردش و شمارهٔ حساب در پاسخ نیست.
برای دیدن نام صاحب کارت رمز یا CVV2 لازم است؟
نه. این سرویس فقط شمارهٔ شانزدهرقمی کارت و نام را میگیرد. رمز، CVV2 و تاریخ انقضا نه خواسته میشود و نه ذخیره. اگر جایی برای همین کار این اطلاعات را خواست، از آن دوری کنید.
کارت منقضی یا گمشده چه پاسخی میگیرد؟
سرویس مرجع برای کارت منقضی، کارت گمشده و حساب غیرفعال پیام جدا دارد. در برنامهٔ خودتان نتیجه را فقط به «نام نخواند» تقلیل ندهید و برای این حالتها پیام جداگانه برای کاربر بگذارید.
نتیجهٔ منفی هم هزینه دارد؟
بله. استعلامی که به سرویس مرجع رسیده و پاسخ قطعی گرفته، چه مثبت چه منفی، صورتحساب میشود. ورودی نامعتبر، قطعی سرویس مرجع و سقف نرخ هزینه ندارند. مبلغ کسرشده در فیلد billing هر پاسخ آمده است.
حد نرخ این سرویس چقدر است؟
پیشفرض شصت فراخوان در دقیقه برای هر سرویس است. عبور از آن پاسخ ۴۲۹ با هدر Retry-After میگیرد و هزینه ندارد. اگر حجم بیشتری لازم دارید، برای بالا بردن سقف حسابتان درخواست بدهید.
دو بار فرستادن یک ورودی، دو بار هزینه دارد؟
پاسخ ورودی یکسان ممکن است از کش بیاید و فیلد source.cached این را نشان می‌دهد. مبلغ واقعاً کسرشده هر بار در billing.amountRial آمده است، پس برای تطبیق مالی نیازی به حدس نیست.