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

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

شروع سریع

اولین پرداخت آزمایشی

SimLab بین برنامه شما و درگاه عملیاتی، یک محیط آزمایش قرار می‌دهد. کد برنامه‌تان به سرویس شبیه‌ساز درخواست می‌فرستد و پاسخِ نسخه پشتیبانی‌شده قرارداد را می‌گیرد؛ بدون ارتباط با بانک یا شبکه کارت.

چه چیزی در اتصال تغییر می‌کند؟

در تنظیمات محیط تست، نشانی سرویس و اعتبارنامه درگاه را با مقادیر ساختگی حساب SimLab عوض می‌کنید. درخواست همچنان ساختار همان درگاه را دارد؛ یک درگاه ممکن است SOAP باشد و دیگری JSON یا فرم. برای قراردادهای امضاشده یا رمزنگاری‌شده، راهنمای آماده‌سازی پیام همان درگاه را بخوانید. سازگاری به نسخه مستندشده محدود است و ممکن است کتابخانه اتصال شما به تنظیم یا تطبیق نیاز داشته باشد.

نشانی بازگشت متعلق به برنامه شماست. مرورگر به آن برمی‌گردد و سپس سرور شما عملیات تأیید را روی شبیه‌ساز اجرا می‌کند. نتیجه هر مرحله را با تاریخچه حساب مقایسه کنید؛ نتیجه صفحه پرداخت به‌تنهایی اثبات پرداخت نیست. اطلاعات کارت و اعتبارنامه پذیرندگی عملیاتی را به SimLab نفرستید.

نمونه آماده بدون کدنویسی

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

اجرای نمونه اولین پرداخت
۱

ورود و اشتراک

وارد حساب خود شوید و دوره آزمایشی یا اشتراک را فعال کنید. دسترسی فعال برای اجرای درخواست‌های شبیه‌سازی لازم است.

۲

فعال‌سازی درگاه

در داشبورد، یک درگاه آماده را فعال کنید و شناسه اتصال و اعتبارنامه ساختگی تولیدشده برای همان اتصال را کپی کنید.

۳

تعویض نشانی سرویس

آدرس سرویس و اعتبارنامه محیط آزمایش را از تنظیمات محیط عملیاتی جدا کنید. مقدار دقیق هر مسیر در صفحه درگاه آمده است.

۴

تکمیل چرخه

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

پیکربندی مستقل

شناسه اتصال، اعتبارنامه و نشانی زیر نمونه‌اند؛ مقادیر واقعیِ ساختگی را از داشبورد خود بگیرید.

نمونه متغیرهای محیطی

SIMLAB_BASE_URL=http://localhost:3000
SIMLAB_CONNECTION_ID=<connection-uuid>
# Never use live merchant credentials here.
MELLAT_SERVICE=$SIMLAB_BASE_URL/api/sandbox/mellat/$SIMLAB_CONNECTION_ID/pgw
SADAD_BASE=$SIMLAB_BASE_URL/api/sandbox/sadad/$SIMLAB_CONNECTION_ID

سناریو و نتیجه

در حالت تعاملی، صفحه تست فقط موفق، انصراف کاربر، خطای درگاه و پایان مهلت را نشان می‌دهد. سناریوی خودکار از گام‌های ثبت‌شده در داشبورد اتصال استفاده می‌کند و نتیجه آن از صفحه قابل تغییر نیست. موفقیت صفحه یا بازگشت به‌تنهایی مجوز تحویل کالا نیست.

خطا و دسترسی

خطاهای شکل درخواست و احراز هویت را از نتیجه پرداخت شبیه‌سازی‌شده جدا کنید. اشتراک منقضی، اتصال غیرفعال، درگاه غیرآماده و نسخه قرارداد نامنطبق عملیات زنده را رد می‌کنند؛ تکرار درخواست قبلی هم استثنا نیست. برای تشخیص، از کد پاسخ و تاریخچه درخواست خود در داشبورد استفاده کنید؛ درخواست‌های نامعتبر همیشه به یک تراکنش منسوب نمی‌شوند.

خروجی تاریخچه حساب کاربر در قالب XLSX فقط هنگام ایجاد دانلود می‌شود. JSON/CSV export یا دانلود دوباره همان فایل وجود ندارد.