=== easyway Crypto Payments ===
Contributors: easyway
Tags: crypto, payments, usdt, bitcoin, woocommerce
Requires at least: 6.0
Tested up to: 6.6
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 crypto payments in WooCommerce through the easyway hosted checkout.

== Description ==

Adds "Pay with crypto" to the WooCommerce checkout (classic and block checkout). When the customer places an order,
the plugin creates an easyway invoice for the order total and sends the customer to the easyway payment page, where
they pick a coin and pay. easyway sends a signed webhook back to your store and the order is updated:

* paid → the order is marked paid (once, repeats are ignored);
* underpaid → the order goes on hold with a note; the customer can top up from the payment page;
* expired / cancelled → the order is cancelled if it is still waiting for payment.

**Fees and custody.** easyway takes its platform fee from each confirmed payment. Your balance is held by easyway
until you withdraw it to your own whitelisted wallets. See https://easyway.cash for current fees.

**Currency.** The store currency must be USD. easyway prices invoices in USD (or directly in a crypto asset) and has
no other fiat currencies, so with any other store currency the payment method is hidden and an admin notice explains why.

**Status: beta — not yet tested on a live store.**

= External service =

This plugin talks to the easyway API at https://api.easyway.cash to create and read invoices, and the customer is
sent to the easyway payment page. Order total, order id, order key, order number and the billing email are sent
when an invoice is created. Terms and privacy policy: https://easyway.cash

== Installation ==

1. Upload the `easyway-crypto-payments` folder to `/wp-content/plugins/`, or upload the zip in Plugins → Add New.
2. Activate the plugin. WooCommerce must be active and the store currency must be USD.
3. In easyway, Dashboard → Developers → API keys, create a secret key with the invoices:write and invoices:read scopes.
4. In easyway, Dashboard → Developers → Webhooks, add your webhook URL `https://YOUR-SHOP/?wc-api=easyway` with the
   invoice.* events, and copy the endpoint's signing secret.
5. WooCommerce → Settings → Payments → easyway (crypto): enable it, paste the API key and the signing secret.

== Frequently Asked Questions ==

= How do I test without real money? =

Use an `sk_test_` key and a test-mode webhook endpoint (it has its own signing secret). Place an order, then open the
invoice in the easyway dashboard and press "Simulate payment". The order should move to Processing.

= Does it support refunds? =

Not from WooCommerce. Refund the customer from your easyway balance and mark the order refunded by hand.

== Changelog ==

= 0.1.0 =
* First beta.
