=== 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.