مستندات فنی «استعلام شبا و صاحبان حساب»

اندپوینت و دسترسی استعلام شبا و صاحبان حساب

این صفحه مستندات فنی فراخوانی GET /oak/v2/clients/{clientId}/ibanInquiry است.

Scope: oak:iban-inquiry:get

Grant type: client_credentials

دسته‌بندی OpenAPI: استعلام و تبدیل بانکی. شناسه عملیات: oakIbanInquiryGet.

معرفی استعلام شبا و صاحبان حساب

با شماره شبا (IBAN) نام بانک، شماره سپرده و صاحبان حساب برمی‌گردد. سرویس استعلامی و تبدیلی فینوتک با رویکرد Client Credential.

ورودی و خروجی استعلام شبا و صاحبان حساب

ورودی‌های اصلی: شناسه کلاینت، شماره شبا.

پارامترهای اختیاری متداول: کد پیگیری.

فیلدهای مهم پاسخ: شماره شبا، نام بانک، شماره حساب، وضعیت حساب، شرح حساب، توضیحات حساب، صاحبان حساب، کد بانک.

جزئیات نوع داده، الزامی بودن و نمونه JSON در مشخصات Elements همین صفحه آمده است.

کاربرد فنی استعلام شبا و صاحبان حساب

با شماره شبا (IBAN) نام بانک، شماره سپرده و صاحبان حساب برمی‌گردد. سرویس استعلامی و تبدیلی فینوتک با رویکرد Client Credential.

پس از دریافت توکن مناسب (مطابق Grant type)، درخواست را به مسیر بالا بفرستید و پاسخ را بر اساس اسکیمای اعلام‌شده پردازش کنید. راهنمای گرفتن توکن در راهنمای شروع آمده است.

در صورت خطای احراز هویت یا Scope ناکافی، ابتدا اعتبار توکن و سطح دسترسی کلاینت را بررسی کنید؛ سپس پارامترهای الزامی مسیر و بدنه را با اسکیمای همین صفحه تطبیق دهید.

برای توضیح کسب‌وکاری، موارد استفاده و پیش‌نیازها به صفحه سرویس «استعلام شبا و صاحبان حساب» مراجعه کنید.

عملیات مرتبط با استعلام شبا و صاحبان حساب

• تبدیل شماره کارت به شماره حساب — GET /facility/v2/clients/{clientId}/cardToDeposit
• تبدیل شماره کارت به شماره حساب — GET /facility/v2/clients/{clientId}/cardToDeposit
• تبدیل کارت به شبا — GET /facility/v2/clients/{clientId}/cardToIban
• تبدیل کارت به شبا — GET /facility/v2/clients/{clientId}/cardToIban
• استعلام حساب — GET /facility/v2/clients/{clientId}/depositInfo