اندپوینت و دسترسی تبدیل کارت به شبا ورژن پنج
این صفحه مستندات فنی فراخوانی POST /facility/v5/clients/{clientId}/cardToIban است.
Scope: facility:card-to-iban-v5:post
Grant type: client_credentials
دسته‌بندی OpenAPI: استعلام و تبدیل بانکی. شناسه عملیات: facilityCardToIbanV5.
معرفی تبدیل کارت به شبا ورژن پنج
سرویس «تبدیل کارت به شبا» ورژن ۵ (IBAN) در دسته استعلام و تبدیل داده بانکی (شبا، کارت، حساب). ورودی‌ها و خروجی در مشخصات فنی همین صفحه آمده است. با رویکرد Client Credential قابل فراخوانی است. برای ساخت کلاینت و گرفتن توکن، راهنمای شروع را ببینید.
ورودی و خروجی تبدیل کارت به شبا ورژن پنج
ورودی‌های اصلی: شناسه کلاینت، شماره کارت.
پارامترهای اختیاری متداول: کد پیگیری.
فیلدهای مهم پاسخ: شماره شبا، نام بانک، شماره حساب، شماره کارت، صاحبان حساب، کد بانک.
جزئیات نوع داده، الزامی بودن و نمونه JSON در مشخصات Elements همین صفحه آمده است.
کاربرد فنی تبدیل کارت به شبا ورژن پنج
سرویس «تبدیل کارت به شبا» ورژن ۵ (IBAN) در دسته استعلام و تبدیل داده بانکی (شبا، کارت، حساب). ورودی‌ها و خروجی در مشخصات فنی همین صفحه آمده است. با رویکرد Client Credential قابل فراخوانی است. برای ساخت کلاینت و گرفتن توکن، راهنمای شروع را ببینید.
پس از دریافت توکن مناسب (مطابق Grant type)، درخواست را به مسیر بالا بفرستید و پاسخ را بر اساس اسکیمای اعلام‌شده پردازش کنید. راهنمای گرفتن توکن در راهنمای شروع آمده است.
در صورت خطای احراز هویت یا Scope ناکافی، ابتدا اعتبار توکن و سطح دسترسی کلاینت را بررسی کنید؛ سپس پارامترهای الزامی مسیر و بدنه را با اسکیمای همین صفحه تطبیق دهید.
برای توضیح کسب‌وکاری، موارد استفاده و پیش‌نیازها به صفحه سرویس «تبدیل کارت به شبا ورژن پنج» مراجعه کنید.
عملیات مرتبط با تبدیل کارت به شبا ورژن پنج
- تبدیل کارت به شبا —
GET /facility/v2/clients/{clientId}/cardToIban - تبدیل شماره کارت به شماره حساب —
GET /facility/v2/clients/{clientId}/cardToDeposit