=== Mocky M-Pesa STK Push ===
Contributors: mocky
Tags: mpesa, daraja, woocommerce, stk push, payments
Requires at least: 6.2
Tested up to: 6.5
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Developer-ready Safaricom Daraja M-Pesa STK Push integration for WooCommerce products, services, downloads, and standalone WordPress payment forms.

== Description ==

Mocky M-Pesa STK Push lets WordPress developers add M-Pesa payments by entering Daraja credentials and copying the generated callback URL into Safaricom Daraja. It supports physical products, services, virtual products, digital downloads, invoices, and custom payment forms.

The plugin includes a free 24-hour domain trial, then annual paid access at KES 1,000 per domain per year. It includes annual license enforcement, WooCommerce checkout, shortcode checkout, callback handling, status polling, WP-Cron recovery, and an admin transaction log.

== Installation ==

1. Upload the plugin folder or zip through WordPress admin.
2. Activate the plugin.
3. Open Mocky M-Pesa from the admin menu.
4. Start the free 24-hour trial, buy the annual domain license, or activate an existing license.
5. Add Daraja credentials and select sandbox or production.
6. Copy the callback URL into the Daraja app.
7. Test Daraja authentication.
8. Enable the WooCommerce gateway for products/services/downloads or add the shortcode to a page.

== Licensing ==

Each domain can start one free 24-hour trial. Paid licenses are valid for one domain for one year. Renewals are paid through M-Pesa STK Push to Mocky's configured PayBill. Expired trials or licenses block new payment initiation until annual payment is confirmed.

== Shortcode ==

`[mocky_mpesa_checkout amount="1000" reference="INV-1001" description="Invoice payment"]`

Use the shortcode amount as the full payable price for services, downloads, products, invoices, or custom payments. WooCommerce checkout uses the full order total automatically.

== Changelog ==

= 1.0.0 =
* Initial commercial release.
