درگاه زرین‌پال
افزونهٔ درگاه پرداخت زرین‌پال (افزونهٔ گیومه) پرداخت آنلاین از طریق زرین‌پال را به صفحهٔ پرداخت اضافه می‌کند. این افزونه داخل بستهٔ Giumeeh Nest قرار دارد و با لایسنس Nest فعال می‌شود.
۱. لایسنس
پس از فعال‌سازی لایسنس Nest، زرین‌پال نیز فعال است و فعال‌سازی جداگانه لازم ندارد. تا پیش از آن، این روش پرداخت در صفحهٔ پرداخت نمایش داده نمی‌شود.
۲. تنظیم درگاه
مسیر: پرداخت‌ها ← روش‌های پرداخت ← زرین‌پال ← ویرایش
| تنظیم | توضیح |
|---|---|
| فعال‌سازی درگاه | روشن/خاموش کردن زرین‌پال در صفحهٔ پرداخت |
| نام و توضیحات | عنوان و توضیحی که به مشتری نمایش داده می‌شود |
| مرچنت‌کد (Merchant ID) | شناسهٔ ۳۶ کاراکتری درگاه از پنل زرین‌پال |
| حالت آزمایشی (Sandbox) | پرداخت آزمایشی بدون انتقال پول واقعی |
| حالت دیباگ و ثبت Callback | ثبت جزئیات درخواست‌ها در لاگ برای عیب‌یابی |
| پیام موفقیت و شکست | متن نمایش‌داده‌شده پس از پرداخت |
| کارمزد پرداخت | کارمزد ثابت یا درصدی اضافه‌شده به سفارش |
⚠️ برای دریافت پرداخت واقعی، مرچنت‌کد اصلی را وارد کنید و حالت آزمایشی را خاموش کنید. تا وقتی حالت آزمایشی روشن است هیچ پرداخت واقعی انجام نمی‌شود.
۳. واحد پول
زرین‌پال مبلغ را با همان واحد پول فروشگاه دریافت می‌کند:
- اگر مشتری با ریال (IRR) خرید کند، مبلغ به ریال ارسال می‌شود.
- اگر مشتری با تومان (IRT) خرید کند، مبلغ به تومان ارسال می‌شود.
هیچ تبدیل دستی لازم نیست؛ مبلغ پرداختی در زرین‌پال با مبلغ نمایش‌داده‌شده به مشتری یکسان است. به ارزها مراجعه کنید.
روند پرداخت
- مشتری در صفحهٔ پرداخت زرین‌پال را انتخاب می‌کند و به درگاه منتقل می‌شود.
- پس از پرداخت، زرین‌پال مشتری را به آدرس
https://your-domain.com/payment/zarinpal/callbackبازمی‌گرداند. این آدرس با هر درخواست به‌صورت خودکار ارسال می‌شود و نیازی به ثبت در پنل زرین‌پال ندارد. - پرداخت در سمت سرور با زرین‌پال تأیید می‌شود و سفارش پرداخت‌شده ثبت می‌شود. بازگشت تکراری (مثلاً با دکمهٔ Back مرورگر) پرداخت را دوباره ثبت نمی‌کند.
جزئیات تراکنش‌ها در پرداخت‌ها ← تراکنش‌ها دیده می‌شود.
رفع اشکال
| مشکل | راه‌حل |
|---|---|
| زرین‌پال در صفحهٔ پرداخت نمایش داده نمی‌شود | لایسنس Nest فعال نشده، درگاه غیرفعال است یا مرچنت‌کد وارد نشده است |
| خطای تنظیم نشدن مرچنت‌کد | مرچنت‌کد ۳۶ کاراکتری را در تنظیمات درگاه ذخیره کنید |
| پرداخت انجام شد ولی سفارش ثبت نشد | سایت باید از اینترنت در دسترس باشد (Callback روی localhost کار نمی‌کند)؛ حالت دیباگ را روشن کنید و storage/logs/ را بررسی کنید |
| خطای نامعتبر بودن تراکنش پس از بازگشت از درگاه | زمان پرداخت منقضی شده است؛ مشتری باید دوباره پرداخت کند |
بازگرداندن وجه (Refund) آنلاین از پنل مدیریت پشتیبانی نمی‌شود و باید از پنل زرین‌پال انجام شود.