=== WooCommerce FaciPay Gateway ===
Contributors: facix, faciconnect, facipayteam
Tags: woocommerce, payments, gateway, facipay, angola, mcx express
Requires at least: 6.9
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 0.1.49
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Accept payments easily and securely in your WooCommerce store using FaciPay, MCX Express, and REF EMIS.

== Description ==

WooCommerce FaciPay Gateway is an **all-in-one payment solution** for Angolan merchants to accept payments via **FaciPay**, including **MCX Express** (mobile payments) and **REF EMIS** (reference payments).

= Features =

* **Seamless checkout integration** - No confusing redirects, payments happen directly in your store
* **Multiple payment methods** - FaciPay, MCX Express, and REF EMIS supported
* **Secure transactions** - Real-time status callbacks and encrypted communications
* **WooCommerce Blocks support** - Compatible with the new block-based checkout
* **Classic checkout support** - Works with traditional WooCommerce checkout and page builders (Elementor, FunnelKit, etc.)
* **Test/Production environments** - Easy switching between sandbox and live modes
* **Debug logging** - Optional logs for troubleshooting (recommended in sandbox)
* **High-Performance Order Storage (HPOS)** - Compatible with WooCommerce's modern order storage

= Why FaciPay? =

FaciPay is a trusted payment gateway in Angola, offering:

* **Instant payments** via MCX Express mobile wallet
* **Reference payments** via REF EMIS for bank transfers
* **Fraud protection** and secure transaction processing
* **Local support** for Angolan merchants

= Get Started =

New to FaciPay? [Request your credentials](https://faciconnect.com/woocommerce-facipay).
Already have an account? Activate the gateway in **WooCommerce > Settings > Payments > FaciPay** and enter your credentials.

== Installation ==

= Requirements =

* WordPress 6.9 or higher
* WooCommerce 9.6 or higher
* PHP 7.4 or higher
* FaciPay merchant account (test and/or production credentials)

= Installation Steps =

1. Upload the plugin `.zip` file via **Plugins > Add New > Upload Plugin**
2. Activate the plugin in **Plugins > Installed Plugins**
3. Go to **WooCommerce > Settings > Payments** and enable **FaciPay**
4. Enter your API credentials (Test/Live) and save

= Configuration =

1. In **Payments > FaciPay**, select your **Environment** (Test/Live)
2. Enter your **Publishable Key** and **Secret Key**
3. Configure webhook URLs if required
4. Save and make a test payment

= Updating =

Automatic updates work smoothly, but we recommend backing up your site before updating. If you encounter issues after an update, please clear your cache and contact support.

== Frequently Asked Questions ==

= In which countries is FaciPay available? =

FaciPay is currently available in Angola. Support for other countries is planned for future releases.

= Does this plugin support WooCommerce Subscriptions? =

Not yet. Subscription support is on our roadmap for future releases.

= Can I use sandbox/test mode? =

Yes. In **WooCommerce > Settings > Payments > FaciPay**, select **Test** environment and use your sandbox credentials to test payments without real transactions.

= Does this plugin work with WooCommerce Blocks checkout? =

Yes! The plugin fully supports both the new WooCommerce Blocks checkout and the classic checkout.

= Does this plugin work with page builders like Elementor or FunnelKit? =

Yes. The plugin is compatible with popular page builders that use the classic WooCommerce checkout.

= Is this plugin compatible with High-Performance Order Storage (HPOS)? =

Yes. The plugin is fully compatible with WooCommerce's High-Performance Order Storage feature.

= Where can I find documentation? =

Visit our [documentation page](https://faciconnect.com/woocommerce-facipay) for detailed setup instructions and troubleshooting guides.

= Where can I get support? =

For support, please visit [https://faciconnect.com/woocommerce-facipay](https://faciconnect.com/woocommerce-facipay) or contact our support team.

= Where do I report security vulnerabilities? =

Please report security issues directly to our team at [https://faciconnect.com/security](https://faciconnect.com/security). We take security seriously and will respond promptly.

== Screenshots ==

1. FaciPay payment method visible at checkout
2. FaciPay gateway settings page (API & Environment configuration)
3. FaciPay payment popup with MCX Express option
4. Order confirmation with FaciPay payment details

== Changelog ==

= 0.1.49 - 2025-12-15 =
* Feat - Added reference info to the into order details
* Fix - Adjusted order name limit presentation

= 0.1.48 - 2025-12-12 =
* Fix - Adjusted order name max limit to 50

= 0.1.47 - 2025-12-12 =
* Fix - Adjusted showing customer info in popup and in order details

= 0.1.46 - 2025-12-11 =
* Fix - Adjusted block checkout to get customer data from form to FaciPay SDK

= 0.1.45 - 2025-12-10 =
* Fix - Adjusted validation to ignore hidden form fields
* Fix - Fixed popup blocker issue by opening popup immediately on click

= 0.1.43 - 2025-12-09 =
* Fix - Resolved conflict in standard checkout payment flow layout
* Fix - Improved compatibility with page builders (Elementor, FunnelKit)
* Fix - Classic checkout implementation for builders that only support this version

= 0.1.40 - 2025-12-09 =
* Fix - Standard checkout payment flow adjustments

= 0.1.39 - 2025-12-09 =
* Fix - Standard checkout payment flow adjustments

= 0.1.37 - 2025-12-08 =
* Fix - FaciPay payment flow through checkout screen

= 0.1.34 - 2025-12-06 =
* Fix - Corrected path for WC_FaciPay_Encryption class

= 0.1.33 - 2025-09-25 =
* Tweak - Tested compatibility with WordPress 6.8.x
* Tweak - Improved error handling and logging
* Tweak - UI adjustments in settings page

= 0.1.5 - 2025-08-01 =
* Initial public release for internal testing

== Upgrade Notice ==

= 0.1.45 =
Important fix for popup blocker issues. Update recommended for all users.

= 0.1.43 =
Compatibility improvements for page builders. Update if using Elementor or FunnelKit.
