درگاه پرداخت شی‌پی برای گرویتی فرم
افزودنی رسمی شی‌پی بر پایهٔ چارچوب Payment Add-On گرویتی فرم. برای هر فرم یک فید «محصولات و خدمات» می‌سازید و مبلغ از جمع فرم یا یک فیلد خوانده می‌شود. پس از بازگشت مشتری، پرداخت سمت سرور تأیید و وضعیت ورودی (پرداخت‌شده، در انتظار، ناموفق) ثبت می‌شود؛ اعلان‌ها را می‌توانید روی رویداد «پرداخت شی‌پی موفق» بگذارید.
- وب‌هوک امضاشده
- وضعیت «در انتظار» درست
- تومان و ریال
- حالت آزمایشی با sk_test_
- دکمهٔ تست اتصال
این نسخه بتا است: کامل است ولی هنوز روی فروشگاه‌های واقعی کافی اجرا نشده. اول روی نسخهٔ آزمایشی سایتتان و با کلید sk_test_ امتحانش کنید و هر اشکالی دیدید به پشتیبانی بگویید.
نصب
- ۱
فایل zip را از «افزونه‌ها › افزودن › بارگذاری افزونه» نصب و فعال کنید.
- ۲
به «فرم‌ها › تنظیمات › شی‌پی» بروید، کلید API را بگذارید و ذخیره کنید؛ علامت سبز یعنی اتصال برقرار است.
- ۳
در تنظیمات فرم › شی‌پی یک فید جدید بسازید، نوع تراکنش را «محصولات و خدمات» بگذارید و فیلد مبلغ و اطلاعات پرداخت‌کننده را انتخاب کنید.
- ۴
در اعلان‌های فرم، رویداد ارسال را «پرداخت شی‌پی موفق» بگذارید تا ایمیل فقط پس از پرداخت فرستاده شود.
- ۵
آدرس وب‌هوک نمایش‌داده‌شده در تنظیمات را در پنل شی‌پی › وب‌هوک‌ها ثبت و رمز آن را در فیلد «رمز وب‌هوک» بگذارید.
تنظیمات
- کلید API
- در «فرم‌ها › تنظیمات › شی‌پی». پس از ذخیره، درستی کلید با علامت سبز یا قرمز نشان داده می‌شود.
- واحد مبلغ فرم‌ها
- خودکار از واحد پول گرویتی فرم (IRR ریال، بقیه تومان) یا انتخاب دستی.
- فید پرداخت
- برای هر فرم: نوع تراکنش، فیلد مبلغ، توضیح پرداخت (با merge tag) و نگاشت موبایل، ایمیل و نام.
- رمز وب‌هوک
- رمز endpoint در پنل شی‌پی.
- پیام‌ها
- متن پرداخت در انتظار و ناموفق. برای پرداخت موفق، تأییدیهٔ خود فرم نمایش داده می‌شود.
تست در محیط آزمایشی
با کلید sk_test_ پول واقعی جابه‌جا نمی‌شود و در صفحهٔ بانک آزمایشی نتیجه را خودتان انتخاب می‌کنید.
- کلید
sk_test_را بگذارید. - فرم را پر کنید و در بانک آزمایشی «پرداخت موفق» را بزنید. ورودی باید «Paid» شود و کد پیگیری در یادداشت‌ها بیاید.
- حالت‌های «ناموفق» و «در انتظار» را هم امتحان کنید.
- پس از تأیید درگاه، کلید
sk_live_را جایگزین کنید.
مشکلات رایج
مبلغ در درگاه ده برابر یا یک‌دهم است.
«واحد مبلغ فرم‌ها» را با واحدی که در فرم استفاده می‌کنید (تومان یا ریال) یکی کنید.
خطای «دامنهٔ آدرس بازگشت تأیید نشده است» می‌گیرم.
آدرس سایت باید روی دامنهٔ تأییدشدهٔ درگاه در پنل شی‌پی باشد. «تست اتصال» دامنهٔ درگاه را نشان می‌دهد.
پرداخت انجام شده ولی وضعیت «در انتظار» مانده است.
احتمالاً مشتری به سایت برنگشته. وب‌هوک را در پنل شی‌پی تنظیم کنید تا وضعیت خودکار به‌روز شود.
ایمیل فرم پیش از پرداخت فرستاده می‌شود.
در تنظیمات اعلان، رویداد را از «ارسال فرم» به «پرداخت شی‌پی موفق» تغییر دهید.
تغییرات
نسخهٔ ۱.۰.۰
- نسخهٔ اول.
اولین رسیدتان را امروز صادر کنید
ثبت‌نام با شمارهٔ موبایل انجام می‌شود و تا تأیید مدارک، همه‌چیز را در محیط آزمایشی امتحان می‌کنید.