=== CryptoPayr for WooCommerce ===
Contributors: disturbingsilence
Tags: crypto, bitcoin, ethereum, payment gateway, cryptocurrency
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Accept cryptocurrency payments in WooCommerce with CryptoPayr — Bitcoin, Ethereum, USDT, USDC and 110+ coins across every major network.

== Description ==

CryptoPayr for WooCommerce lets your store accept cryptocurrency at checkout. When a customer chooses CryptoPayr they are sent to a hosted CryptoPayr checkout to pick a coin and network and pay. The order is then completed automatically by a signed webhook (HMAC-SHA256 with your store's API key) — no manual reconciliation.

One plugin covers every WooCommerce checkout:

* Accept Bitcoin, Ethereum, USDT, USDC and 110+ coins across major networks.
* Works with any fiat store currency — CryptoPayr prices the crypto for the buyer.
* Supports the classic (shortcode) checkout **and** the block-based Cart and Checkout.
* Declares High-Performance Order Storage (HPOS) compatibility.
* Orders are confirmed server-to-server by a signed webhook; the order only completes when the paid amount and currency match.
* No chargebacks — crypto payments are final once confirmed on-chain.

A free CryptoPayr merchant account and API key are required. See the External services section below for exactly what data is sent.

== External services ==

This plugin connects to the CryptoPayr payment gateway API to create hosted crypto-checkout sessions and to receive payment confirmations. This connection is required for the plugin to process payments; without it the gateway cannot function.

Service provider: CryptoPayr — https://cryptopayr.com

What is sent and when:

* When a customer places an order and selects CryptoPayr, the plugin sends the order total, the order currency, the WooCommerce order id, and your store's return, cancel and webhook URLs to https://cryptopayr.com/api/v1/payment/create to start a hosted checkout session. Your CryptoPayr secret API key is sent in the request's Authorization header to authenticate your store.
* CryptoPayr then notifies your store of the payment result by posting a signed webhook back to your site's WooCommerce API endpoint.
* This plugin does not transmit customer personal data (name, email, billing or shipping address). Only the amount, currency and order id are sent.

By using this plugin you agree to CryptoPayr's terms and privacy policy:

* Terms of Service: https://cryptopayr.com/legal/terms
* Privacy Policy: https://cryptopayr.com/legal/privacy

== Installation ==

1. Upload the plugin to `/wp-content/plugins/`, or install the .zip via **Plugins → Add New → Upload Plugin**.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Go to **WooCommerce → Settings → Payments → CryptoPayr**.
4. Enter your CryptoPayr API key (from your CryptoPayr dashboard → Developers) and enable the method.
5. Place a small test order to confirm the end-to-end flow.

== Frequently Asked Questions ==

= Do I need a CryptoPayr account? =
Yes. Create a free merchant account at https://cryptopayr.com and copy your API key from Dashboard → Developers.

= Which checkout does it support? =
Both. It works with the classic shortcode checkout and the block-based Cart and Checkout, and it declares HPOS compatibility.

= Which cryptocurrencies can my customers use? =
Bitcoin, Ethereum, USDT, USDC, BNB, Litecoin and 110+ more across multiple networks. Buyers choose their coin and network at the hosted checkout.

= How are orders confirmed? =
CryptoPayr posts a signed webhook to your store when payment completes. The signature is verified with HMAC-SHA256 using your API key, and the order is only completed when the paid amount and currency match the order.

= Are there chargebacks? =
No. Crypto payments are final once confirmed on-chain, which removes card-style chargeback fraud.

= How do refunds work? =
Issue a refund from your CryptoPayr dashboard; the customer receives a link to choose a coin and return address for the payout.

== Changelog ==

= 1.0.1 =
* Update the "Tested up to" WordPress version.

= 1.0.0 =
* Initial release. One plugin for the classic and block-based checkout, HPOS compatibility, and signed webhooks.
