=== Payclio for WooCommerce ===
Contributors: linusite
Tags: payments, woocommerce, payment gateway, wallet, qr, africa, namibia
Requires at least: 6.2
Tested up to: 6.7
Requires PHP: 8.1
Stable tag: 0.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Accept Payclio wallet, card, Apple Pay and Google Pay payments on your WooCommerce store via a hosted-page redirect.

== Description ==

Payclio for WooCommerce adds Payclio as a checkout option. When a customer chooses Payclio, they are redirected to a hosted page on payclio.com to pay with their Payclio wallet, debit/credit card, Apple Pay or Google Pay. Once the payment settles, the order is moved to "Processing" automatically.

Because no payment instrument data ever touches your store, you stay in PCI scope SAQ-A — the lightest PCI assessment available to ecommerce.

Supported currencies (matched against your WooCommerce store currency):

* USD
* EUR
* GBP
* NAD (Namibian dollar)
* ZAR (South African rand)

== Installation ==

1. Upload the plugin folder to `wp-content/plugins/` (or install the zip via Plugins → Add New → Upload).
2. Activate "Payclio for WooCommerce".
3. Sign up at https://payclio.com and complete merchant KYC.
4. Generate an API key at https://payclio.com/api-keys with the abilities **payment-requests:create** and **payment-requests:read**.
5. In WooCommerce → Settings → Payments, enable "Payclio" and paste your API key.

== Frequently Asked Questions ==

= Does the customer come back to my store automatically after paying? =

For now, after a successful payment the customer sees a Payclio receipt page and can manually return to your store. The plugin polls Payclio in the background for up to 10 minutes after the redirect, so the order is marked Processing even if the customer closes the tab. A return-redirect flow is coming in a future Payclio API revision.

= How are order updates detected? =

Two paths: (1) when the customer lands back on the WooCommerce thank-you page, we poll the Payclio API once. (2) An Action Scheduler job runs every minute for ~10 minutes after redirect to catch customers who never returned.

= Is this PCI compliant? =

The plugin uses hosted-redirect checkout. No card details touch your server, so you stay in PCI scope SAQ-A.

= Where do I see logs? =

WooCommerce → Status → Logs, source "payclio". Enable "Debug logging" in the gateway settings first.

== Changelog ==

= 0.1.0 =
* Initial release. Hosted-redirect checkout, polling-based settlement detection, Action Scheduler background reconciliation.
