=== ZEN.COM Payments ===
Tags: woocommerce, payments, payment gateway, checkout, zen
Requires at least: 6.5
Tested up to: 7.1
Stable tag: 2.10.1
Requires PHP: 8.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Accept payments in WooCommerce through the ZEN.COM payment gateway.

== Description ==

ZEN.COM Payments connects a WooCommerce store to the ZEN.COM payment service.
It requires an active ZEN.COM merchant account and valid integration credentials.

Features include:

* Payment methods made available for the merchant by ZEN.COM.
* Hosted checkout and embedded payment flows.
* WooCommerce block checkout and classic checkout support.
* Automatic payment status updates through ZEN.COM notifications.
* Configurable mapping between ZEN.COM transaction statuses and WooCommerce order statuses.
* Payment retries for eligible unpaid orders.
* Refund processing from WooCommerce.
* Sandbox mode for integration testing.

For configuration and compatibility information, see the [ZEN.COM WooCommerce documentation](https://docs.zen.com/payments/plugins/about-woocommerce).

== External services ==

This plugin relies on the ZEN.COM payment service to provide payment methods and process transactions. A ZEN.COM merchant account and integration credentials are required.

Depending on the merchant's configuration and the payment flow selected by the customer, the plugin communicates with production or sandbox services operated by ZEN.COM. These services are used to retrieve available payment methods, initialize and manage transactions, process refunds, verify transaction statuses, render the secure card widget, and collect device information used for payment security and fraud prevention.

The plugin connects to these ZEN.COM endpoints:

* `https://api.zen.com` and `https://secure.zen.com/api/checkouts` for production API and hosted checkout requests.
* `https://api.zen-test.com` and `https://secure.zen-test.com/api/checkouts` when sandbox mode is enabled.
* `https://cdn-secure.zen.com/zen-checkout.1.0.0.js` to load the secure card checkout widget when the embedded card flow is used.
* `https://cdn-secure.zen.com/zen-web-collector.latest.js` to collect browser and device information used for payment security when the embedded BLIK flow is used.

Data sent to ZEN.COM may include merchant credentials, order and transaction identifiers, order amount and currency, cart contents, billing and shipping information, customer contact information, return and notification URLs, and device or browser information collected by ZEN.COM payment scripts. Communication occurs when the merchant configures the integration, when payment methods are displayed, when a customer initiates or continues a ZEN.COM payment, or when the merchant manages a ZEN.COM transaction from WooCommerce.

* Service: [ZEN.COM](https://www.zen.com/)
* Integration documentation: [ZEN.COM payment plugins](https://docs.zen.com/payments/plugins/about-woocommerce)
* Terms and conditions: [ZEN.COM Terms and Conditions](https://www.zen.com/terms-and-conditions/)
* Privacy policy: [ZEN.COM Privacy Policy](https://www.zen.com/privacy-policy/)

== Installation ==

1. Install and activate WooCommerce.
2. Upload the plugin files to the `/wp-content/plugins/zen-com-payments` directory, or install the plugin through the WordPress Plugins screen.
3. Activate **ZEN.COM Payments** in the WordPress Plugins screen.
4. Go to **WooCommerce > Settings > Payments** and open the ZEN.COM payment method.
5. Enter the integration credentials from the ZEN.COM merchant panel.
6. Configure the payment presentation and order status mapping, then save the settings.

Information about integration credentials is available in the [ZEN.COM documentation](https://docs.zen.com/payments/merchant-panel/api-credentials).

== Frequently Asked Questions ==

= Is a ZEN.COM merchant account required? =

Yes. The plugin connects WooCommerce to the ZEN.COM payment service and requires valid merchant integration credentials.

= Does the plugin support WooCommerce block checkout? =

Yes. The plugin supports both WooCommerce block checkout and classic checkout.

= Can customers be redirected to ZEN.COM for payment? =

Yes. The merchant can choose between supported embedded payment flows and redirection to the ZEN.COM payment gateway.

= Does the store handle customers' card details? =

Card details are entered through the secure ZEN.COM card widget or on the hosted ZEN.COM payment page, depending on the configured payment flow.

= Where can I find configuration instructions? =

See the [ZEN.COM WooCommerce plugin documentation](https://docs.zen.com/payments/plugins/about-woocommerce).

== Changelog ==

= 2.10.1 =

* Fix issues reported during the WordPress.org review.

= 2.10.0 =

* Add `originMerchantTransactionId` using the WooCommerce order number.
* Adapt the module to WordPress.org Plugin Directory requirements.

= 2.9.3 =

* Use a unique merchant transaction ID for every payment attempt, so each attempt maps to exactly one order.
* Match payment notifications to that single order before updating it or sending a capture.
