محیط آزمایشی
شبیهسازی موفق، ناموفق، انصراف و تأخیر بانک.
محیط آزمایشی تمام مسیر پرداخت را با یک شبکه پرداخت شبیهسازیشده (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) ممکن است.