=== 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 is non-custodial: customers pay straight to the receiving wallets you set in the
easyway dashboard (Wallets). easyway never holds your funds and takes no fee per payment; it is priced by plan,
including a free one (see https://easyway.cash/pricing). Set a wallet for every network you accept before switching
to an sk_live_ key, otherwise easyway refuses to create live invoices. Over your plan's monthly allowance of live
invoices, invoice creation is refused until the next month or an upgrade.

**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 own wallet and mark the order refunded by hand.

== Changelog ==

= 0.1.0 =
* First beta.
