=== KiraPay for WooCommerce ===
Contributors: menganinithin
Tags: crypto, payments, woocommerce, cryptocurrency, blockchain
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
WC requires at least: 7.0
WC tested up to: 9.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Accept crypto payments from any token on any chain. Funds go directly to your wallet — non-custodial.

== Description ==

KiraPay is a non-custodial cross-chain crypto payment gateway. Your customers pay with any cryptocurrency on any chain (Ethereum, Base, Solana, Polygon, and more), and funds land directly in your wallet — KiraPay never holds your money.

**Key features:**

* Pay with any token, any chain — your customer picks what's easiest for them
* You receive in your preferred token and chain (e.g. USDC on Base)
* Cross-chain routing handled automatically via bridges
* Card payments via on-ramp (no crypto wallet needed for your customer)
* Non-custodial — direct wallet to wallet, always
* No mandatory KYC
* Refunds supported from WooCommerce admin
* Full HPOS (High-Performance Order Storage) compatibility

**How it works:**

1. Customer reaches checkout and selects KiraPay as the payment method
2. They click Place Order
3. Plugin creates a single-use KiraPay payment link via the KiraPay API
4. Customer is redirected to checkout.kira-pay.com to complete payment
5. KiraPay fires a webhook to the store when payment is confirmed
6. Order is automatically marked as paid

== Installation ==

1. Upload the `kirapay` folder to `/wp-content/plugins/`
2. Activate the plugin via **Plugins → Installed Plugins**
3. Go to **WooCommerce → Settings → Payments → KiraPay**
4. Enter your API Key and Webhook Secret from your [KiraPay dashboard](https://kira-pay.com)
5. Enter your merchant wallet address and preferred settlement chain and token
6. Set your webhook URL in the KiraPay dashboard to: `https://yourstore.com/wp-json/kirapay/v1/webhook`
7. Enable the gateway and save

== Frequently Asked Questions ==

= Where do I get an API key? =
Sign up at [kira-pay.com](https://kira-pay.com) and go to API Keys in your dashboard.

= What is the webhook URL I should enter in KiraPay? =
`https://yourstore.com/wp-json/kirapay/v1/webhook` — replace yourstore.com with your actual domain.

= Which chains are supported? =
All major EVM chains plus Solana. See [kira-pay.com](https://kira-pay.com) for the full list.

= Do I need to hold crypto to use this? =
No. You set your preferred settlement token (e.g. USDC on Base) and KiraPay handles all conversions. Your customer can even pay by credit card via on-ramp.

= Is there a fee? =
KiraPay charges a small protocol fee per transaction. See [kira-pay.com](https://kira-pay.com) for current rates.

= How do refunds work? =
Initiate a refund from WooCommerce admin as usual. The plugin will call the KiraPay API to process the refund back to the customer.

= Does this plugin work with WooCommerce Blocks checkout? =
The plugin works with the classic WooCommerce shortcode checkout. If you are using the Blocks-based checkout, switch the checkout page to use the `[woocommerce_checkout]` shortcode instead.

= Is there a sandbox or test mode? =
KiraPay does not provide a sandbox environment. All transactions use the live API.

== Third-Party Services ==

This plugin connects to the following external services operated by KiraPay:

* **api.kira-pay.com** — Used to create payment links and process refunds. Your API key, order total, currency, wallet address, and order ID are sent when a customer places an order.
* **checkout.kira-pay.com** — The hosted checkout page your customers are redirected to in order to complete payment. No data is sent by the plugin directly; the customer interacts with this page themselves.

These services are provided by KiraPay. By using this plugin you agree to the [KiraPay Terms of Service](https://kira-pay.com/terms) and [Privacy Policy](https://kira-pay.com/privacy).

== Screenshots ==

1. KiraPay payment option at WooCommerce checkout
2. KiraPay settings page in WooCommerce admin

== Changelog ==

= 1.0.0 =
* Initial release

== Upgrade Notice ==

= 1.0.0 =
Initial release.
