=== SimplyPaye Mobile Money Gateway ===
Contributors: elmigthypower, simplypaye
Tags: ecommerce, mobile money, orange money, payment gateway, drc
Requires at least: 6.6
Tested up to: 7.1
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 0.2.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Accept Mobile Money and Visa card payments on your online store via SimplyPaye.

== Description ==

SimplyPaye Mobile Money Gateway adds Orange Money, Airtel Money, M-Pesa and Visa card payments for online stores in the Democratic Republic of the Congo. It works as a payment gateway when the required e-commerce plugin dependency is installed (see Requires Plugins header).

At checkout, the customer can choose **Mobile Money** (USSD push on their phone) or **Visa card** (secure redirect).

**Trademarks:** This plugin is developed by SimplyPaye. "SimplyPaye" is the payment service operated by SimplyPaye.

**No analytics or user tracking:** The plugin does not include analytics, advertising, or behavioral tracking. It only sends payment-related data to SimplyPaye when a customer chooses this payment method at checkout.

Setup: install the required e-commerce dependency, then go to **Settings → Payments → SimplyPaye** and enter your merchant code. An optional API key is recommended for new accounts.

== External services ==

This plugin connects to third-party services operated by SimplyPaye. Data is sent only when a store owner configures the gateway and when a customer initiates or checks a payment.

= SimplyPaye Payment API =

* **What it is and why:** HTTPS API used to initiate Mobile Money payments and poll payment status after the customer confirms the USSD push on their phone.
* **Endpoint:** https://api-simply-pay.net (configurable in gateway settings; default shown above).
* **When data is sent:** On checkout when the customer submits an order with this payment method; when the order thank-you page polls for status; when SimplyPaye calls back to your store (reference and order number only).
* **Data sent:** merchant code, optional API key (header), order reference, order total, currency (CDF or USD), customer Mobile Money phone number, store order identifier.
* **Terms of service:** https://www.simply-paye.com/#terms
* **Privacy policy:** https://www.simply-paye.com/#privacy

= SimplyPaye merchant portal (onboarding) =

* **What it is and why:** Web portal where merchants create a SimplyPaye account and obtain their merchant code.
* **URL:** https://www.marchand-simplypaye.store (linked from the gateway settings screen; opened in the browser by the store administrator only).
* **When data is sent:** Only if the administrator visits the link and registers on that website (outside this plugin).
* **Terms of service:** https://www.simply-paye.com/#terms
* **Privacy policy:** https://www.simply-paye.com/#privacy

= SimplyPaye website =

* **What it is and why:** Product information and legal documents for the SimplyPaye service.
* **URL:** https://www.simply-paye.com
* **Terms of service:** https://www.simply-paye.com/#terms
* **Privacy policy:** https://www.simply-paye.com/#privacy

== Installation ==

1. Install and activate the e-commerce plugin listed in Requires Plugins.
2. Upload the plugin folder to `/wp-content/plugins/`
3. Activate through the 'Plugins' menu
4. Settings → Payments → SimplyPaye → enter merchant code

== Frequently Asked Questions ==

= Do I need a SimplyPaye merchant account? =

Yes. Register at https://www.marchand-simplypaye.store and copy your merchant code into the gateway settings.

= What dependency does this plugin require? =

See the Requires Plugins header in the main plugin file.

== Changelog ==

= 0.2.4 =
* Fix Checkout Blocks: register payment method early so SimplyPaye appears on modern checkout
* Compatible with WooCommerce 11 / block checkout pages

= 0.2.3 =
* Fix Plugin URI and legal URLs (public pages that return HTTP 200)
* Replace inline checkout `<script>` with wp_enqueue_script (checkout-fields.js)
* WooCommerce Checkout Blocks support (from 0.2.2)

= 0.2.2 =
* Support WooCommerce Checkout Blocks (fixes "no payment method available")
* Allow Store API checkout without classic form nonce
* Hide gateway when store currency is not CDF or USD
* Admin warning when currency is unsupported

= 0.2.1 =
* Update Tested up to: 7.1 for WordPress Plugin Check

= 0.2.0 =
* Checkout: choose Mobile Money (USSD push) or Visa card
* Card payments via SimplyPaye simply-production-card
* Safer load when WooCommerce is missing (admin notice, no fatal error)

= 0.1.9 =
* Fix fatal error when WooCommerce is not active (WC_Payment_Gateway not found)
* Load payment gateway only after WooCommerce is ready; show admin notice instead of crashing

= 0.1.8 =
* Remove load_plugin_textdomain() (WordPress.org loads translations automatically)

= 0.1.7 =
* Plugin Check: text domain aligned with current WordPress.org submission slug (simplypaye-for-woocommerce)
* Display name: SimplyPaye Mobile Money Gateway (no restricted terms in Plugin Name)

= 0.1.6 =
* Intended future slug: simplypaye-mobile-money-gateway

= 0.1.5 =
* External services documentation and Requires Plugins header

= 0.1.2 =
* Callback: order lookup via store transaction_id (no meta_query)

= 0.1.1 =
* Plugin Check: escaping, checkout nonce, gateway class prefix, callback query

= 0.1.0 =
* Initial release: Mobile Money gateway for SimplyPaye
* Merchant onboarding link to marchand-simplypaye.store
* Production and simulation API modes
