درگاه پرداخت شی‌پی برای ووکامرس
افزونهٔ رسمی شی‌پی برای ووکامرس. هر پرداخت سمت سرور و با مبلغ سفارش تأیید می‌شود. اگر نتیجهٔ بانک دیر برسد، سفارش «در انتظار بررسی» می‌ماند و با وب‌هوک یا بررسی خودکار تکمیل می‌شود. استرداد کامل یا جزئی را از صفحهٔ سفارش انجام می‌دهید و واحد پول (ریال، تومان، هزار تومان) خودکار تشخیص داده می‌شود.
- چک‌اوت بلوکی
- سازگار با HPOS
- استرداد از داخل پنل
- وب‌هوک امضاشده
- وضعیت «در انتظار» درست
- پیگیری خودکار پرداخت‌های معلق
- تومان و ریال
- حالت آزمایشی با sk_test_
- دکمهٔ تست اتصال
نصب
- ۱
فایل zip را در پیشخوان وردپرس از «افزونه‌ها › افزودن › بارگذاری افزونه» نصب و فعال کنید.
- ۲
به «ووکامرس › پیکربندی › پرداخت‌ها» بروید و درگاه «شی‌پی» را روشن کنید.
- ۳
کلید API را از پنل شی‌پی (توسعه‌دهندگان › کلیدهای API) کپی کنید و در تنظیمات افزونه بگذارید. برای شروع کلید
sk_test_کافی است. - ۴
تنظیمات را ذخیره و «تست اتصال» را بزنید.
- ۵
در پنل شی‌پی › وب‌هوک‌ها، endpoint با آدرس
https://سایت-شما/?wc-api=sheypay_webhookبسازید و رمز آن را در فیلد «رمز وب‌هوک» بگذارید.
- با Dokan، WCFM و Digits سازگار است.
تنظیمات
- کلید API
sk_test_برای آزمایش وsk_live_برای فروش واقعی. حالت از روی خود کلید تشخیص داده می‌شود.- واحد پول فروشگاه
- «خودکار» واحد را از تنظیمات ووکامرس می‌خواند. ریال، تومان، هزار تومان و هزار ریال پشتیبانی می‌شود.
- پیشوند شناسهٔ سفارش
- فقط وقتی یک درگاه را روی چند فروشگاه استفاده می‌کنید لازم است.
- رمز وب‌هوک
- رمز امضای endpoint از پنل شی‌پی. سفارش‌هایی که مشتری‌شان به سایت برنمی‌گردد با وب‌هوک تکمیل می‌شوند.
- پیام‌ها
- متن پرداخت موفق، در انتظار و ناموفق. {tracking_code} با کد پیگیری جایگزین می‌شود.
- گزارش خطا
- لاگ در «ووکامرس › وضعیت › گزارش‌ها» با منبع sheypay.
تست در محیط آزمایشی
با کلید sk_test_ پول واقعی جابه‌جا نمی‌شود و در صفحهٔ بانک آزمایشی نتیجه را خودتان انتخاب می‌کنید.
- کلید
sk_test_را در تنظیمات بگذارید؛ در این حالت پول واقعی جابه‌جا نمی‌شود. - یک سفارش بزنید و در صفحهٔ بانک آزمایشی «پرداخت موفق» را انتخاب کنید. سفارش باید «در حال انجام» شود و کد پیگیری در یادداشت سفارش بیاید.
- یک بار «ناموفق» و یک بار «در انتظار» را هم امتحان کنید: ناموفق به صفحهٔ پرداخت سفارش برمی‌گردد و در انتظار، سفارش را «در انتظار بررسی» نگه می‌دارد.
- از صفحهٔ سفارش یک استرداد جزئی بزنید و نتیجه را در پنل شی‌پی ببینید.
- پس از تأیید درگاه، کلید
sk_live_را جایگزین کنید.
مشکلات رایج
مبلغ در درگاه ده برابر یا یک‌دهم است.
واحد پول افزونه را روی «خودکار» بگذارید یا آن را با واحد ووکامرس (پیکربندی › عمومی › واحد پول) یکی کنید.
خطای «دامنهٔ آدرس بازگشت تأیید نشده است» می‌گیرم.
آدرس سایت وردپرس باید روی دامنهٔ تأییدشدهٔ درگاه در پنل شی‌پی باشد. «تست اتصال» دامنهٔ درگاه را نشان می‌دهد.
درگاه در صفحهٔ پرداخت نمایش داده نمی‌شود.
مطمئن شوید درگاه فعال است و کلید API ذخیره شده. در چک‌اوت بلوکی، کش افزونه‌های بهینه‌سازی را پاک کنید.
سفارش بعد از پرداخت «در انتظار پرداخت» مانده است.
احتمالاً مشتری به سایت برنگشته. وب‌هوک را تنظیم کنید؛ افزونه هم تا ۶ بار پرداخت‌های معلق را خودکار بررسی می‌کند.
با Dokan یا WCFM کار می‌کند؟
بله. شی‌پی یک درگاه معمولی ووکامرس است و وجه به حساب مدیر بازارچه می‌رسد؛ سهم فروشندگان از طریق برداشت خود بازارچه پرداخت می‌شود.
تغییرات
نسخهٔ ۲.۰.۰
- پرداخت «در انتظار بانک» دیگر سفارش را ناموفق نمی‌کند؛ سفارش در انتظار بررسی می‌ماند و خودکار پیگیری می‌شود.
- پشتیبانی از چک‌اوت بلوکی ووکامرس و HPOS.
- استرداد کامل و جزئی از صفحهٔ سفارش.
- وب‌هوک امضاشده، دکمهٔ تست اتصال و تشخیص خودکار واحد پول.
- بررسی کلید سفارش در آدرس بازگشت.
نسخهٔ ۱.۰.۰
- نسخهٔ اول: پرداخت و تأیید سمت سرور، تبدیل تومان و ریال.
اولین رسیدتان را امروز صادر کنید
ثبت‌نام با شمارهٔ موبایل انجام می‌شود و تا تأیید مدارک، همه‌چیز را در محیط آزمایشی امتحان می‌کنید.