=== KasperoPay for WooCommerce ===
Contributors: kasperolabs
Tags: woocommerce, payment, kaspa, cryptocurrency, crypto
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.2
Stable tag: 1.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Accept Kaspa cryptocurrency payments on your WooCommerce store with instant confirmation and multiple wallet support.

== Description ==

KasperoPay for WooCommerce lets merchants accept Kaspa (KAS) payments directly on their store. Prices display in your store's currency and convert to KAS at the live exchange rate at checkout.

**Features:**

* Instant confirmation (~1 second block times)
* Multiple wallet support (browser extensions, mobile, QR code)
* Works with both Classic and Block-based WooCommerce checkout
* Automatic currency conversion (USD, EUR, and other fiat currencies to KAS)
* Low transaction fees (1-3.5%)
* No chargebacks
* No monthly or setup fees

**Supported Wallets:**

* Kasware (Browser Extension)
* Kastle (Browser Extension)
* Keystone (OAuth - works on all devices)
* Mobile Wallet (kaspa: URI scheme)
* Kasanova (Mobile App)
* QR Code (any wallet)

**Why KasperoPay?**

* Works with 6+ wallet types — customers aren't locked into one wallet
* Merchant dashboard with analytics at kaspa-store.com/merchant
* Customizable button styles to match your store theme
* Professional payment widget with live KAS conversion
* Webhook + AJAX dual verification for reliability

== Installation ==

1. Upload the plugin zip via Plugins > Add New > Upload Plugin
2. Activate the plugin
3. Go to WooCommerce > Settings > Payments
4. Enable KasperoPay and click Manage
5. Enter your Merchant ID from [kaspa-store.com/merchant](https://kaspa-store.com/merchant)
6. Select which wallets to offer at checkout
7. Save changes and start accepting Kaspa

== Frequently Asked Questions ==

= Do I need a KasperoPay account? =
Yes. Sign up at [kaspa-store.com/merchant](https://kaspa-store.com/merchant) to get your Merchant ID.

= Do I need to manage wallet addresses? =
No. KasperoPay handles address generation and payment routing automatically through the merchant dashboard. You just need your Merchant ID.

= What are the fees? =
Between 1% and 3.5% per transaction depending on your plan. No monthly fees, no setup fees.

= Does it work with the new Block checkout? =
Yes. The plugin supports both Classic and Block-based WooCommerce checkout.

= What currencies can my store use? =
Your store prices in any WooCommerce-supported currency. KasperoPay converts to KAS at the live exchange rate at checkout.

= How fast are payments confirmed? =
Kaspa confirms transactions in approximately 1 second.

= How is this different from other Kaspa payment plugins? =
KasperoPay supports multiple wallet types (browser extensions, mobile, OAuth, QR code) while most alternatives only support a single wallet. KasperoPay also provides a merchant dashboard for tracking payments and analytics.

= Where can I get support? =
Visit [kaspa-store.com/merchant](https://kaspa-store.com/merchant) or reach out via the Kaspa Discord community.

== Screenshots ==

1. Payment method selection at checkout
2. KasperoPay settings page in WooCommerce
3. Payment confirmation screen

== External services ==

This plugin connects to the KasperoPay payment processing API hosted at kaspa-store.com to process Kaspa cryptocurrency payments.

= KasperoPay Payment Processing (kaspa-store.com/merchant) =

**What the service does:** Processes Kaspa cryptocurrency payments, converts fiat prices to KAS amounts, and confirms blockchain transactions.

**When data is sent:**
* The KasperoPay payment widget JavaScript is loaded from kaspa-store.com when a customer visits the checkout page.
* When a customer initiates a Kaspa payment, the order total and currency are sent to calculate the KAS amount.
* After payment, the plugin verifies the transaction status with the KasperoPay API.

**What data is sent:** Order total, store currency, and a generated payment reference. No customer personal data (name, email, address) is transmitted to KasperoPay.

* Service website: [https://kaspa-store.com/merchant](https://kaspa-store.com/merchant)
* Terms of Service: [https://kasperolabs.com/terms.html](https://kasperolabs.com/terms.html)
* Privacy Policy: [https://kasperolabs.com/privacy.html](https://kasperolabs.com/privacy.html)
== Changelog ==

= 1.2.0 =
* Centered payment screen layout
* Dual USD/KAS price display on checkout
* Fixed item names in payment modal
* Branded button styling (navy/teal)
* Auto-trigger payment after Keystone OAuth return
* Added "All Wallets" option in settings

= 1.1.1 =
* Fixed currency conversion for QR code and mobile payment flows
* Local plugin icon (no external image dependency)
* Cache busting on version update

= 1.1.0 =
* Added WooCommerce Blocks checkout support
* Improved payment verification
* Fixed nonce security handling

= 1.0.0 =
* Initial release