اندپوینت و دسترسی استعلام پیامکی بدهی مالیاتی
این صفحه مستندات فنی فراخوانی GET /kyc/v2/clients/{clientId}/sms/taxInquiry است.
Scope: kyc:sms-tax-Inquiry:get
Grant type: authorization_sms
دسته‌بندی OpenAPI: استعلام و تبدیل بانکی. شناسه عملیات: kycSmsTaxInquiryGet.
معرفی استعلام پیامکی بدهی مالیاتی
سرویس «استعلام پیامکی بدهی مالیاتی» (KYC / SMS/OTP) در دسته استعلام و تبدیل داده بانکی (شبا، کارت، حساب)؛ نسخه پیامکی برای فراخوانی با تایید کاربر. ورودی‌ها و خروجی در مشخصات فنی همین صفحه آمده است. فراخوانی با تایید پیامکی کاربر (authorization_sms) انجام می‌شود. برای ساخت کلاینت و گرفتن توکن، راهنمای شروع را ببینید.
ورودی و خروجی استعلام پیامکی بدهی مالیاتی
ورودی‌های اصلی: شناسه کلاینت، کد ملی.
پارامترهای اختیاری متداول: کد پیگیری.
فیلدهای مهم پاسخ: کدملی، آرایه‌ای از بدهی‌های مالیاتی شامل:.
جزئیات نوع داده، الزامی بودن و نمونه JSON در مشخصات Elements همین صفحه آمده است.
کاربرد فنی استعلام پیامکی بدهی مالیاتی
سرویس «استعلام پیامکی بدهی مالیاتی» (KYC / SMS/OTP) در دسته استعلام و تبدیل داده بانکی (شبا، کارت، حساب)؛ نسخه پیامکی برای فراخوانی با تایید کاربر. ورودی‌ها و خروجی در مشخصات فنی همین صفحه آمده است. فراخوانی با تایید پیامکی کاربر (authorizationsms) انجام می‌شود. برای ساخت…
پس از دریافت توکن مناسب (مطابق 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 - تبدیل کارت به شبا ورژن پنج —
POST /facility/v5/clients/{clientId}/cardToIban