یک‌بار بابت پول بلوکه‌شده و پیگیری بانکی، یک‌بار بابت اعتمادی که از کاربر گرفته‌اید. وب‌سرویس استعلام شبای یوآیدی با دریافت شماره شبا، نام و نام خانوادگی صاحب حساب، کد ملی، شماره حساب، نام بانک و وضعیت فعال یا مسدود بودن حساب را در لحظه از شبکه بانکی برمی‌گرداند — پیش از آنکه ریالی جابه‌جا شود.
{
"responseContext": { "status": { "code": 0, "message": "SUCCESS." } },
"accountBasicInformation": { … },
"accountStatus": "…",
"owners": [ { … } ]
}
پاسخ را دیدید؟ همین ساختار را روی داده واقعی می‌خواهید؟ شماره‌تان را بگذارید، کارشناس یوآیدی دسترسی سندباکس را برایتان فعال می‌کند.
اعداد خودتان را وارد کنید. ما فقط حساب می‌کنیم. هر واریز ناموفق یعنی پول بلوکه، یک تیکت پشتیبانی، یک پیگیری بانکی و یک کاربر ناراضی.
شامل زمان پشتیبانی مالی، مکاتبه با بانک، مغایرت‌گیری، بلوکه ماندن وجه و ریسک از دست دادن کاربر.
می‌خواهید همین عدد را صفر کنید؟ شماره‌تان را بگذارید تا کارشناس یوآیدی پلن متناسب با حجم شما را همین امروز اعلام کند.
الگوریتم IBAN فقط می‌گوید ۲۴ رقم شما از نظر ریاضی معتبر است. نمی‌گوید حساب باز است، مسدود نیست، یا اصلاً متعلق به همان کسی است که ادعا می‌کند.
وب‌سرویس یوآیدی وضعیت لحظه‌ای حساب و هویت دارنده شبا را از شبکه بانکی می‌گیرد. اگر حساب مسدود بود یا نام صاحب حساب با کاربر شما نمی‌خواند، پول اصلاً حرکت نمی‌کند.
کارشناس فنی یوآیدی در یک تماس، حجم استعلام و سناریوی شما را بررسی می‌کند.
تیم فنی یوآیدی مسیر را برای شما کوتاه می‌کند: مستندات شفاف، نمونه‌کد آماده و پشتیبانی اختصاصی در تمام مراحل.
فرم اطلاعات کسب‌وکار را پر می‌کنید. کارشناس یوآیدی سناریوی شما را بررسی و ظرفیت استعلام ماهانه را برآورد می‌کند.
توکن محیط آزمایشی (سندباکس)، businessId و businessToken، به‌همراه نمونه‌کدهای آماده در اختیار تیم فنی شما قرار می‌گیرد.
سناریوها را شبیه‌سازی می‌کنید، اتصال را نهایی می‌کنید و با پشتیبانی اختصاصی یوآیدی وارد محیط عملیاتی می‌شوید.
وب‌سرویس استعلام شبا با یک فراخوانی POST، هویت دارنده حساب و وضعیت لحظه‌ای آن را در قالب استاندارد JSON به سامانه شما تحویل می‌دهد.
شماره شبای ۲۴ رقمی همراه با پیشوند IR، در بدنه درخواست. همین. نه کد ملی لازم است، نه شماره حساب، نه هیچ فیلد اضافه‌ای.
اطلاعات صاحبان حساب در آرایه‌ای با عنوان owners برگردانده می‌شود. اگر حساب یک صاحب داشته باشد، این آرایه تک‌عضوی است؛ برای حساب‌های مشترک، همه دارندگان فهرست می‌شوند.
بسیاری از تیم‌های فنی فکر می‌کنند بررسی چک‌دیجیت IBAN یعنی «شبا معتبر است». این دقیقاً جایی است که پول‌ها گم می‌شوند.
یک تابع چند خطی در بک‌اند شما تأیید می‌کند که ۲۴ رقم از نظر ریاضی درست چیده شده‌اند. همین و بس.
شبا را به شبکه بانکی می‌سپارد و وضعیت واقعی حساب به‌همراه مشخصات هویتی دارنده آن را برمی‌گرداند.
شبای واردشده توسط کاربر با فرمت استاندارد و پیشوند IR، از طریق متد امن POST به وب‌سرویس یوآیدی ارسال می‌شود.
POST /api/inquiry/iban/v2ساختار شبا بررسی و فرمت اعتبارسنجی می‌شود، سپس وضعیت حساب به‌صورت بلادرنگ از زیرساخت بانکی کشور استعلام می‌گردد.
چند مسیر بانکی پشتیباناطلاعات کامل دارنده حساب و وضعیت شبا در قالب استاندارد JSON به سامانه پذیرنده بازگردانده می‌شود.
پاسخ لحظهایصنعت خود را انتخاب کنید تا سناریوی دقیق شما را ببینید.
بررسی شماره شبا پیش از واریز درآمد یا موجودی کاربران در صرافی‌های رمزارز، بروکرها و وب‌سایت‌های فریلنسری — جایی که هر برداشت ناموفق مستقیماً به تیکت پشتیبانی تبدیل می‌شود.
برداشت‌های ناموفق و پیگیری‌های مالی به صفر میرسداعتبارسنجی شبای فروشندگان در مارکت‌پلیس‌ها پیش از تسویه‌های دوره‌ای و پرداخت مبالغ سفارش‌ها، تا هیچ دسته‌واریزی به‌خاطر یک رکورد اشتباه متوقف نشود.
تسویه دسته‌ای بدون برگشت خوردن حوالهبررسی شبای مشتری پیش از عودت وجه سفارش‌های لغو‌شده، ودیعه‌ها یا مبالغ اضافه واریز‌شده — همان‌جایی که مشتری عصبانی است و اشتباه دوم را نمی‌بخشد.
بازپرداخت درست، بار اولکنترل دقیق اطلاعات شبا در فرایندهای پرداخت تسهیلات، اعتبارسنجی و مدیریت تراکنش‌های مالی، با امکان تطبیق کد ملی دارنده حساب با پرونده متقاضی.
انطباق هویت متقاضی با حساب مقصداستعلام شبای بیمه‌گذاران و ذی‌نفعان پیش از صدور حواله‌های خسارت و غرامت، تا پرداخت به حساب مسدود یا حساب شخص ثالث انجام نشود.
حواله خسارت بدون مغایرتراستیآزمایی شبای پرسنل و پیمانکاران پیش از واریز ماهانه حقوق، پاداش و مطالبات سازمانی — به‌ویژه در سازمان‌هایی که فهرست حقوق را دسته‌ای به بانک می‌فرستند.
لیست حقوق پاک، پیش از ارسال به بانکوجه ارسال می‌شود، در حساب مسدود می‌ماند، و آزادسازی آن هفته‌ها مکاتبه بانکی می‌برد — در حالی که کاربر هر روز پیگیر است.
فیلد accountStatus پیش از هر تراکنش بررسی می‌شود. حساب غیرفعال، همان‌جا رد می‌شود و پول اصلاً حرکت نمی‌کند.
کاربر شبای فرد دیگری را وارد می‌کند — گاهی سهوی، گاهی عمدی. ساختار شبا کاملاً معتبر است و هیچ اعتبارسنجی محلی جلوی آن را نمی‌گیرد.
نام، نام خانوادگی و کد ملی صاحب حساب برمی‌گردد و می‌توانید آن را با هویت کاربر ثبت‌شده در سامانه خودتان تطبیق دهید.
یک رقم جابه‌جا، و حواله یا برگشت می‌خورد یا — بدتر — به حساب دیگری می‌نشیند. کاربر شماره را از روی کارت تایپ می‌کند و اشتباه اجتناب‌ناپذیر است.
در همان لحظه‌ی پر کردن فرم، نام صاحب حساب را به کاربر نشان می‌دهید و از او تأیید می‌گیرید. اشتباه، پیش از ثبت گرفته می‌شود.
هر واریز ناموفق یعنی یک تیکت، یک تماس، یک مکاتبه با بانک و یک ردیف مغایرت که باید سر ماه بسته شود.
حذف کامل خطاهای واریز و برگشت وجه، کاهش بار پشتیبانی مالی، و گزارش‌های دقیق از تعداد تراکنش‌ها و لاگ‌ها برای بستن حساب.
از اولین تماس تا ورود به محیط عملیاتی، یک نفر مشخص پاسخگوی تیم فنی شماست — نه یک صف تیکت.
ساختار درخواست و پاسخ، کدهای وضعیت و سناریوهای خطا مستند شده‌اند؛ پیاده‌سازی در کمتر از یک روز کاری ممکن است.
گزارش دقیق از تعداد استعلام‌ها، نرخ موفقیت و لاگ فراخوانی‌ها، برای تسویه شفاف و بستن مغایرت‌ها.
پردازش داده‌ها در محیط امن و منطبق بر پروتکل‌های استاندارد شبکه بانکی.
وب‌سرویس استعلام شبا یوآیدی از طریق متد استاندارد POST و با فرمت JSON عمل می‌کند.
POST https://json-api.uid.ir/api/inquiry/iban/v2
با ارسال شماره شبا در بدنه درخواست، اطلاعات کامل حساب در بدنه پاسخ بازگردانده می‌شود. احراز هویت کسب‌وکار از طریق businessId و businessToken انجام می‌شود که هر دو توسط یوآیدی در اختیار شما قرار می‌گیرد.
نسخه مستندات: 1.1.0
{
"requestContext": {
"apiInfo": {
"businessId": <UID_BUSINESS_ID>,
"businessToken": <UID_BUSINESS_TOKEN>
}
},
"iban": "IR123456789012345678901234"
}
{
"responseContext": {
"status": {
"code": 0,
"message": "SUCCESS.",
"details": []
},
"requestId": "",
"correlationId": ""
},
"accountBasicInformation": {
"iban": <IBAN_NUMBER>,
"accountNumber": <ACCOUNT_NUMBER>,
"bankInformation": {
"bankName": <BANK_NAME>
}
},
"accountStatus": <ACCOUNT_STATUS>,
"owners": [
{
"firstName": <FIRST_NAME>,
"lastName": <LAST_NAME>,
"nationalIdentifier": <NATIONAL_IDENTIFIER>,
"customerType": <CUSTOMER_TYPE>
}
]
}
اگر بیش از یکی را نیاز دارید، در همان مشاوره اول پلن ترکیبی با تعرفه بهتر برایتان بسته می‌شود.
دریافت شماره شبا و شماره حساب با استفاده از شماره ۱۶ رقمی کارت بانکی — وقتی کاربر فقط کارتش را در دست دارد.
مشاهده سرویس وب‌سرویس تطبیق شماره شبا با کد ملیبررسی و اعتبارسنجی تعلق شماره شبا به کد ملی ثبت‌شده کاربر (سرویس شاهکار مالی) — پاسخ صریح تطابق دارد / ندارد.
مشاهده سرویس وب‌سرویس تطبیق شماره کارت با کد ملیاحراز تطابق مالکیت شماره کارت بانکی با شماره ملی خریدار در درگاه‌های پرداخت — سپر ضد کلاهبرداری در لحظه پرداخت.
مشاهده سرویستنها کافی است شماره شبای ۲۴ رقمی همراه با پیشوند IR در بدنه درخواست API ارسال شود. هیچ فیلد اضافه‌ای لازم نیست.
نام و نام خانوادگی دارنده حساب، کد ملی، شماره حساب، نام بانک عامل و وضعیت فعال یا غیرفعال بودن حساب بانکی در خروجی ارائه می‌شود. نوع مشتری (حقیقی یا حقوقی) نیز در پاسخ وجود دارد.
خیر. درست بودن ساختار شبا فقط رعایت فرمت را تایید می‌کند؛ وب‌سرویس وضعیت لحظه‌ای، مسدود نبودن حساب و هویت صاحب آن را در شبکه بانکی استعلام می‌کند.
خیر. هزینه تنها برای استعلام‌های موفق و بازگشت رکورد معتبر از شبکه بانکی محاسبه می‌شود. استعلام‌های ناموفق یا اشتباه هزینه‌ای ندارند.
پاسخ وب‌سرویس یوآیدی به‌صورت لحظه‌ای ارسال می‌شود. برای جلوگیری از قطعی در ساعات پیک، سرویس روی زیرساخت Redundant با چند مسیر بانکی پشتیبان اجرا می‌شود.
اطلاعات صاحبان حساب در آرایه‌ای با عنوان owners برگردانده می‌شود. برای حساب‌های تک‌نفره این آرایه یک عضو دارد و برای حساب‌های مشترک، مشخصات همه دارندگان در همان آرایه قرار می‌گیرد.
پس از تکمیل فرم درخواست، کارشناس یوآیدی با شما تماس می‌گیرد و دسترسی سندباکس به‌همراه businessId و businessToken در اختیار تیم فنی شما قرار می‌گیرد. با مستندات شفاف و نمونه‌کدهای آماده، اتصال معمولاً در کمتر از یک روز کاری انجام می‌شود.
خیر. وب‌سرویس استعلام شبا فقط برای کسب‌وکارهای مجاز و با قرارداد فعال می‌شود. اگر به‌صورت شخصی به خدمات احراز هویت نیاز دارید، یوآیدی‌پلاس یا احراز هویت ثنا گزینه درست شماست.
حجم استعلام ماهانه خود را مشخص کنید تا پله تعرفه و تخفیف پلکانی متناسب با آن را ببینید. استعلام‌های ناموفق یا اشتباه هزینه‌ای ندارند.
با ثبت این درخواست، حجم انتخابی شما به‌صورت خودکار برای کارشناس ارسال می‌شود تا پلن پیشنهادی دقیق‌تر باشد.
واریزهای ناموفق منتظر تصمیم شما نمی‌مانند. یک تماس کوتاه کافی است تا کارشناس یوآیدی حجم استعلام و سناریوی شما را بررسی کند و دسترسی سندباکس را فعال کند.
برای دریافت مشاوره رایگان، کلید API و فعال‌سازی وب‌سرویس استعلام اطلاعات مالی (شبا)، اطلاعات خود را در این فرم وارد کنید. کارشناسان یوآیدی در کوتاه‌ترین زمان ممکن با شما تماس خواهند گرفت.
فرم را پر کنید؛ کارشناس ما در سریع‌ترین زمان ممکن تماس می‌گیرد.
اطلاعات کسبوکارتان را بگذارید؛ کارشناس یوآیدی همین امروز تماس می‌گیرد، پلن متناسب با حجم استعلام ماهانه شما را پیشنهاد می‌دهد و دسترسی به محیط سندباکس و کلید API استعلام شبا را فعال می‌کند.
ترجیح می‌دهید همین حالا صحبت کنید؟ ۰۲۱۶۶۱۲۳۲۹۰