شروع سریع
اولین پرداخت آزمایشی
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 یا دانلود دوباره همان فایل وجود ندارد.