پرش به محتوای اصلی

محیط آزمایشی

شبیه‌سازی موفق، ناموفق، انصراف و تأخیر بانک.

محیط آزمایشی تمام مسیر پرداخت را با یک شبکه پرداخت شبیه‌سازی‌شده (MockPSP) اجرا می‌کند: ایجاد پرداخت، صفحه بانک، callback، verify، استرداد، برگشت و وب‌هوک. پول واقعی جابه‌جا نمی‌شود و هیچ درخواستی به بانک یا شاپرک نمی‌رود.

شروع

با کلید sk_test_ پرداخت بسازید. در پنل، سوییچ «آزمایشی/عملیاتی» را روی آزمایشی بگذارید تا تراکنش‌ها، موجودی و تسویه‌های آزمایشی را ببینید. موجودی آزمایشی هرگز با موجودی واقعی جمع نمی‌شود.

سناریوهای صفحه بانک آزمایشی

  • پرداخت موفق: پرداخت تأیید و وضعیت successful می‌شود؛ سپس verify شما آن را verified می‌کند.
  • پرداخت ناموفق (موجودی ناکافی): وضعیت failed.
  • انصراف مشتری: وضعیت failed با علت انصراف.
  • تأخیر در تأیید: اولین تأیید با بانک پاسخ نمی‌گیرد و پرداخت در وضعیت pending می‌ماند تا استعلام خودکار آن را successful کند. برای آزمودن منطق pending در کد شما.

در صفحه بانک آزمایشی، دکمه «ارسال دوباره نتیجه» callback تکراری را شبیه‌سازی می‌کند؛ پرداخت دوباره ثبت نمی‌شود.

چه چیزهایی را تست کنید؟

  • تکرار درخواست ایجاد با همان Idempotency-Key (باید همان پرداخت برگردد).
  • verify با مبلغ اشتباه (payment_amount_mismatch).
  • تکرار verify (پاسخ already_verified: true).
  • عدم verify تا پایان مهلت (برگشت خودکار، وب‌هوک payment.reversed).
  • استرداد جزئی و تلاش برای استرداد بیش از مبلغ (refund_exceeds_amount).
  • پاسخ ۵۰۰ از سرور وب‌هوک شما و ارسال مجدد دستی از پنل.
فعال‌سازی حالت عملیاتی فقط پس از دست‌کم یک پرداخت آزمایشی موفق و تأییدشده (verified) ممکن است.