=== Instant MPESA Purchase ===
Contributors: mbitrixtech
Tags: mpesa, stk push, wooCommerce, payments, kenya
Requires at least: 5.0
Tested up to: 6.8
Requires PHP: 7.2
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Enable instant MPESA payments via STK Push directly from your WooCommerce product pages. Fast, simple, and tailored for Kenya.

== Description ==

This plugin allows customers to pay for individual WooCommerce products directly via MPESA STK Push — no checkout, no cart, just a quick transaction. Perfect for businesses selling single products, digital content, tickets, or services.

**Features:**

- MPESA STK Push Integration (Safaricom)
- Works with WooCommerce products
- Display payment form under products on shop pages
- Instant callback and order recording
- Custom admin settings for API credentials and notification email
- Optional email notifications on payment success

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/instant-mpesa-purchase` directory or install it via the WordPress plugin installer.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to **MPESA Sales > M-PESA Settings** and configure your:
   - Consumer Key
   - Consumer Secret
   - Shortcode
   - Passkey
   - Notification Email
   - Checkbox to enable/disable showing form on product pages
4. Make sure your MPESA Daraja API app is approved and production credentials are used.

== Usage ==

Once configured:
- Customers will see an M-PESA payment form under each product (if enabled).
- Upon entering a phone number and clicking "Pay with MPESA", an STK push is triggered.
- On successful payment, the order is recorded and a notification email is sent (if configured).

== Frequently Asked Questions ==

= Does this plugin support cart or multi-product checkout? =
No, it is designed for single product instant purchase use cases.

= Does this work in sandbox mode? =
Not currently. It is configured for production use.

= Can I customize the form appearance? =
Yes, by overriding the template or using custom CSS.

== Changelog ==

= 1.0.0 =
* Initial release

== Credits ==

Special credit and heartfelt thanks to **Dr. Daniel Katambo - CEO AfyaCode LTD** for inspiration, support, and contribution to the development of this plugin.

== License ==

This plugin is licensed under the GPLv2 or later.
