شروع کار با 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 اختصاصی دارید، تیم پشتیبانی بانکی پِی میتواند مسیر پیادهسازی امنتر را پیشنهاد دهد.