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