مستندات فنی «تبدیل حساب به شبا»

اندپوینت و دسترسی تبدیل حساب به شبا

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

Scope: facility:cc-deposit-iban:get

Grant type: client_credentials

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

معرفی تبدیل حساب به شبا

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

ورودی و خروجی تبدیل حساب به شبا

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

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

فیلدهای مهم پاسخ: شماره حساب، وضعیت حساب: - 01: بسته - 02: فعال - 03: مسدود با واریز - 04: مسدود بدون واریز - 05: راکد - 06: خطا - 07: خطای شبا - 08: فاقد حساب، نام بانک، شماره شبا، صاحبان حساب.

جزئیات نوع داده، الزامی بودن و نمونه 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