Geopay

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:

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:

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.

License

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

Screenshots

  • Gateway settings page in WooCommerce
  • PIX QR Code on the payment page
  • Approved payment confirmation screen

Installation

  1. Install and activate 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.

FAQ

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, configure your PIX key, and copy the token from 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

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Geopay” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Geopay” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

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