=== Cryptoniq === Contributors: divengine Donate link: https://cryptoniq.io/?rel=wordpress Tags: cryptocurrency, woocommerce, bitcoin, ethereum, payment gateway Requires at least: 5.0 Tested up to: 7.0 Requires PHP: 7.4 Stable tag: 2.0.1 License: GPL v2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Accept Bitcoin and Ethereum payments on your WooCommerce store. Direct-to-wallet, no third-party signup, no withdrawal fees. == Description == **Cryptoniq** is a free, decentralized cryptocurrency payment gateway for WooCommerce. Buyers pay you directly in **Bitcoin (BTC)** or **Ethereum (ETH)** — the funds land in *your* wallet, not on a third-party platform that holds them, takes a cut, and makes you withdraw. No accounts. No KYC. No custodian. Just paste your wallet address and start accepting crypto. = Why Cryptoniq? = Most "crypto gateways" are actually middlemen: you sign up on their platform, they hold your funds, charge a percentage, and you wait to withdraw. Cryptoniq flips that. Payments go peer-to-peer, on-chain, straight from the buyer's wallet to yours. * **You keep 100% of your sales** — zero platform fees on top of network gas. * **No registration required** — install, paste your wallet, done. * **Direct on-chain payments** — funds arrive in your wallet within minutes. * **Real-time price conversion** — order totals are quoted in your store currency and converted to crypto at the live rate. = Features = * WooCommerce checkout integration — adds Cryptoniq as a payment method like any other gateway. * Clean, mobile-friendly payment box with a QR code and one-click address copy. * Automatic order confirmation when the on-chain transaction is detected. * Live BTC and ETH exchange rates for EUR and USD (this free version supports those two store currencies — see PRO for 150+ currencies). * Multiple wallet addresses per coin — Cryptoniq rotates through them per order. * HPOS (High-Performance Order Storage) compatible. = Supported coins = * Bitcoin (BTC) * Ethereum (ETH) = Want more coins, stablecoins, or instant detection? = A separate paid plugin, **Cryptoniq PRO**, is sold at [cryptoniq.io](https://cryptoniq.io/?rel=wordpress). It is **not** included in or downloaded by this free plugin — it's a separate plugin you install alongside this one. PRO adds: * Litecoin, Dogecoin, TRON, Solana, BNB Smart Chain * ETH on Arbitrum One and Optimism * **USDT** and **USDC** stablecoins on multiple chains * Real-time webhook detection (no waiting on polling) * 150+ fiat currencies for conversion * Priority support This free version does not contain any PRO code or features — it's fully functional standalone, and there is no license key field anywhere in this plugin. = External services = This plugin relies on three external services to do its job. They are all free, public, and require no account or API key (the bundled Etherscan key is a shared default that you can override). **No personal data is ever sent — not the buyer's name, IP, email, order details, or anything else. Only public blockchain addresses you have already chosen to share, and the public identifiers of the coins/currencies whose prices the plugin needs to quote.** **1. api.coingecko.com — exchange rates** * **What it is:** CoinGecko's free public price API. * **What it's used for:** Converting your store's order totals from fiat (USD, EUR, GBP, ...) into the equivalent amount of BTC or ETH the customer needs to send at checkout. * **What data is sent:** Only the public coin identifiers (`bitcoin`, `ethereum`) and the target currencies (`usd`, `eur`) the plugin needs prices for. The request URL looks like `https://api.coingecko.com/api/v3/simple/price?ids=bitcoin,ethereum&vs_currencies=usd,eur`. No personal data, no order data, no site identifiers. * **When it's sent:** Once every 30 minutes via WordPress cron (background), and on plugin activation if no cached prices exist yet. Never on a customer-facing page load. * **Terms of Service:** https://www.coingecko.com/en/terms * **Privacy Policy:** https://www.coingecko.com/en/privacy **2. blockchain.info — BTC transaction lookups** * **What it is:** Blockchain.com's public Bitcoin blockchain explorer. * **What it's used for:** Checking whether the customer's expected BTC payment has arrived at the wallet address you configured. The plugin asks blockchain.info for the list of unspent outputs at that address and looks for one matching the order's expected amount. * **What data is sent:** Only the merchant's BTC wallet address — the same address the buyer is asked to send funds to (already public, both on your checkout page and on-chain). The request URL looks like `https://blockchain.info/unspent?active=YOUR_BTC_ADDRESS`. No buyer data, no order ID, no site identifiers. * **When it's sent:** Only while a customer is actively on the Cryptoniq payment page for an unpaid BTC order — polled via AJAX every few seconds until payment is detected or the 3-hour payment window expires. Never otherwise. * **Terms of Service:** https://www.blockchain.com/legal/terms * **Privacy Policy:** https://www.blockchain.com/legal/privacy **3. api.etherscan.io — ETH transaction lookups** * **What it is:** Etherscan's public Ethereum blockchain explorer API. * **What it's used for:** Same purpose as blockchain.info but for ETH — checking whether the customer's expected ETH payment has arrived at the merchant's wallet address. * **What data is sent:** Only the merchant's ETH wallet address and an Etherscan API key (the plugin ships with a free shared-tier key; you can replace it via the `apikey_eth` option). The request URL looks like `https://api.etherscan.io/api?module=account&action=txlist&address=YOUR_ETH_ADDRESS&apikey=...`. No buyer data, no order ID, no site identifiers. * **When it's sent:** Only while a customer is actively on the Cryptoniq payment page for an unpaid ETH order — same AJAX polling schedule as blockchain.info above. Never otherwise. * **Terms of Service:** https://etherscan.io/terms * **Privacy Policy:** https://etherscan.io/privacypolicy The plugin never connects to `api.cryptoniq.io` or any other server controlled by the plugin author — all blockchain and price data comes from the three independent public services listed above. == Third-Party Libraries == This plugin ships with the following third-party JavaScript libraries. The minified files in `assets/js/cryptoniq.libs.js` are publicly maintained open-source projects — full unminified source is available at each project's repository: * **clipboard.js** v1.7.1 — copy-to-clipboard helper for the payment box. Source: https://github.com/zenorocha/clipboard.js (MIT license) == Installation == **Requirements:** WordPress 5.0+, PHP 7.4+, WooCommerce installed and active. 1. Upload the `cryptoniq-lite` folder to `/wp-content/plugins/`, or install it from the WordPress plugin directory. 2. Activate **Cryptoniq** in **Plugins**. 3. Go to **Cryptoniq** in the WordPress admin menu. 4. Paste your BTC and/or ETH receive addresses in the **Wallets** tab. 5. Make sure Cryptoniq is enabled under **WooCommerce → Settings → Payments**. That's it — your store can now accept crypto. == Frequently Asked Questions == = Do I need a Cryptoniq account? = No. Cryptoniq is fully decentralized. You don't sign up anywhere. You don't give us your wallet's private keys. The plugin just generates a payment box pointing at the receive address *you* paste in, and the customer's wallet does the rest. = Where do the funds go? = Straight to the wallet address you saved in the plugin settings. We never see, touch, or hold your money. Cryptoniq has no custody and no withdrawal flow because there's nothing to withdraw — you already have it. = Are there any fees? = No platform fees from us. The buyer pays network gas (standard for any on-chain transaction). That's the only cost involved. = Which currencies can I price my products in? = **EUR or USD.** If your WooCommerce store uses one of those two currencies, Cryptoniq appears as a payment option at checkout and the BTC/ETH amount is calculated against the live rate. For any other currency (GBP, JPY, AUD, …) the gateway is hidden — see [Cryptoniq PRO](https://cryptoniq.io/?rel=wordpress) for 150+ fiat currency support. = Does it work with WooCommerce HPOS (High-Performance Order Storage)? = Yes. All order meta is stored HPOS-compatibly. = Does it support coins other than BTC and ETH? = The free version supports BTC and ETH. For LTC, DOGE, TRX, SOL, BNB, ARB, OP, and USDT/USDC stablecoins, see [Cryptoniq PRO](https://cryptoniq.io/?rel=wordpress) — a separate paid plugin. = How is a payment confirmed? = The plugin polls the blockchain (blockchain.info for BTC, etherscan.io for ETH) every few seconds while the buyer is on the payment page. Once a matching transaction is detected, the order is marked **Processing** in WooCommerce automatically. = Can I use multiple receive addresses for one coin? = Yes. Add up to 10 addresses combined across BTC and ETH. Cryptoniq rotates through them per order so the same address isn't reused for every customer. = Is my data sent anywhere? = The plugin calls three public APIs: CoinGecko for price data, blockchain.info for BTC lookups, and Etherscan for ETH lookups. No personal data, no order data, no wallet keys leave your site. Wallet addresses you enter are stored locally in your WordPress database. = Can I use my own Etherscan API key? = Yes — set a personal Etherscan key via the `apikey_eth` option to avoid the shared-key rate limit. == Screenshots == 1. WooCommerce checkout — Cryptoniq shown as a payment method alongside the rest. 2. Payment box with QR code, copyable address, and live amount in the buyer's chosen coin. 3. Plugin admin — paste your BTC and ETH wallet addresses. 4. Order confirmation — automatic once the on-chain transaction is detected. == Changelog == = 2.0.1 = * Added USD store currency support — Cryptoniq now appears at checkout on EUR-priced and USD-priced WooCommerce stores. * CoinGecko price feed now fetches BTC and ETH in USD and EUR with a single atomic call (was two calls in 2.0). * Gateway hides itself at checkout when the store currency isn't EUR or USD (avoids silently misquoting amounts on GBP/JPY/etc. stores). = 2.0 = * Rebuilt admin UI with a new options framework (no third-party UI dependencies, ~15 MB smaller install). * Switched price-data source to the public CoinGecko API (no API key required). * Removed all calls to external license/auth servers — the free version no longer talks to any private API. * WooCommerce HPOS-compatible order meta. * Cleaner Lite vs PRO comparison tab (informational only — no license field). * PHP 8.x compatibility, dropped support for PHP < 7.4. = 1.5 = * Fixed Thank You page. * HPOS-compatible meta fields. = 1.4 = * Updated compatibility for the latest WordPress and WooCommerce. = 1.1 = * Bug fixes and stability improvements. = 1.0 = * Initial release. == Upgrade Notice == = 2.0.1 = Adds USD store currency support and consolidates the price feed into a single CoinGecko call. Safe upgrade from 2.0 — settings and saved wallet addresses carry over. = 2.0 = Major rewrite of the admin UI and removal of all external auth calls — the plugin no longer talks to any private API server. Your existing BTC/ETH addresses and settings carry over. Recommended for everyone.