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