درگاه پرداخت شی‌پی برای Ninja Forms
اکشن «پرداخت شی‌پی» به بخش «ایمیل‌ها و اقدامات» Ninja Forms اضافه می‌شود. مبلغ می‌تواند عدد ثابت، یک فیلد ({field:amount}) یا یک محاسبه ({calc:total}) باشد. پس از ارسال، کاربر به درگاه می‌رود و نتیجه پس از تأیید سمت سرور ثبت و نمایش داده می‌شود.
- وب‌هوک امضاشده
- وضعیت «در انتظار» درست
- تومان و ریال
- حالت آزمایشی با sk_test_
- دکمهٔ تست اتصال
این نسخه بتا است: کامل است ولی هنوز روی فروشگاه‌های واقعی کافی اجرا نشده. اول روی نسخهٔ آزمایشی سایتتان و با کلید sk_test_ امتحانش کنید و هر اشکالی دیدید به پشتیبانی بگویید.
نصب
- ۱
فایل zip را از «افزونه‌ها › افزودن › بارگذاری افزونه» نصب و فعال کنید.
- ۲
در «تنظیمات › شی‌پی · نینجا فرمز» کلید API و واحد پول را بگذارید و «تست اتصال» را بزنید.
- ۳
در فرم‌ساز، بخش «ایمیل‌ها و اقدامات» اکشن «پرداخت شی‌پی» را اضافه کنید و مبلغ را (مثلاً {calc:total}) وارد کنید.
- ۴
آدرس وب‌هوک را در پنل شی‌پی ثبت و رمز آن را در افزونه بگذارید.
تنظیمات
- کلید API
sk_test_برای آزمایش وsk_live_برای پرداخت واقعی؛ در «تنظیمات › شی‌پی · نینجا فرمز».- واحد مبلغ فرم‌ها
- تومان یا ریال. مبلغ همیشه به ریال به شی‌پی فرستاده می‌شود.
- رمز وب‌هوک
- رمز امضای endpoint در پنل شی‌پی؛ آدرس endpoint در همان صفحهٔ تنظیمات نمایش داده می‌شود.
- صفحه‌های پس از پرداخت
- اختیاری. اگر خالی بماند، کاربر به صفحهٔ فرم برمی‌گردد و نتیجه بالای صفحه نمایش داده می‌شود.
- پیام‌ها
- متن پرداخت موفق، در انتظار و ناموفق؛ {tracking_code} با کد پیگیری جایگزین می‌شود.
- پیشوند شناسه
- فقط وقتی یک درگاه را روی چند سایت یا چند افزونه استفاده می‌کنید.
- اکشن «پرداخت شی‌پی»
- مبلغ، توضیح، موبایل، ایمیل و نام؛ همه merge tag می‌پذیرند.
تست در محیط آزمایشی
با کلید sk_test_ پول واقعی جابه‌جا نمی‌شود و در صفحهٔ بانک آزمایشی نتیجه را خودتان انتخاب می‌کنید.
- کلید
sk_test_را بگذارید. - فرم را ارسال کنید؛ باید به صفحهٔ پرداخت آزمایشی بروید.
- نتیجه بالای صفحهٔ فرم و در فهرست «پرداخت‌های نینجا فرمز» دیده می‌شود.
- پس از تأیید درگاه، کلید
sk_live_را جایگزین کنید.
مشکلات رایج
مبلغ در درگاه ده برابر یا یک‌دهم است.
«واحد مبلغ فرم‌ها» را با واحدی که در فرم استفاده می‌کنید (تومان یا ریال) یکی کنید.
خطای «دامنهٔ آدرس بازگشت تأیید نشده است» می‌گیرم.
آدرس سایت باید روی دامنهٔ تأییدشدهٔ درگاه در پنل شی‌پی باشد. «تست اتصال» دامنهٔ درگاه را نشان می‌دهد.
پرداخت انجام شده ولی وضعیت «در انتظار» مانده است.
احتمالاً مشتری به سایت برنگشته. وب‌هوک را در پنل شی‌پی تنظیم کنید تا وضعیت خودکار به‌روز شود.
اکشن «تغییر مسیر» دیگری هم دارم.
اکشن Redirect خود Ninja Forms را غیرفعال کنید؛ اکشن شی‌پی خودش کاربر را به درگاه می‌فرستد.
تغییرات
نسخهٔ ۱.۰.۰
- نسخهٔ اول.
اولین رسیدتان را امروز صادر کنید
ثبت‌نام با شمارهٔ موبایل انجام می‌شود و تا تأیید مدارک، همه‌چیز را در محیط آزمایشی امتحان می‌کنید.