=== Lango Payments for WooCommerce ===
Contributors: lango
Tags: ecocash, zimbabwe, payments, mobile money, woocommerce
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 0.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Accept EcoCash payments in Zimbabwe through Lango. Every fee itemised before it is charged.

== Description ==

Lango is a payment gateway built in Harare for how Zimbabwe actually pays. This plugin adds
EcoCash (via Lango) as a WooCommerce payment method:

* Customers pay on Lango's hosted checkout — built for 3G and small phones, works with
  JavaScript disabled, and never shows "failed" while the network is still deciding.
* Orders are marked paid only after the plugin verifies the webhook signature AND confirms
  the status with the Lango API. A forged callback cannot mark an order paid.
* Payments still being confirmed with EcoCash put the order on hold with a clear note —
  never cancelled, so nobody asks a customer who already paid to pay again.
* Refund from the WooCommerce order screen; the Lango payment id is stored on every order
  for support.
* Test mode with a visible banner: use your sk_test_ key, pay with the sandbox numbers,
  then swap in the live key.

Supported currencies: USD and ZWG. You need a Lango account: https://lango.co.zw

== Installation ==

1. Install and activate the plugin.
2. WooCommerce → Settings → Payments → Lango (EcoCash) → Manage.
3. Paste your API key from the Lango dashboard (Developers page). A sk_test_ key runs in
   test mode.
4. In the Lango dashboard, create a webhook endpoint pointing at
   `https://your-site/wc-api/lango` and paste its signing secret into the plugin settings.
5. Enable the gateway. Place a test order with the sandbox number 263771000001.

== Frequently Asked Questions ==

= Why is an order "on hold" with a note about confirmation? =

The mobile network did not answer when Lango asked whether the payment went through, so
Lango keeps asking (for up to 24 hours). The order updates automatically when the truth
arrives. Do not ask the customer to pay again — they may already have paid.

= Does the customer need an app? =

No. They approve the payment with their EcoCash PIN on their own phone.

== Changelog ==

= 0.1.0 =
* First release: hosted checkout, signed webhooks with API confirmation, refunds,
  test mode, honest handling of uncertain payment states.
