Cryptonly – Crypto Payment Gateway for WooCommerce

Description

Website | Live Demo | Documentation

Let your customers pay with Bitcoin, Ethereum, USDT, and other cryptocurrencies — no crypto experience needed on your side.

You keep pricing products in your usual currency. At checkout, the customer picks a coin, sees exactly how much to send, and pays on a secure Cryptonly page. Once the payment is confirmed, the order in WooCommerce is marked as paid — no manual checking, no matching transactions by hand.

Why choose Cryptonly

  • No chargebacks. Crypto payments are final — payment disputes and chargeback fraud disappear.
  • Simple pricing. 0.5% per transaction. No setup fee, no monthly fee, no hidden costs.
  • Keep your prices in fiat. The crypto amount is calculated live at checkout — you always receive the full order value.
  • Sell worldwide. Anyone with a crypto wallet can pay you, from any country.
  • Your money, your wallet. Payments go straight to your Cryptonly merchant wallet. Withdraw anytime — you pay only the blockchain network fee.

Setup takes minutes: install the plugin, paste your Cryptonly keys, done.

Works with your store

  • Classic checkout and the new block-based Cart/Checkout
  • Orders update automatically and securely — no manual status changes
  • If a customer leaves before paying, they get a link to finish payment later
  • Sandbox mode: test the whole flow safely before accepting real money
  • HPOS (custom order tables) compatible
  • Available in English, Spanish, German, and Russian

Requirements

  • A Cryptonly merchant account
  • WooCommerce 7.1+
  • PHP 7.4+

Configuration

Cryptonly merchant dashboard

  1. API Key — Settings Security API keys
  2. Account ID — Accounts select account copy icon
  3. Webhook Signing Key — Settings Security

Enter your credentials in WooCommerce Settings Payments Cryptonly. Enable Sandbox Mode for testnet testing before going live.

For full settings reference, go-live checklist, and troubleshooting, see the Documentation.

External services

This plugin connects your WooCommerce store to the Cryptonly merchant payment service. A Cryptonly merchant account and explicit configuration of API credentials in WooCommerce Settings Payments Cryptonly are required before any external requests are made.

Domains contacted

  • Production API: https://api-merchant.cryptonly.net
  • Sandbox API: https://sandbox-api-merchant.cryptonly.net
  • Hosted payment pages: URLs returned in API responses (paymentPageUrl) on *.cryptonly.net

When data is sent

  • Creating or fetching a Cryptonly invoice (checkout)
  • Cancelling an invoice when a WooCommerce order is cancelled
  • Loading the supported fiat currency list (cached for one hour in WordPress transients)
  • Receiving signed payment status webhooks from Cryptonly

Data transmitted to Cryptonly

  • Order identifier, fiat currency, line items or order total, and order description
  • returnUrl and webhookUrl for your store
  • Optional WooCommerce customer ID
  • API key in the x-tenant-api-key HTTP header (server-side only; never exposed to shoppers)

Data received from Cryptonly

  • Invoice ID, status, and hosted payment page URL
  • Cryptocurrency, amount received, and transaction hash (via webhooks)

Terms and privacy

By configuring and enabling this gateway, you authorize the plugin to communicate with Cryptonly on your behalf using the credentials you provide.

Privacy

This plugin stores gateway settings in the WordPress options table (woocommerce_cryptonly_settings). Order metadata (_cryptonly_invoice_id, _cryptonly_payment_page_url, and related keys) is saved on WooCommerce orders for payment tracking and audit purposes.

When Debug Log is enabled, diagnostic messages may be written to WooCommerce logs (source: cryptonly). Uninstalling the plugin removes gateway settings and cached currency transients but does not delete order metadata or existing log files.

For how Cryptonly processes merchant and payment data, see the Cryptonly privacy policy linked above.

Translations

The plugin is fully translatable (text domain cryptonly-crypto-payment-gateway-for-woocommerce). Bundled translations:

  • English (source)
  • Spanish (es_ES)
  • German (de_DE)
  • Russian (ru_RU)

To switch language, set the site language in Settings General Site Language (or the user profile language). Both PHP strings and the block checkout label are translated.

Screenshots

Installation

  1. Upload the cryptonly-crypto-payment-gateway-for-woocommerce folder to /wp-content/plugins/.
  2. Activate the plugin through the Plugins menu in WordPress.
  3. Go to WooCommerce Settings Payments Cryptonly.
  4. Enter your Cryptonly credentials and save.

FAQ

Which cryptocurrencies can my customers pay with?

Bitcoin, Ethereum, USDT, USDC, BNB, TRX, and other assets enabled in your Cryptonly merchant account. Customers choose the currency and network on the hosted checkout page.

What are the fees?

0.5% per transaction. No setup, monthly, or hidden fees. Withdrawals from your merchant wallet incur only the blockchain network fee.

Do my customers need a Cryptonly account?

No. Customers simply pay from any wallet or exchange — no registration required.

Are chargebacks possible?

No. Crypto payments are final once confirmed on the blockchain, which eliminates chargeback fraud.

Does the plugin work with WooCommerce Blocks checkout?

Yes. Cryptonly appears as a payment method in the Cart and Checkout blocks when the gateway is enabled. Classic shortcode checkout is also supported.

Can I test the complete payment flow before going live?

Yes. Enable Sandbox Mode, place a test order, then either complete payment on the sandbox checkout (testnets only) or use Simulate payment on the invoice in the sandbox merchant dashboard to trigger signed webhooks without moving funds. See Sandbox environment and Testing your integration.

What happens if a customer abandons checkout?

The order stays pending. A Complete payment button links to the stored Cryptonly payment page on the thank-you page, order details, and customer emails while the invoice is still payable. Customers can also use My Account Orders Pay.

Can I customize customer-facing text?

Yes. In WooCommerce Settings Payments Cryptonly, set Title for the checkout payment method label and Resume payment button for the continue-payment link on order pages and emails. Leave a field empty to use the plugin default (translatable via standard WordPress translation tools).

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Cryptonly – Crypto Payment Gateway for WooCommerce” is open source software. The following people have contributed to this plugin.

Contributors

“Cryptonly – Crypto Payment Gateway for WooCommerce” has been translated into 2 locales. Thank you to the translators for their contributions.

Translate “Cryptonly – Crypto Payment Gateway for WooCommerce” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.0.0

  • Initial release: hosted checkout, webhooks, and sandbox mode.
  • Classic and block-based WooCommerce checkout support.
  • HPOS (custom order tables) compatible.
  • Resume payment links for pending crypto orders.
  • Cryptonly is automatically hidden at checkout when the store currency is unsupported.
  • Spanish, German, and Russian translations included.