=== Oxialink Crypto Payments for WooCommerce ===
Contributors: oxialink
Tags: crypto payment gateway, woocommerce, usdt, bitcoin, cryptocurrency
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Accept USDT, Bitcoin, Ethereum, TON and more in WooCommerce. Real on-chain settlement, no chargebacks, fees from 0.2%.

== Description ==

Oxialink is a crypto payment gateway built to settle: every payment is tracked to real on-chain confirmation and lands in a wallet you control.

* 14 coins across 6 networks: USDT (TON, BSC, Solana, Tron, Ethereum), USDC, BTC, ETH, LTC, DOGE, DASH, BNB, TRX, TON
* Customer picks the coin at checkout and pays on a hosted page with a QR code and a live confirmation count
* Works on both the classic checkout and the block-based checkout, HPOS compatible
* Orders complete automatically via HMAC-signed webhooks, verified byte-exactly before any order is touched, with an hourly status poll as a safety net
* Underpayments put the order on hold with a note; expired invoices cancel the order
* Merchant controls: order status after payment, invoice expiry, minimum order total, crypto surcharge or discount multiplier
* Sandbox mode: one checkbox points the gateway at Oxialink's test networks, so you can take a full order through checkout with free faucet coins before going live
* No chargebacks, no rolling reserves, processing from 0.2% per payment

This plugin connects your store to the Oxialink payment service. A free Oxialink account is required; Oxialink charges a processing fee per payment as published at https://oxialink.com/fees. All plugin functionality is included with the free plan.

Oxialink Crypto Payments for WooCommerce is developed and maintained by Oxialink (https://oxialink.com). It is an independent plugin and is not affiliated with, endorsed by, or sponsored by Automattic Inc. "WooCommerce" and "WordPress" are trademarks of their respective owners and are used here only to describe what this plugin is compatible with.

== External services ==

This plugin talks to the Oxialink API (https://oxialink.com) to process payments. It is required for the plugin to work.

What is sent, and when:

* When a customer chooses Oxialink at checkout and places the order, the plugin sends the order total, store currency, chosen cryptocurrency, an order description (store name and order number), and your store's callback and return URLs to api endpoint /api/v1/invoice/create, authenticated with your API key.
* Once per hour, for orders still awaiting payment, the plugin sends the invoice code to /api/v1/invoice/get to check the payment status.
* No customer personal data (name, email, address) is ever sent to Oxialink by this plugin.

With sandbox mode enabled the same two requests go to the Oxialink sandbox at https://sandbox.oxialink.com instead. It is the same service running against public test networks; nothing there moves real money. Sandbox mode is off unless you turn it on.

The service is provided by Oxialink: terms of service https://oxialink.com/terms and privacy policy https://oxialink.com/privacy.

== Installation ==

1. Upload the plugin and activate it.
2. Create a free account at https://oxialink.com and create a wallet for each coin you want to accept.
3. In WooCommerce, go to Settings, then Payments, then Oxialink. Paste your API key, API secret and webhook secret (found in the Oxialink dashboard), pick the coins to offer, and enable the gateway.

== Frequently Asked Questions ==

= Do I need an Oxialink account? =
Yes. The plugin is a connector for the Oxialink payment service. Accounts are free and no KYC is required to start.

= Which store currencies are supported? =
USD, EUR, GBP, JPY, IDR, INR, SGD, MYR, AUD and CAD. The invoice is converted at the live rate when the customer checks out. A store priced in any other currency is refused at checkout with a message naming the supported ones, rather than being quoted a wrong amount.

= Where does the money go? =
To your Oxialink wallet, withdrawable to your own address any time, or automatically with auto-withdraw.

= Is customer data shared with Oxialink? =
No. The plugin sends only order totals, currency, the chosen coin and an order reference. The customer pays on Oxialink's hosted page and never enters personal data there.

= Can I test the checkout without spending real money? =
Yes. Tick Sandbox mode in the gateway settings and the plugin talks to https://sandbox.oxialink.com, the same service running against public test networks. Register separately at sandbox.oxialink.com for the API key, secret and webhook secret: sandbox and live accounts are not shared. Only USDT_TRC20, USDT_BEP20, TRX, BNB and TON exist on the test networks, so the checkout picker narrows to those while sandbox mode is on, and your live coin list comes back when you turn it off. Checkout, the thank-you page and the WordPress admin all show a test-mode warning while it is on, so an order paid in sandbox can never be mistaken for a real one.

== Changelog ==

= 1.1.0 =
* Sandbox mode: a settings checkbox routes the gateway to Oxialink's test networks at sandbox.oxialink.com.
* The coin picker narrows itself to the coins the test networks support while sandbox mode is on, instead of failing at the moment of payment.
* Test-mode warnings on the classic checkout, the block checkout, the thank-you page and the WordPress admin, plus an order note recording which environment paid for each order.

= 1.0.0 =
* First release: hosted checkout, coin picker on classic and block checkout, signed webhooks with status-poll fallback, underpaid and expired handling, HPOS compatible.

== Upgrade Notice ==

= 1.1.0 =
Adds sandbox mode for testing the checkout against test networks. Existing settings are unchanged and sandbox mode is off by default.

= 1.0.0 =
First release.
