=== GatewayKit – Payment Gateway for Elementor Forms ===
Contributors: pourmirzai
Tags: elementor, payment, paypal, elementor forms, payment gateway
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Accept PayPal payments directly through Elementor Pro Forms. Upgrade to GatewayKit Pro for Stripe, Mollie, and CoinGate.

== Description ==

GatewayKit lets you accept payments through Elementor Pro Forms using PayPal, with more gateways coming soon.

Build a fully customized Elementor form with your own fields and place it on any page. When a visitor submits the form, they are redirected to PayPal to complete the payment — no shopping cart or WooCommerce required.

It is designed for sites that need simple payment forms where a full e-commerce setup would be unnecessary.

For full documentation and demos, visit [GatewayKit website](https://gatewaykit.pourmirzai.com/).

**Features**

* PayPal Orders REST API v2 integration (redirect-based hosted checkout).
* Sandbox / Live mode toggle for safe testing.
* Fixed or dynamic amounts (pull the price from a form field).
* Transaction management dashboard with filtering, search, and CSV export.
* Secure, non-guessable receipt tokens with a payment result shortcode (`[gatewaykit_receipt]`).
* Built-in security: input sanitization, output escaping, nonce verification, rate limiting, and secure logging with sensitive-data redaction.

**GatewayKit Pro (optional)**

Unlock Stripe, Mollie, and CoinGate payment gateways, plus advanced features.

Learn more at [GatewayKit website](https://gatewaykit.pourmirzai.com/).

* Discount code system (fixed / percentage, usage limits, per-user limits, validity dates).
* Advanced Transaction Log with multi-gateway filtering and CSV export.
* Per-form success / failure redirect pages.


== Installation ==

1. Install and activate **Elementor** and **Elementor Pro** (the Forms module is required).
2. Upload the `gatewaykit` plugin folder to `/wp-content/plugins/` or install it via Plugins → Add New → Upload Plugin.
3. Activate **GatewayKit** through the Plugins screen.
4. Go to **GatewayKit → Settings** and enable PayPal or any other gateway you want, then enter your Client ID and Client Secret.
5. Create an Elementor Pro Form, then under **Actions After Submit** replace **Collect Submitions** with  **Payment Gateway**.
6. Configure the gateway, amount, and success/failure redirect pages.
7. Create a result page and add the shortcode `[gatewaykit_receipt]`.

== Frequently Asked Questions ==

= Does this require Elementor Pro? =

Yes. The Elementor Pro Forms module is required because GatewayKit is an "Actions After Submit" handler for Elementor forms.

= Which payment methods are included in Lite? =

PayPal is included in the free plugin. Stripe, Mollie, and CoinGate are available in the optional GatewayKit Pro add-on.

= Are payment credentials stored securely? =

Yes!

== Screenshots ==

1. GatewayKit dashboard with payment overview and recent transactions.
2. Settings page with gateway configuration.
3. Transaction management list with filters and bulk export.

== Changelog ==

= 1.0.0 =
* Initial release

== External Services ==

This plugin connects to PayPal's API to process payments.

= What is sent and when =

When a user submits a payment form, the plugin sends the payment amount, currency, and a transaction reference to PayPal's servers for authorization and capture. No personal user data beyond what PayPal requires for payment processing is transmitted.

= PayPal =

* API Endpoint (Live): https://api-m.paypal.com
* API Endpoint (Sandbox): https://api-m.sandbox.paypal.com
* Terms of Service: https://www.paypal.com/us/legalhub/useragreement-full
* Privacy Policy: https://www.paypal.com/us/legalhub/privacy-full

== Upgrade Notice ==

= 1.0.0 =
First release. Accept PayPal payments through Elementor Pro Forms. Upgrade to GatewayKit Pro for Stripe, Mollie, and CoinGate.
