=== درگاه پرداخت شی‌پی برای گرویتی فرم ===
Contributors: sheypay
Tags: gravity forms, payment gateway, iran, شی‌پی, درگاه پرداخت
Requires at least: 6.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

افزودنی پرداخت گرویتی فرم؛ فید پرداخت، اعلان‌های پرداخت و وب‌هوک.

== Description ==

افزودنی رسمی شی‌پی بر پایهٔ چارچوب Payment Add-On گرویتی فرم. برای هر فرم یک فید «محصولات و خدمات» می‌سازید و مبلغ از جمع فرم یا یک فیلد خوانده می‌شود. پس از بازگشت مشتری، پرداخت سمت سرور تأیید و وضعیت ورودی (پرداخت‌شده، در انتظار، ناموفق) ثبت می‌شود؛ اعلان‌ها را می‌توانید روی رویداد «پرداخت شی‌پی موفق» بگذارید.

* تأیید هر پرداخت سمت سرور و با مبلغ ثبت‌شده؛ به پارامترهای آدرس بازگشت اعتماد نمی‌شود.
* وضعیت «در انتظار بانک» پرداخت را ناموفق نمی‌کند و با وب‌هوک امضاشده تکمیل می‌شود.
* حالت آزمایشی با کلید sk_test_ (بدون پول واقعی).

== Installation ==

1. فایل zip را از «افزونه‌ها › افزودن › بارگذاری افزونه» نصب و فعال کنید.
2. به «فرم‌ها › تنظیمات › شی‌پی» بروید، کلید API را بگذارید و ذخیره کنید؛ علامت سبز یعنی اتصال برقرار است.
3. در تنظیمات فرم › شی‌پی یک فید جدید بسازید، نوع تراکنش را «محصولات و خدمات» بگذارید و فیلد مبلغ و اطلاعات پرداخت‌کننده را انتخاب کنید.
4. در اعلان‌های فرم، رویداد ارسال را «پرداخت شی‌پی موفق» بگذارید تا ایمیل فقط پس از پرداخت فرستاده شود.
5. آدرس وب‌هوک نمایش‌داده‌شده در تنظیمات را در پنل شی‌پی › وب‌هوک‌ها ثبت و رمز آن را در فیلد «رمز وب‌هوک» بگذارید.

== Frequently Asked Questions ==

= مبلغ در درگاه ده برابر یا یک‌دهم است. =
«واحد مبلغ فرم‌ها» را با واحدی که در فرم استفاده می‌کنید (تومان یا ریال) یکی کنید.

= خطای «دامنهٔ آدرس بازگشت تأیید نشده است» می‌گیرم. =
آدرس سایت باید روی دامنهٔ تأییدشدهٔ درگاه در پنل شی‌پی باشد. «تست اتصال» دامنهٔ درگاه را نشان می‌دهد.

= پرداخت انجام شده ولی وضعیت «در انتظار» مانده است. =
احتمالاً مشتری به سایت برنگشته. وب‌هوک را در پنل شی‌پی تنظیم کنید تا وضعیت خودکار به‌روز شود.

= ایمیل فرم پیش از پرداخت فرستاده می‌شود. =
در تنظیمات اعلان، رویداد را از «ارسال فرم» به «پرداخت شی‌پی موفق» تغییر دهید.

== Changelog ==

= 1.0.0 =
* نسخهٔ اول.
