درگاه زرینپال پرستاشاپ
ماژول رایگان درگاه زرینپال برای پرستاشاپ ۸ و ۹ با API نسخهی ۴: مبلغ همیشه به ریال فرستاده میشود، رفرش یا برگشت دوباره از درگاه سفارش تکراری نمیسازد، و اگر سبد وسط پرداخت عوض شود سفارش با مبلغ اشتباه ثبت نمیشود.

امکانات
API نسخهی ۴ زرینپال
درخواست، هدایت به درگاه و تأیید پرداخت با API فعلی زرینپال انجام میشود. کدهای ۱۰۰ و ۱۰۱ هر دو موفق حساب میشوند، پس تأیید دوبارهی یک پرداخت خطا نمیدهد.
همیشه ریال
مبلغ با واحد IRR فرستاده میشود و اگر قیمتهای فروشگاه تومان باشد، پیش از ارسال در ۱۰ ضرب میشود. پیشفرض واحد قیمت از ارز فروشگاه حدس زده میشود و شما تأییدش میکنید.
بدون سفارش تکراری
هر پرداخت قفل خودش را دارد. اگر مشتری صفحهی بازگشت را رفرش کند یا دو بار از درگاه برگردد، فقط یک سفارش ثبت میشود و درخواست دوم صفحهی خطا نمیبیند.
مبلغ سبد پیش از تأیید بررسی میشود
اگر مشتری وسط پرداخت در تب دیگری سبدش را عوض کرده باشد، پرداخت تأیید نمیشود و سفارشی ثبت نمیشود. زرینپال پول تأییدنشده را ظرف ۷۲ ساعت به مشتری برمیگرداند و مشتری پیام روشنی میبیند.
آدرس بازگشت امن
در آدرس بازگشت فقط یک شناسهی تصادفی میرود. کلید امنیتی مشتری و شناسهی سبد هیچوقت در آدرس نمیآیند و کد Authority با hash_equals مقایسه میشود.
حالت آزمایشی
پرداختها به sandbox.zarinpal.com میروند و پول واقعی جابهجا نمیشود. تا روشن است، بالای صفحهی تنظیمات هشدار میآید تا فراموش نشود.
برگهی تراکنشها
هر مشتری که به زرینپال رفته، با وضعیت، مبلغ، کد پیگیری، شمارهی کارت ماسکشده، سفارش ثبتشده و آخرین خطا. تاریخها شمسی است.
پنل در صفحهی سفارش
کد پیگیری، شمارهی کارت و وضعیت تراکنش زرینپال در صفحهی همان سفارش در پنل ادمین دیده میشود.
وقتی پرداخت شد ولی سفارش نه
اگر پول کم شد ولی پرستاشاپ نتوانست سفارش را بسازد، تراکنش با وضعیت خطا و کد پیگیری ثبت میشود و مشتری همان کد را میبیند تا با فروشگاه تماس بگیرد.
انتقال از ماژول zarinpal
مرچنت کد، حالت آزمایشی و واحد قیمت ماژول قدیمی zarinpal موقع نصب خودکار منتقل میشود.
پنل فارسی
تنظیمات و تراکنشها در پنل راهکار، با راهنمای هر برگه. ترجمهی فارسی و انگلیسی کامل.
بیشتر ماژولهای زرینپال پرستاشاپ فقط مسیر خوش پرداخت را درست انجام میدهند: مشتری میرود، پرداخت میکند، برمیگردد. مشکل از جایی شروع میشود که مشتری صفحهی بازگشت را رفرش میکند، در تب دیگری سبدش را عوض میکند، یا ارز فروشگاه IRR است ولی قیمتها تومان. این ماژول برای همین حالتها نوشته شده و روی پرستاشاپ ۸ و ۹ تست شده است.
مهمترین تنظیم، واحد قیمت است. ماژول مبلغ را همیشه به ریال به زرینپال میفرستد. اگر قیمتهای فروشگاه تومان باشد و ریال انتخاب شود، از مشتری یکدهم مبلغ گرفته میشود. ماژول از روی ارز پیشفرض حدس میزند، ولی پیش از روشن کردن درگاه، قیمت یک محصول را بسنجید.
پیشنیاز
- پرستاشاپ ۸٫۰ تا ۹٫x.
- PHP ۷٫۴ یا بالاتر با افزونهی
curl. اگر نباشد، نصب با پیامی متوقف میشود که نام افزونه را میگوید. - یک درگاه فعال در پنل زرینپال که دامنهاش همین فروشگاه باشد.
راهاندازی
- ماژول را از «ماژولها ← مدیریت ماژولها» با دکمهی بارگذاری یک ماژول نصب کنید و روی پیکربندی بزنید.
- در برگهی تنظیمات مرچنت کد را از پنل زرینپال وارد کنید. مرچنت کد ۳۶ نویسه دارد و اگر شکلش درست نباشد ذخیره نمیشود.
- واحد قیمت فروشگاه (ریال یا تومان) را بررسی کنید.
- اختیاری: حالت آزمایشی را روشن کنید و یک خرید با سندباکس زرینپال انجام دهید. پیش از راهاندازی خاموشش کنید؛ تا روشن است، بالای صفحهی تنظیمات هشدار میآید.
آدرس بازگشت لازم نیست جایی ثبت شود. ماژول با هر پرداخت خودش آن را میفرستد و در تنظیمات فقط نشانش میدهد تا ببینید دامنهاش با درگاه زرینپال یکی است.
آمدن از ماژول zarinpal قدیمی
اگر ماژولی با نام فنی zarinpal نصب دارید، موقع نصب این ماژول مرچنت کد، حالت آزمایشی و واحد قیمتش خودکار منتقل میشود. بعد از یک پرداخت موفق، ماژول قدیمی را حذف کنید تا مشتری دو گزینهی زرینپال در صفحهی پرداخت نبیند.
مستندات
سؤالات متداول
رایگان است؟
بله، رایگان است و لایسنس و ثبتنام ندارد.
به ماژول راهکار پرستاشاپ نیاز دارد؟
نه. مستقل است و فقط پرستاشاپ ۸ یا ۹ و PHP ۷.۴ با افزونهی curl میخواهد.
مرچنت کد را از کجا بیاورم؟
از پنل زرینپال، زیر درگاهی که برای این سایت ساختهاید. دامنهی درگاه باید دامنهی همین فروشگاه باشد، وگرنه زرینپال پرداخت را نمیپذیرد.
قیمتهای فروشگاه من ریال است یا تومان؟
ارز پیشفرض گاهی گمراه میکند، چون خیلی از فروشگاهها ارز IRR دارند ولی قیمت را تومان وارد کردهاند. اگر محصولی که در سایت ۱٬۵۰۰٬۰۰۰ نوشته شده واقعا یک میلیون و پانصد هزار تومان است، تومان را انتخاب کنید.
اگر مشتری صفحهی بازگشت را رفرش کند چه میشود؟
هیچ. پرداخت قفل دارد و فقط یک بار تأیید و یک سفارش ثبت میشود. درخواست دوم به صفحهی همان سفارش میرود.
ماژول zarinpal قبلی را چه کنم؟
این ماژول تنظیماتش را موقع نصب برمیدارد. بعد از یک پرداخت موفق، ماژول قدیمی را حذف کنید.
حداقل مبلغ چقدر است؟
۱۰ هزار ریال (هزار تومان)، همان حداقلی که زرینپال میپذیرد. برای سفارش کمتر، مشتری پیام میگیرد که روش دیگری انتخاب کند.
سازگاری
نظرات
ایمیل شما نمایش داده نمیشود. نظرها پس از تأیید تیم منتشر میشوند.
هنوز نظری ثبت نشده. اولین نفر باش.
نظر خودت را بنویس