نحوه استفاده از سرویس‌های استعلام بانکی پِی: راهنمای گام‌به‌گام

سرویس‌های استعلام بانکی پِی به‌گونه‌ای طراحی شده‌اند که هم کاربران عادی و کارشناسان عملیات، و هم توسعه‌دهندگان و صاحبان کسب‌وکار بتوانند بر پایه سطح نیاز خود از آن‌ها بهره ببرند؛ از یک استعلام دستی موردی تا یکپارچه‌سازی کامل با نرم‌افزار سازمانی. در این راهنما، تمام مراحل از ثبت‌نام و احراز هویت تا دریافت کلید دسترسی، اجرای استعلام و مصرف آن در محصول شما بررسی می‌شود.

پیش‌نیاز استفاده از سرویس

پیش از شروع، این موارد را آماده داشته باشید:

• نشانی ایمیل فعال برای دریافت اطلاع‌رسانی و بازیابی حساب.
• شماره موبایل به نام خود برای فرایند احراز هویت.
• اطلاعات کسب‌وکار (شناسه ملی، کد اقتصادی و مدارک ثبتی) در صورت ثبت‌نام شرکتی.

مراحل ثبت‌نام در سایت

۱. ایجاد حساب کاربری

با انتخاب گزینه «ثبت‌نام»، فرم مربوطه را با اطلاعات دقیق تکمیل کنید. پس از ارسال فرم، یک کد تایید به شماره موبایل شما ارسال می‌شود که برای فعال‌سازی حساب باید وارد شود.

۲. تکمیل پروفایل

وارد پنل کاربری خود شوید و اطلاعات تکمیلی مانند نام شرکت، نوع کسب‌وکار و نشانی را ثبت کنید. صحت این اطلاعات، مبنای صدور فاکتور و انطباق با الزامات استعلامی است.

۳. احراز هویت

برای دسترسی به سرویس‌های حساس (مانند استعلام هویتی و چک صیادی)، نیاز به احراز هویت دارید. این مرحله با بارگذاری مدارک شناسایی انجام می‌شود و معمولاً کمتر از ۲۴ ساعت کاری زمان می‌برد.

شارژ کیف پول

برای استفاده از سرویس‌ها، باید کیف پول خود را شارژ کنید. روش‌های شارژ عبارت‌اند از:

• پرداخت آنلاین با کارت بانکی از طریق درگاه امن.
• انتقال وجه از طریق درگاه بانکی یا سرویس‌های انتقال وجه.
• پرداخت سازمانی و تسویه دوره‌ای برای مشتریان شرکتی با حجم بالا.

مصرف هر سرویس بر پایه تعرفه اعلام‌شده از کیف پول کسر می‌شود و صورت‌حساب مصرف در پنل قابل مشاهده و استعلام است.

انواع روش‌های استفاده از سرویس‌ها

۱. استفاده از پنل کاربری (بدون نیاز به کدنویسی)

مناسب برای کاربرانی که به‌صورت موردی یا روزمره نیاز به استعلام دارند:

• وارد بخش سرویس‌ها شوید.
• سرویس موردنظر را انتخاب کنید.
• اطلاعات ورودی (کد ملی، شماره کارت، شبای مقصد و...) را وارد کنید.
• نتیجه استعلام را مشاهده، کپی یا دانلود کنید.

۲. استفاده از API (برای توسعه‌دهندگان)

اگر قصد دارید سرویس‌ها را در نرم‌افزار یا وب‌سایت خود یکپارچه کنید، از API استفاده کنید.

POST /api/v1/inquiry/iban-validation HTTP/1.1
Host: api.bankipay.ir
Authorization: Bearer YOUR_API_TOKEN
X-Request-ID: 8f7e2a9b-4c31-41d5-9e6b-123456789abc
Content-Type: application/json

{
  "iban": "IR570190000000211217811007"
}

مراحل دریافت و راه‌اندازی API:

۱. از پنل کاربری به بخش «توسعه‌دهندگان» بروید. ۲. یک کلید API جدید ایجاد کنید (کلید مجزا برای محیط توسعه و محیط عملیاتی). ۳. مستندات فنی و نمونه کدها را مطالعه کنید. ۴. نخستین درخواست را در محیط آزمایشی (Sandbox) ارسال و پاسخ را راستی‌آزمایی کنید.

۳. استعلام انبوه (Bulk)

برای کسب‌وکارهایی که نیاز به استعلام هزاران رکورد دارند:

• فایل اکسل را طبق الگوی ارائه‌شده آماده کنید.
• فایل را در پنل بارگذاری کنید.
• پس از پردازش، فایل نتیجه را به‌صورت ساختاریافته دانلود کنید.

نکات مهم امنیتی

برای حفظ امنیت حساب کاربری و داده‌ها، رعایت موارد زیر الزامی است:

• کلید API خود را در هیچ محلی — به‌ویژه در کد سمت کلاینت یا ریپوزیتوری عمومی — منتشر نکنید.
• رمز عبور پیچیده و منحصربه‌فرد انتخاب کنید و آن را در بازه‌های معین تغییر دهید.
• احراز هویت دو‌عاملی (2FA) را برای ورود به پنل فعال کنید.
• برای فراخوانی سرویس‌های مالی، محدودسازی نشانی IP (IP Whitelisting) را فعال نمایید.
• کلیدهای دسترسی را به‌صورت دوره‌ای بچرخانید (Key Rotation) و کلیدهای بی‌استفاده را باطل کنید.
• به‌صورت منظم گزارش فعالیت (لاگ) حساب را بررسی کنید تا فراخوانی‌های غیرعادی شناسایی شود.

پشتیبانی و رفع اشکال

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

• ارسال تیکت پشتیبانی از داخل پنل کاربری.
• گفت‌وگوی آنلاین در وب‌سایت.
• تماس تلفنی در ساعات اداری.

مقایسه روش‌های استعلام

آموزش پنل کاربری برای تیم ما راه‌اندازی را بسیار ساده کرد؛ اکنون استعلام‌های روزمره را بدون وابستگی به تیم فنی خودمان و در چند ثانیه انجام می‌دهیم.