=== Geopay ===
Contributors: geopay
Tags: pix, woocommerce, payment, geopay
Requires at least: 5.0
Tested up to: 6.9
Requires Plugins: woocommerce
Stable tag: 1.0.4
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Integrate Geopay with WooCommerce and receive PIX payments quickly and securely.

== Description ==

Geopay integrates WooCommerce with the Geopay PIX payment service, allowing the store to create PIX charges, display the QR Code to the customer, and confirm the order after payment approval.

= WooCommerce Compatibility =

The plugin is tested with current WooCommerce versions, including WooCommerce 9.x and 10.x.

= Requirements =

* WordPress 5.0 or higher
* WooCommerce 5.0 or higher
* PHP 7.4 or higher
* Geopay account with a valid authentication code

= Features =

* PIX payment gateway via Geopay API
* QR Code display on checkout or on a temporary payment page
* Optional countdown timer on the PIX payment page
* Payment confirmation after Geopay approval
* Compatible with CheckoutWC by using the temporary page mode
* Documentation tab inside the gateway settings screen
* Customizable texts for buttons, messages, and payment page content

= Third-Party Service: Geopay =

This plugin connects to the Geopay service to process PIX payments.

It is required to create the PIX charge and verify the payment status.

Service provider:

* Geopay - [https://geopay.digital](https://geopay.digital)

When the plugin connects to the service:

* When the customer generates the PIX payment
* When the plugin requests the QR Code
* When the plugin checks whether the payment was approved

Data sent to the service:

* Merchant authentication code configured in the plugin
* Order ID
* Store URL
* Order total
* Product line items
* Customer name
* Customer email
* Customer phone
* Billing address
* Shipping address

Data stored locally by the plugin:

* Geopay cart ID in WooCommerce order meta
* Geopay status token in WooCommerce order meta
* Temporary QR Code page payload in a transient for up to 15 minutes

Why the data is sent:

* To create the PIX charge
* To generate the QR Code or copy-and-paste PIX code
* To verify payment status and update the WooCommerce order

How long the data is retained:

* Temporary PIX page data expires automatically after up to 15 minutes
* Geopay payment identifiers stored in WooCommerce order meta are retained with the order record unless removed through site privacy tools or order retention policies

Privacy and data rights:

* Site administrators can use the built-in WordPress privacy tools to export plugin-related Geopay data
* The plugin removes the Geopay status token during personal data erasure requests when possible
* Some payment identifiers may be retained as part of accounting and payment records
* WooCommerce remains responsible for the main order and customer record stored on the site

Service terms and legal information:

* Terms of Use: [https://geopay.digital/termos-de-uso/](https://geopay.digital/termos-de-uso/)
* Privacy Policy: [https://geopay.digital/politica-de-privacidade/](https://geopay.digital/politica-de-privacidade/)

= Third-Party Libraries =

This plugin bundles `qrcodejs` in `assets/js/qrcode.min.js`, licensed under the MIT license. See `THIRD-PARTY-LICENSES.txt` for details.

== Installation ==

1. Install and activate [WooCommerce](https://wordpress.org/plugins/woocommerce/).
2. Upload the Geopay plugin to `/wp-content/plugins/` or install it from the WordPress admin.
3. Activate **Geopay** in the Plugins screen.
4. Go to **WooCommerce > Settings > Payments**.
5. Open **Geopay Gateway PIX** and click **Manage**.
6. Paste your authentication code in the gateway settings.
7. Save the changes.

For the step-by-step guide with screenshots, open **WooCommerce > Settings > Payments > Geopay > Documentacao**.

== Screenshots ==

1. Gateway settings page in WooCommerce
2. PIX QR Code on the payment page
3. Approved payment confirmation screen

== Frequently Asked Questions ==

= Does the plugin work without WooCommerce? =

No. Geopay requires WooCommerce to be active.

= Where do I get the authentication code? =

Create an account at [https://app.geopay.digital/register](https://app.geopay.digital/register), configure your PIX key, and copy the token from [https://app.geopay.digital/platforms](https://app.geopay.digital/platforms).

= Does it work with CheckoutWC? =

Yes. Use the temporary payment page option in the gateway settings.

= Where can I find the documentation? =

Open **WooCommerce > Settings > Payments > Geopay > Documentacao**.

= What display modes are available? =

* Checkout page
* Temporary payment page

== Changelog ==

= 1.0.4 =

* WordPress.org compliance improvements for scripts and styles
* Added native defer strategy for enqueued scripts
* Moved plugin documentation into the WooCommerce gateway settings tabs
* Added third-party service disclosure for Geopay
* Added distribution ignore rules for development-only files
* Removed legacy files and temporary test artifacts
* Removed global bootstrap filters that could affect other plugins

= 1.0.3 =

* Text Domain updated to `geopay`
* Added translation files in `languages/`
* Improved escaping and placeholder handling

= 1.0.2 =

* Added nonces to AJAX requests
* Added status validation before marking orders as paid
* Improved request validation and error handling

= 1.0.1 =

* Settings and design improvements

= 1.0.0 =

* Initial release

== License ==

This plugin is licensed under GPLv2 or later. See the `LICENSE` file in the plugin directory.
