Documentation

Getting started

VelozaPay is a WooCommerce payment method, so WooCommerce must be installed and active first.

1. In your WordPress admin, go to Plugins → Add New and search for VelozaPay. Click Install Now, then Activate.
2. Go to WooCommerce → Settings → Payments. You will see VelozaPay Crypto in the list of payment methods.
3. Enable it, then click Manage to open its settings.
4. Add at least one payout wallet address (see the next section) and save.

That is all there is to it — crypto checkout is now live on your store. No account, no application and no approval step.

Adding your payout wallets

In the VelozaPay settings, paste a wallet address for each cryptocurrency you want to accept. Payments settle on-chain straight to these addresses — VelozaPay is fully non-custodial and never holds your money.

• Use public receiving addresses from a wallet you control. The plugin never asks for, sees or stores private keys.
• You only need to add wallets for the coins you want to offer. A coin with no wallet set is simply not shown at checkout.
• USDT and USDC exist on several networks — make sure each address matches the network you intend to receive on.

Crypto payments are irreversible. Copy each address carefully and send one small test payment to confirm it is correct before going live.

Gateway settings

Open WooCommerce → Settings → Payments → VelozaPay Crypto → Manage to find these options.

• Enable / Disable — turns the crypto payment method on or off at checkout.
• Title — the name customers see for this payment method at checkout, for example "Pay with crypto".
• Description — a short line shown under the title at checkout.
• Payout wallets — your receiving address for each coin (see the section above).
• Underpayment tolerance — if a payment arrives very slightly short of the expected amount, this is how small that shortfall can be and still count the order as paid. It covers minor rounding, not real underpayments.
• Fee options — control how the small transaction fee and network costs are reflected in the amount the customer pays.
• Debug log — when enabled, VelozaPay writes diagnostic entries you can read under WooCommerce → Status → Logs. Turn this on while troubleshooting, and off again afterwards.

Remember to click Save changes after editing any setting.

How a crypto payment works

From the customer's side, paying with crypto looks like this:

1. At checkout the customer selects your crypto payment method and places the order.
2. They land on a payment page hosted on your own store — they never leave your domain.
3. They choose which coin to pay with. A QR code, a deposit address and the exact amount to send appear.
4. They send the payment from their own wallet or exchange.
5. The payment is detected and confirmed on the blockchain, and the funds settle to your payout wallet.
6. The order is automatically marked Paid and the customer is taken to the order-received page.

How long does confirmation take?

Usually a few minutes. Depending on the coin, the network and how busy the blockchain is, it can take longer — commonly up to about 30 minutes. This is normal for crypto and not a fault of the plugin.

The order is confirmed automatically as soon as the payment clears — even if the customer has closed the payment page. The order is still marked paid and the WooCommerce confirmation email is still sent. If the customer keeps the page open, it updates and redirects on its own.

Supported coins & networks

VelozaPay supports:

• Bitcoin (BTC), Ethereum (ETH), Litecoin (LTC), Dogecoin (DOGE), Bitcoin Cash (BCH), Solana (SOL) and POL (Polygon).
• USDT on the Tron, Ethereum, BNB Chain, Polygon and Solana networks.
• USDC on the Ethereum, BNB Chain, Polygon, Base and Solana networks.

You decide which coins to offer simply by adding a payout wallet for them.

Minimum order amounts

Every cryptocurrency has a small minimum payment amount, because very tiny on-chain payments are not economical once network fees are taken into account. If a cart total is below a coin's minimum, that coin cannot be selected for that order.

The current minimum for each coin is listed on the minimum order amounts page.

As a rule of thumb, price products at around $5 or more so every supported coin stays available at checkout.

Troubleshooting

The order is paid but the page didn't redirect

First, check WooCommerce → Orders — the order will already be Processing or Completed and the customer will have received the confirmation email. The payment itself succeeded.

The payment page redirects on its own once the payment confirms. If a payment is slow and the page has been open a long time, the page re-checks whenever the customer returns to the tab, or when they reload it. If the page never redirects even on reload, it is almost always a caching issue — see below.

Page caching is interfering

Aggressive page caches — LiteSpeed Cache, WP Rocket, a host-level cache, or Cloudflare "cache everything" rules — can serve a stale payment page or a stale status response, which stops the page from updating.

• Exclude the VelozaPay payment page and the plugin's REST routes (/wp-json/velozapay/) from caching.
• After updating the plugin, purge your cache so customers receive the new files.

An order stays Pending and is never confirmed

• Give it time — crypto confirmation commonly takes 5–30 minutes.
• The order is marked paid by a callback to /wp-json/velozapay/v1/ipn on your site. A security plugin or firewall that blocks the WordPress REST API will stop this — make sure that URL is reachable from the public internet.
• Turn on the Debug log in the gateway settings, then check WooCommerce → Status → Logs for the VelozaPay log. It records each incoming callback and is the fastest way to see what happened.

A coin isn't showing at checkout

Either no payout wallet has been set for that coin, or the cart total is below that coin's minimum amount.

Getting help

If this page and the troubleshooting steps above don't solve it, email [email protected] and include your WordPress and WooCommerce versions, the coin used, and any relevant lines from the VelozaPay debug log.

The plugin's WordPress.org page also has an installation guide and a frequently-asked-questions section.