مستندات فنی «استعلام پیامکی بدهی مالیاتی»

اندپوینت و دسترسی استعلام پیامکی بدهی مالیاتی

این صفحه مستندات فنی فراخوانی 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}/nationalCardImage
• دریافت تصویر کارت ملی — GET /facility/v2/clients/{clientId}/nationalCardImage
• استعلام کد ملی (Client Credential) — GET /facility/v2/clients/{clientId}/users/{nid}/cc/nidInquiry
• استعلام کد ملی (Client Credential) — GET /facility/v2/clients/{clientId}/users/{nid}/cc/nidInquiry
• استعلام کد ملی (Authorization SMS) — GET /facility/v2/clients/{clientId}/users/{nid}/sms/nidInquiry