=== Roxpay gateway === Contributors: tomaa96 Donate link: https://roxpay.eu/ Tags: payment gateway, roxpay gateway, gateway woocommerce Tested up to: 6.7 Stable tag: 1.1.6 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html RoxPay Gateway for WooCommerce. == Description == **RoxPay Gateway** adds a RoxPay payment method to WooCommerce using the RoxPay API v4. If you have any question or features request, please access the plugin's official support page: [contact](https://roxpay.eu/ "Roxpay"). == Installation == #### From within WordPress 1. Visit 'Plugins > Add New' 2. Search for 'Roxpay gateway' 3. Activate 'Roxpay gateway' for WordPress from your 'Plugins' menu from WordPress. 4. Go to WooCommerce > Settings > Payments and activate the payment method 5. Enter your API credentials and review the webhook settings #### Manually 1. Upload the roxpay-gateway/ folder to the /wp-content/plugins/ directory. 2. Activate the plugin through the 'Plugins' menu in WordPress. 3. Go to WooCommerce > Settings > Payments and activate the payment method 4. Enter your API credentials == Frequently Asked Questions == = Where can I find documentation? = Support and documentation: [You can find here all the information necessary for installing and configuring the Plugin. In addition to the assistance of our Team.](https://www.roxpay.eu/en/roxpay-gateway/). == Screenshots == 1. Active page. 2. Setting page. == External services == This plugin connects to RoxPay through the API v4 on the configured RoxPay base URL. **What the service is and what it is used for:** RoxPay gateway is a payment gateway service that allows merchants to accept online payments. This plugin integrates with RoxPay to enable users to make payments for products or services offered through your WordPress website. **What data is sent and when:** When a user initiates a payment, the plugin sends the payment amount, currency, order reference, redirect URLs, a per-payment WebhookUrl and metadata needed to reconcile the transaction. API credentials are used only for authentication and are not exposed to the customer. The plugin also exposes a local webhook endpoint. Each payment link sends this endpoint as WebhookUrl; platform-level RoxPay webhook sync is optional and existing RoxPay webhooks are left untouched. **Terms of Service and Privacy Policy:** This service is provided by Rox Pay S.r.l. * RoxPay Terms of Service: https://www.roxpay.eu/en/terms-and-conditions/ * RoxPay Privacy Policy: https://www.roxpay.eu/en/privacy-policy/ **Account Requirement:** Please note that using this plugin requires an active RoxPay merchant account. You will need to create an account on roxpay.eu and obtain the necessary API credentials to configure the plugin. This plugin does not create a RoxPay account for you. **Data Security:** The connection between your WordPress site and RoxPay's API is secured using HTTPS. Sensitive data, such as API credentials, are stored in the WordPress options table. Debug logging can be enabled from the gateway settings and is written to WooCommerce logs. == Upgrade Notice == = 1.1.6 = Prevent Checkout Block Store API fatal errors when RoxPay cannot start a payment. == Changelog == = 1.1.6 - 2026-05-10 = Return a structured WooCommerce failure result from process_payment so the Checkout Block legacy processor never receives false. = 1.1.5 - 2026-05-10 = Fix Checkout Block editor compatibility detection by using WooCommerce paymentMethodData, adding a cache-busted block script version and keeping the Blocks feature list aligned with the PHP integration. = 1.1.4 - 2026-05-10 = Support the per-payment WebhookUrl payload shape: event/payment data, data.transaction_metadata, data.payment_reference and data.id. = 1.1.3 - 2026-05-09 = Production hardening: validate webhook order key and amount, declare WooCommerce HPOS/Blocks compatibility, fix Checkout Block processing hook, avoid undocumented paylink fields and prefer RoxPay remote transaction ids for refunds. = 1.1.2 - 2026-05-09 = Send the WooCommerce callback as WebhookUrl in each RoxPay payment link and make platform webhook sync optional by default. = 1.1.1 - 2026-05-09 = Fix webhook order reconciliation by using the RoxPay payload metadata and WooCommerce transaction reference directly, without relying on the RoxPay transaction lookup endpoint. = 1.1.0 - 2026-04-28 = Refactor and API v4 migration.