درگاه پرداخت شی‌پی برای مجنتو ۲
ماژول SheyPay_Payment درگاه شی‌پی را به صفحهٔ پرداخت مجنتو 2.4 اضافه می‌کند. سفارش با وضعیت Pending Payment ثبت می‌شود و فقط پس از تأیید سمت سرور با مبلغ سفارش، فاکتور می‌خورد و Processing می‌شود. نتیجهٔ دیررس بانک با وب‌هوک امضاشده تکمیل می‌شود و استرداد کامل یا جزئی از Credit Memo انجام می‌شود.
- استرداد از داخل پنل
- وب‌هوک امضاشده
- وضعیت «در انتظار» درست
- تومان و ریال
- حالت آزمایشی با sk_test_
این نسخه بتا است: کامل است ولی هنوز روی فروشگاه‌های واقعی کافی اجرا نشده. اول روی نسخهٔ آزمایشی سایتتان و با کلید sk_test_ امتحانش کنید و هر اشکالی دیدید به پشتیبانی بگویید.
نصب
- ۱
محتوای zip را در ریشهٔ مجنتو باز کنید تا پوشهٔ
app/code/SheyPay/Paymentساخته شود. - ۲
دستورهای
bin/magentomodule:enable SheyPay_Payment، setup:upgrade، setup:di:compile و setup:static-content:deploy را اجرا و کش را پاک کنید. - ۳
در Stores › Configuration › Sales › Payment Methods بخش «درگاه پرداخت شی‌پی» را فعال کنید و کلید API (
sk_test_برای آزمایش) را وارد کنید. - ۴
در پنل شی‌پی › وب‌هوک‌ها آدرس
https://فروشگاه-شما/sheypay/payment/webhookرا ثبت و رمزش را در «رمز وب‌هوک» بگذارید.
تنظیمات
- کلید API
- به‌صورت رمزشده در تنظیمات مجنتو ذخیره می‌شود.
sk_test_برای آزمایش وsk_live_برای فروش واقعی. - واحد مبلغ فروشگاه
- ارز IRR ریال و
IRT/TMNتومان تشخیص داده می‌شود؛ برای کدهای دیگر واحد را انتخاب کنید. - رمز وب‌هوک
- برای تکمیل سفارش‌هایی که مشتری‌شان به فروشگاه برنمی‌گردد.
- کشورهای مجاز و ترتیب نمایش
- مثل سایر روش‌های پرداخت مجنتو.
- پیشوند شناسهٔ سفارش
- فقط وقتی یک درگاه را روی چند فروشگاه استفاده می‌کنید.
تست در محیط آزمایشی
با کلید sk_test_ پول واقعی جابه‌جا نمی‌شود و در صفحهٔ بانک آزمایشی نتیجه را خودتان انتخاب می‌کنید.
- کلید
sk_test_را وارد کنید؛ پول واقعی جابه‌جا نمی‌شود. - یک سفارش ثبت کنید و در بانک آزمایشی «موفق» را انتخاب کنید؛ سفارش باید فاکتور بخورد و Processing شود و کد پیگیری در تاریخچه بیاید.
- «ناموفق» سفارش را لغو و سبد را بازمی‌گرداند؛ «در انتظار» سفارش را در Pending Payment نگه می‌دارد.
- از فاکتور یک Credit Memo آنلاین بزنید و نتیجه را در پنل شی‌پی ببینید.
مشکلات رایج
روش پرداخت در صفحهٔ پرداخت نیست.
پس از نصب setup:static-content:deploy و cache:flush را اجرا کنید و مطمئن شوید ماژول فعال و کلید ذخیره شده است.
سفارش‌های پرداخت‌نشده خودکار لغو می‌شوند.
رفتار پیش‌فرض مجنتو است (Pending Payment Order Lifetime در Sales › Checkout). اگر لازم است این زمان را بیشتر کنید.
مبلغ در درگاه ده برابر یا یک‌دهم است.
«واحد مبلغ فروشگاه» را با واحد واقعی ارز سفارش یکی کنید.
خطای «دامنهٔ آدرس بازگشت تأیید نشده است».
Base URL فروشگاه باید روی دامنهٔ تأییدشدهٔ درگاه در پنل شی‌پی باشد.
تغییرات
نسخهٔ ۱.۰.۰
- نسخهٔ اول: پرداخت با ریدایرکت، فاکتور پس از تأیید سمت سرور، وضعیت در انتظار، وب‌هوک امضاشده و استرداد از Credit Memo.
اولین رسیدتان را امروز صادر کنید
ثبت‌نام با شمارهٔ موبایل انجام می‌شود و تا تأیید مدارک، همه‌چیز را در محیط آزمایشی امتحان می‌کنید.