شروع کار با API
از ثبت‌نام و دریافت API Key تا ارسال اولین درخواست در محیط Sandbox.
- ثبت‌نام و ورود به پنل
- دریافت کلید API
- ارسال درخواست تست
در حال بارگذاری...
در حال بارگذاری...
مسیرهای یادگیری، درس‌های گام‌به‌گام و راهنمای خطایابی برای توسعه‌دهندگان، مدیران محصول و تیم‌های فنی که می‌خواهند APIها، ابزارهای مالی و گزارش‌گیری بانکی پِی را درست و امن پیاده‌سازی کنند.
۴
مسیر یادگیری
۱۲
درس عملی
۹۰
دقیقه محتوای پیشنهادی
هر مسیر با هدف مشخص طراحی شده است؛ ابتدا مفاهیم پایه را یاد بگیرید، سپس سرویس موردنظر را تست و در نهایت برای Production آماده کنید.
از ثبت‌نام و دریافت API Key تا ارسال اولین درخواست در محیط Sandbox.
آموزش استفاده از سرویس‌های کارت به شبا، اعتبارسنجی شبا و استعلام وضعیت چک.
راه‌اندازی گزارش‌های مالی، تحلیل تراکنش‌ها و خروجی‌های مدیریتی.
مدیریت کلیدها، امضای درخواست، محدودیت نرخ و تشخیص خطاهای رایج.
API و یکپارچه‌سازی
ساخت کلید API، تنظیم headerها، ارسال درخواست Sandbox و بررسی پاسخ JSON.
استعلام بانکی
آموزش ارسال شماره کارت، دریافت شبا، نام صاحب حساب و بانک مقصد.
استعلام بانکی
بررسی تطابق شبا و نام صاحب حساب برای کاهش خطا در انتقال وجه.
مالی
دریافت نرخ لحظه‌ای ارز و طلا، تبدیل سریع و نمایش قیمتها در اپلیکیشن.
فاکتور و گزارش
ساخت فاکتور، ثبت اقلام، دانلود PDF و Excel و ارسال به مشتری.
امنیت
چرخش کلید، تفکیک محیطها، محدودسازی IP و جلوگیری از نشت اعتبارنامه.
خطایابی
بررسی کدهای ۴۰۰، ۴۰۱، ۴۰۳، ۴۲۹ و ۵۰۰ همراه با نمونه پاسخ.
عملیات
طراحی صف درخواست، backoff، idempotency و جلوگیری از درخواست تکراری.
از Sandbox برای توسعه اولیه استفاده کنید و کلید Production را فقط پس از اطمینان از صحت پیاده‌سازی فعال کنید.
HTTPS، headerهای احراز هویت، محتوای JSON معتبر و عدم ارسال اطلاعات محرمانه در URL را رعایت کنید.
برای کدهای خطا، timeout، پاسخ نامعتبر و خطای شبکه، رفتار مشخص و قابل پیگیری تعریف کنید.
Request ID، زمان خطا، endpoint و وضعیت پاسخ را برای پیگیری سریع با پشتیبانی نگهداری کنید.
سوالات پرتکرار
اگر برای اولین بار از بانکی پِی استفاده می‌کنید، مسیر «شروع کار با API» را دنبال کنید. پس از دریافت API Key و تست Sandbox، آموزش سرویس موردنظر خود را ادامه دهید.
بیشتر آموزش‌ها برای محیط Sandbox طراحی شده‌اند تا بدون ریسک مالی یا عملیاتی تست شوند. پس از موفقیت در تست، می‌توانید فرایند را به Production منتقل کنید.
در صفحه پشتیبانی، نوع سرویس، Request ID، زمان خطا و توضیح سناریو را ارسال کنید تا تیم فنی مسیر دقیق‌تری را پیشنهاد دهد.
در مستندات API می‌توانید نمونه درخواست‌ها و پاسخ‌ها را مشاهده کنید. برای درخواست نمونه کد اختصاصی، از طریق ایمیل پشتیبانی اقدام کنید.
اگر معماری پیچیده، تراکنش حساس یا نیاز به SLA اختصاصی دارید، تیم پشتیبانی بانکی پِی میتواند مسیر پیاده‌سازی امنتر را پیشنهاد دهد.