=== Fortpesa for WooCommerce ===
Contributors: fortunedevsolutions
Tags: mpesa, woocommerce, payments, kenya, stk push
Requires at least: 6.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later

Accept M-Pesa payments in WooCommerce through Fortpesa STK Push, with live payment feedback and receipts.

== Setup ==
1. Upload and activate the plugin (WooCommerce must be active and the store currency must be KES).
2. In Fortpesa: create an API key (Settings > API keys) and note your approved Channel ID (Channels).
3. In Fortpesa: add a webhook (Settings > Webhooks) pointing to the URL shown in the gateway settings, then copy its whsec_ secret.
4. WooCommerce > Settings > Payments > Fortpesa: paste the API key, Channel ID and webhook secret, enable, save.
5. Optional: set your brand color, business name and receipt footer under "Customer experience".

== What customers see ==
* A formatted +254 number field with instant validation (classic and Blocks checkout).
* A live payment screen: request sent, enter PIN, confirming, then success or a specific reason for failure with a one-tap retry.
* A receipt page (print or Save as PDF), also linked from the order emails and My Account.

== Reliability ==
Every confirmation path (signed webhook, live polling, 5-minute cron) re-reads the transaction from the Fortpesa API before completing an order. Runtime errors are caught and logged (WooCommerce > Status > Logs, source "fortpesa") instead of breaking the site.

== Changelog ==
= 1.1.0 =
* New customer payment screen, receipts, Fortpesa branding, brand color setting.
* Hardened loading: PHP/WooCommerce version checks, duplicate-copy guard, missing-file guard, error containment.
= 1.0.0 =
* Initial release.
