=== ZyvoPay for WooCommerce ===
Contributors: zyvopay
Tags: usdt, crypto, payments, tether, woocommerce
Requires at least: 6.0
Tested up to: 6.6
Requires PHP: 7.4
WC requires at least: 7.0
WC tested up to: 9.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Accept USDT payments in WooCommerce through the ZyvoPay hosted checkout.

== Description ==

ZyvoPay for WooCommerce adds a "Pay with USDT" payment method. At checkout the customer is redirected to the secure ZyvoPay payment page, pays in USDT on any network enabled on your ZyvoPay account, and returns to the order confirmation page. Orders are updated automatically through signed webhooks.

* Works with the classic checkout and the Cart/Checkout blocks.
* Compatible with High-Performance Order Storage (HPOS).
* Choose who pays the fees: the customer or the merchant.
* Optional default network, or let the customer choose.
* Idempotent invoices: retrying payment never creates duplicates.
* Webhooks are verified with HMAC-SHA256 signatures.

Order status handling:

* `invoice.paid` / `invoice.overpaid`: payment completed, so the order moves to Processing (or Completed for virtual/downloadable orders, following WooCommerce rules).
* `invoice.partially_paid`: order set to On hold with a note for manual review.
* `invoice.expired`: order cancelled if it is still Pending payment.
* `invoice.confirming`: an order note is added.

== Installation ==

1. Upload the `zyvopay-woocommerce` folder to `/wp-content/plugins/`, or use Plugins > Add New > Upload Plugin with `zyvopay-woocommerce.zip`.
2. Activate the plugin.
3. Go to WooCommerce > Settings > Payments > ZyvoPay (USDT).
4. Enter your Public key, API secret and Webhook secret from the ZyvoPay dashboard.
5. Optional: set the fee payer, a default network (for example TRC20), the invoice lifetime and the API base URL.
6. The webhook URL is shown under the Webhook secret field (`https://your-site/?wc-api=zyvopay`). It is sent with every invoice automatically.

The store currency must be USD (or USDT). Other currencies can be allowed with the `zyvopay_supported_currencies` filter, but invoices are always priced 1:1 in USDT.

== Frequently Asked Questions ==

= Where are the logs? =

WooCommerce > Status > Logs, source `zyvopay`. Errors are always logged. Enable "Debug log" for full request and webhook logging.

= The order did not update after payment =

Check that your site is reachable from the internet, the Webhook secret matches the one in your ZyvoPay dashboard, and no security plugin or firewall blocks POST requests to `/?wc-api=zyvopay`.

== Changelog ==

= 1.0.0 =
* Initial release.
