درگاه پرداخت شی‌پی برای WHMCS
ماژول درگاه شی‌پی برای WHMCS. مشتری از صفحهٔ صورتحساب به درگاه می‌رود و پس از بازگشت، پرداخت سمت سرور تأیید و صورتحساب پرداخت‌شده می‌شود. شناسهٔ پرداخت شی‌پی به‌عنوان Transaction ID ثبت می‌شود تا یک پرداخت دو بار ثبت نشود. اگر مشتری به سایت برنگردد، وب‌هوک امضاشده صورتحساب را تکمیل می‌کند.
- استرداد از داخل پنل
- وب‌هوک امضاشده
- وضعیت «در انتظار» درست
- تومان و ریال
- حالت آزمایشی با sk_test_
- دکمهٔ تست اتصال
این نسخه بتا است: کامل است ولی هنوز روی فروشگاه‌های واقعی کافی اجرا نشده. اول روی نسخهٔ آزمایشی سایتتان و با کلید sk_test_ امتحانش کنید و هر اشکالی دیدید به پشتیبانی بگویید.
نصب
- ۱
محتوای zip را در ریشهٔ WHMCS کپی کنید (پوشهٔ
modules/gateways). - ۲
در System Settings › Payment Gateways › All Payment Gateways روی «شی‌پی» بزنید.
- ۳
کلید API و «واحد پول صورتحساب» (تومان یا ریال) را وارد و ذخیره کنید؛ کلید هنگام ذخیره بررسی می‌شود.
- ۴
در پنل شی‌پی › وب‌هوک‌ها آدرس
https://YOUR-WHMCS/modules/gateways/callback/sheypay.phpرا ثبت و رمز امضا را در «رمز وب‌هوک» بگذارید.
تنظیمات
- کلید API
sk_test_برای آزمایش وsk_live_برای پرداخت واقعی.- واحد پول صورتحساب
- تومان یا ریال، مطابق ارز پیش‌فرض WHMCS. مبلغ همیشه به ریال به شی‌پی می‌رود.
- پیشوند شناسهٔ صورتحساب
- اختیاری؛ برای استفادهٔ یک درگاه روی چند سامانه.
- رمز وب‌هوک
- رمز امضای endpoint ثبت‌شده در پنل شی‌پی.
تست در محیط آزمایشی
با کلید sk_test_ پول واقعی جابه‌جا نمی‌شود و در صفحهٔ بانک آزمایشی نتیجه را خودتان انتخاب می‌کنید.
- کلید
sk_test_را بگذارید و یک صورتحساب آزمایشی بسازید. - از ناحیهٔ کاربری «پرداخت» را بزنید و در بانک آزمایشی «موفق» را انتخاب کنید؛ صورتحساب باید Paid شود و تراکنش در Gateway Log ثبت شود.
- حالت «ناموفق» و «در انتظار» را هم امتحان کنید.
- از صفحهٔ صورتحساب یک استرداد جزئی بزنید.
مشکلات رایج
مبلغ در درگاه ده برابر است.
«واحد پول صورتحساب» را با ارز WHMCS یکی کنید.
خطای دامنهٔ آدرس بازگشت
آدرس WHMCS (System URL) باید روی دامنهٔ تأییدشدهٔ درگاه در پنل شی‌پی باشد.
صورتحساب پس از پرداخت Unpaid مانده است.
وب‌هوک را تنظیم کنید و Gateway Log را ببینید؛ اگر نتیجه Pending است، بانک هنوز پاسخ نداده.
تغییرات
نسخهٔ ۱.۰.۰
- نسخهٔ اول: پرداخت، تأیید سمت سرور، وب‌هوک امضاشده، استرداد و بررسی کلید هنگام ذخیره.
ماژول‌های دیگر در «هاستینگ و صورتحساب»
همهٔ ماژولهااولین رسیدتان را امروز صادر کنید
ثبت‌نام با شمارهٔ موبایل انجام می‌شود و تا تأیید مدارک، همه‌چیز را در محیط آزمایشی امتحان می‌کنید.