=== Kkhay ===
Contributors: boboaungdev
Donate link: https://kkhay.com
Tags: crypto, payment gateway, woocommerce, usdt, usdc
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: MIT
License URI: https://opensource.org/licenses/MIT

Accept non-custodial and custodial crypto payments (USDT, USDC, BNB, ETH on BSC, Polygon, Arbitrum, Base, Ethereum) in your store.

== Description ==

**K Khay** is the official payment gateway for **[K Khay](https://kkhay.com)**.

Accept payments directly to your wallet in stablecoins and popular cryptocurrencies with **zero chargebacks**, **instant on-chain verification**, and **frictionless checkout**.

### 🌟 Key Features

* **Multi-Chain Stablecoins**: Accept USDT & USDC across BNB Smart Chain (BSC), Polygon, Arbitrum, Base, and Ethereum mainnet.
* **Native Tokens**: Accept BNB and ETH directly.
* **Non-Custodial & Sovereign**: Receive payments directly into your own wallets — no third-party freezes or chargebacks.
* **Hosted Checkout Experience**: Seamless, mobile-responsive checkout UI with dynamic QR codes, real-time blockchain monitoring, and multi-network selectors.
* **Instant Payment Notifications (IPN)**: Cryptographically secured webhooks (HMAC-SHA256) update WooCommerce order statuses instantly upon on-chain settlement.
* **High-Performance Order Storage (HPOS)**: 100% compatible with modern WooCommerce HPOS database tables and Gutenberg Checkout Blocks.
* **Partial Payment Detection**: Flags underpaid orders to alert store administrators before fulfillment.
* **Self-Hosted Gateway Friendly**: Fully configurable base URL allows connecting to your private self-hosted K Khay gateway instance or the cloud gateway.

== External Services ==

This plugin relies on an external service — the **K Khay Payment Gateway API** (`https://api.kkhay.com` or your configured self-hosted gateway instance) — to create cryptocurrency payment invoices, track real-time blockchain settlement, and verify payment webhook signatures.

* **What the service is**: K Khay Sovereign Crypto Gateway provides non-custodial cryptocurrency checkout processing (USDT, USDC, BNB, ETH on BSC, Polygon, Arbitrum, Base, and Ethereum).
* **What data is sent**: When a customer selects K Khay at checkout and places an order, the plugin transmits order details including the order ID, payment amount, currency, return/cancel URLs, and your merchant API credentials to initiate the checkout session. Sensitive customer payment credentials (such as credit card numbers or private keys) are never requested, stored, or transmitted.
* **When data is sent**: Data is transmitted when a customer initiates payment at checkout, when invoice status is queried, and when receiving webhook payment callbacks.
* **Service Provider**: K Khay ([https://kkhay.com](https://kkhay.com))
* **Terms of Service**: [https://kkhay.com/terms](https://kkhay.com/terms)
* **Privacy Policy**: [https://kkhay.com/privacy](https://kkhay.com/privacy)

== Installation ==

1. Upload the `kkhay` folder to the `/wp-content/plugins/` directory, or upload `kkhay.zip` directly via **Plugins &rarr; Add New &rarr; Upload Plugin** in your WordPress admin.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Navigate to **WooCommerce &rarr; Settings &rarr; Payments**.
4. Click on **K Khay Crypto Gateway** to configure settings.
5. Enter your **Merchant API Key** and **Webhook / IPN Secret** from your [K Khay Dashboard](https://kkhay.com).
6. Copy the displayed IPN URL into your K Khay Dashboard under Webhook Settings.
7. Save changes and start accepting crypto payments!

== Frequently Asked Questions ==

= Does this plugin support WooCommerce Blocks checkout? =
Yes! K Khay fully supports both the classic WooCommerce checkout template and the new Gutenberg Cart & Checkout Blocks.

= Does this support High-Performance Order Storage (HPOS)? =
Yes. K Khay declares official compatibility with HPOS custom order tables.

= Are there any chargebacks with crypto? =
No. Blockchain payments are irreversible, completely eliminating fraudulent chargebacks.

= Where do I get my API Key? =
You can generate your merchant API keys and IPN webhook secret from your [K Khay Merchant Dashboard](https://kkhay.com).

== Changelog ==

= 1.0.0 =
* Initial release of the official K Khay Crypto Payment Gateway for WooCommerce.
* Support for USDT, USDC, BNB, ETH on BSC, Polygon, Arbitrum, Base, and Ethereum.
* Full compatibility with WooCommerce HPOS and Blocks Checkout.
* HMAC-SHA256 cryptographic webhook verification.
