مستندات SimLab / راهنمای درگاه‌ها

فهرست مستندات

آزمون و عیب‌یابی

نتیجه صفحه پرداخت را تا تأیید نهایی دنبال کنید

برگشت مرورگر به سایت، به‌تنهایی موفقیت پرداخت نیست. برنامه پذیرنده باید عملیات تأیید همان قرارداد را از سرور اجرا کند؛ بعضی درگاه‌ها مرحله تسویه یا تأیید تکمیلی هم دارند.

یک سناریوی قابل تکرار بسازید

  1. درگاه را در حساب خود انتخاب و اتصال آن را فعال کنید. آدرس پایه و اعتبارنامه آزمایشی را از صفحه همان درگاه بردارید.
  2. اگر اجرای خودکار می‌خواهید، صف سناریو را در کارگاه درگاه تنظیم و صریحاً ذخیره کنید. تغییرات ذخیره‌نشده اجرا نمی‌شوند.
  3. از برنامه پذیرنده درخواست پرداخت بسازید. نتیجه ایجاد درخواست و شناسه تراکنش را ثبت کنید.
  4. صفحه پرداخت آزمایشی را باز کنید. در حالت انتخاب دستی، نتیجه را انتخاب کنید؛ در حالت خودکار، نتیجه از سناریوی ذخیره‌شده می‌آید.
  5. بازگشت را دریافت کنید، سپس از سرور عملیات تأیید و مراحل لازم همان درگاه را انجام دهید.
  6. در بخش تراکنش‌ها و درخواست‌ها، ورودی، پاسخ، مرحله نهایی و مصرف سناریو را بررسی کنید. پیش از تکرار، اثر اجرای قبلی و صف باقی‌مانده را ببینید.

کدام نتیجه‌ها واقعاً اجرا می‌شوند؟

موفق

نتیجه موفق صفحه را انتخاب کنید؛ سپس تأیید نهایی را از سرور انجام دهید. برنامه نباید صرفاً با بازگشت مرورگر سفارش را پرداخت‌شده بداند.

انصراف کاربر

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

خطای درگاه

پاسخ خطا را با قرارداد همان درگاه بررسی کنید. هیچ کد خطای بانکی یکسانی برای همه ارائه‌دهندگان فرض نکنید.

پایان مهلت

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

خطا را از مرحله درست پیدا کنید

  • ایجاد درخواست رد شده: ابتدا واحد مبلغ، فیلدهای الزامی، اعتبارنامه آزمایشی و امضای قرارداد را بررسی کنید.
  • بازگشت به سایت نرسیده: روش GET یا POST قرارداد و نشانی بازگشت برنامه را کنترل کنید؛ localhost دستگاه دیگر، به سایت شما اشاره نمی‌کند.
  • تأیید ناموفق: شناسه‌ها، مبلغ و عملیات تأیید را با درخواست اولیه تطبیق دهید. پاسخ و معنای تکرار تأیید در هر قرارداد متفاوت است.
  • دسترسی رد شده: اشتراک، وضعیت حساب، انتخاب درگاه و فعال‌بودن اتصال را بررسی کنید؛ خطای سیاست SimLab را به‌عنوان پاسخ موفق بانک تفسیر نکنید.

محدودیت‌ها

پیش‌نمایش مدیر، نمونه نمایشی است و تراکنش، بازگشت به پذیرنده یا اشتراک نمی‌سازد. نتیجه‌های بیشتر این پیش‌نمایش، به معنی وجود همه آن سناریوها در API نیست. تزریق عمومی timeout، پاسخ دلخواه یا خطای موجودی برای همه درگاه‌ها عرضه نشده است؛ فقط قابلیت‌های مستند همان پروفایل را مبنا بگیرید.

اطلاعات واقعی کارت، رمز، کلید خصوصی یا اعتبارنامه بانک را وارد نکنید. برای بررسی امضا، فقط کلیدهای آزمایشی همان اتصال را به کار ببرید.