Title: VeliraPay for WooCommerce
Author: VeliraPay
Published: <strong>November 20, 2026</strong>
Last modified: November 20, 2026

---

Search plugins

![](https://ps.w.org/velirapay-for-woocommerce/assets/banner-772x250.png?rev=3812972)

![](https://ps.w.org/velirapay-for-woocommerce/assets/icon.svg?rev=3812972)

# VeliraPay for WooCommerce

 By [VeliraPay](https://profiles.wordpress.org/velirapay/)

[Download](https://downloads.wordpress.org/plugin/velirapay-for-woocommerce.0.4.7.zip)

 * [Details](https://wordpress.org/plugins/velirapay-for-woocommerce/#description)
 * [Reviews](https://wordpress.org/plugins/velirapay-for-woocommerce/#reviews)
 *  [Installation](https://wordpress.org/plugins/velirapay-for-woocommerce/#installation)
 * [Development](https://wordpress.org/plugins/velirapay-for-woocommerce/#developers)

 [Support](https://wordpress.org/support/plugin/velirapay-for-woocommerce/)

## Description

[VeliraPay](https://velirapay.com) is a crypto payment processor. This plugin adds
it as a payment method to WooCommerce, on the classic and the block checkout.

When a customer picks it, the order becomes a VeliraPay invoice for the order total,
in the store currency, and the customer is sent to the invoice’s hosted page. There
they choose a coin, the exchange rate is locked for 30 minutes, and they send the
payment. Once it confirms on-chain, VeliraPay tells the store through a signed webhook
and the order is marked paid, exactly as it would be after a card payment.

 * Every coin VeliraPay takes, chosen by the customer at the moment of payment.
 * Orders priced in USD, EUR, GBP, CAD, AUD, CHF or TRY, the store’s own currency.
 * Webhooks checked against the endpoint’s signing secret, each event applied once,
   with the store’s test and live modes kept apart.
 * A fallback that polls VeliraPay on the order-received page, from an order action,
   and every hour, so a missed webhook never leaves a paid order pending.
 * Order notes for everything VeliraPay reports: payments seen on chain, underpayments,
   expired quotes, late payments and refunds.
 * High-Performance Order Storage and block checkout support.

Refunds are not automated. Crypto cannot be pulled back: send the coins from your
own wallet and record the refund in the VeliraPay dashboard, which notes it on the
order.

### External services

This plugin connects to VeliraPay’s API, https://api.velirapay.com, the crypto payment
processor it adds to the store, to take payments:

 * When a customer pays an order, it creates a VeliraPay invoice for it, sending
   the available billing name and billing or account email, the order total and 
   currency, a memo with the order number and the store’s name, and the addresses
   of the order’s order-received and payment pages, for the hosted page to send 
   the customer back to.
 * On the store’s pages and the block checkout, while a customer has something in
   the cart or pays for an existing order, it reads which coins the store’s VeliraPay
   account takes in the store currency, at most once every ten minutes, sending 
   nothing about the customer or the cart.
 * It reads the order’s invoice when the customer opens the order-received page,
   when you choose “Check VeliraPay status”, every hour for orders waiting for payment,
   and before WooCommerce’s “Hold stock” timer cancels an order.
 * It voids the order’s invoice when the order is cancelled, trashed or deleted.
 * When you save an API key, it reads the account and its invoices to check the 
   key.

The customer then pays on VeliraPay’s hosted invoice page, and VeliraPay sends the
store signed webhooks about the invoice. VeliraPay’s terms of service: https://velirapay.
com/terms. Its privacy policy: https://velirapay.com/privacy.

The plugin calls no other service.

## Installation

 1. Under Plugins  Add New Plugin, search for “VeliraPay for WooCommerce”, install 
    it and activate it. WooCommerce 8.3 or later must be active.
 2. In the VeliraPay dashboard, under Developers  API keys, create an API key. The 
    plugin only creates, reads and voids invoices, so a restricted key with Read invoices
    and Create invoices is all it needs. A key the store already uses can be restricted
    the same way with the pencil next to it on that page, with no need to paste it 
    again.
 3. Go to WooCommerce  Settings  Payments  VeliraPay and paste the key into the live
    or test field. A new key is checked with VeliraPay when you save, and a key VeliraPay
    refuses later, at checkout or while polling, is reported in a notice on the Plugins
    screen and WooCommerce’s settings and order lists.
 4. Under Developers  Webhooks in the dashboard, add an endpoint with the webhook URL
    shown on the settings page (VeliraPay only delivers to an https:// address on port
    443 that answers within 15 seconds without redirecting) and tick the invoice.paid,
    invoice.voided, charge.payment_detected, charge.underpaid, charge.expired, charge.
    late_payment and charge.refunded events. Copy its signing secret into the settings
    page.
 5. Enable the gateway and save.
 6. Back on the endpoint’s page in the dashboard, press Verify. The plugin answers 
    the challenge VeliraPay sends, and the endpoint receives nothing until it has.

Live and test mode each need their own key and endpoint: switch the dashboard to
test mode to create the test ones, then turn on “Test mode” in the settings to use
them.

## FAQ

### Which currencies can the store use?

USD, EUR, GBP, CAD, AUD, CHF and TRY. With any other store currency the gateway 
is not offered at checkout and a notice says so.

### Is there a smallest order?

Yes. VeliraPay takes no payment under the currency’s lowest price, about half a 
dollar: 0.50 USD, EUR, GBP or CHF, 0.70 CAD, 0.80 AUD or 25.00 TRY. Below it, or
when no coin your account takes can be paid for the total, the method is not offered
at checkout.

### Which coins can customers pay in?

Every coin your VeliraPay account takes, which needs a payout address for its network
under Payment settings in the dashboard. USDT and USDC on Ethereum start at 10 of
the token, so a smaller order simply does not offer them. See https://velirapay.
com/docs/assets for the list.

### What happens to the order while the customer pays?

It stays “Pending payment” with the invoice’s number and link in its notes. When
a payment is seen on chain it goes “On hold”, and when the payment confirms it goes“
Processing” or “Completed”, as any paid order would. If the customer never pays,
it stays pending; WooCommerce’s “Hold stock” setting cancels pending orders after
the minutes you set, which also voids the invoice. An order whose invoice is being
paid, with a coin picked and its rate still locked, a payment confirming or a short
payment, is not cancelled by that timer.

### Does cancelling an order stop the payment?

Cancelling an order voids its invoice, so the hosted page no longer takes payment.
An invoice with a payment already on its way cannot be voided. If that invoice is
paid after all, the order is brought back as a pending one would be, once VeliraPay’s
invoice.paid webhook arrives or you choose “Check VeliraPay status” (the hourly 
check and the order-received page skip cancelled orders): it goes “Processing”, 
or “On hold” when the invoice was paid by accepting a short or late payment, and
WooCommerce takes its stock again. Until then, news of the payment only adds notes
to the cancelled order.

### What if the customer pays too little, or too late?

The order goes “On hold” with a note. The customer can still send the rest of a 
short payment on the invoice page, which completes the order as usual. A short payment
you accept in the VeliraPay dashboard, or a late one, which has to be accepted there
whether you keep it or refund it, leaves the order on hold rather than marking it
paid: move it to “Processing” to fulfil it, or cancel it once the payment is refunded.
This relies on the charge.underpaid, charge.payment_detected and charge.late_payment
webhooks: without them, a paid invoice marks the order paid.

### What if a webhook never arrives?

The plugin asks VeliraPay for the invoice’s state when the customer opens the order-
received page, when you choose “Check VeliraPay status” on the order’s edit screen,
and every hour for orders younger than three days that still wait for payment.

Hourly polling works through every eligible order in batches of up to 50, at least
a minute apart. WP-Cron needs site traffic or a server cron job to run the batches.

### Can I test without real coins?

Yes. Turn on test mode and use a test API key and a test endpoint: payments then
run on the test networks, and a test charge’s page in the VeliraPay dashboard has
a “Simulate payment” button.

An order with an existing invoice keeps that invoice when you switch modes or accounts.
To retry or check such an order, restore the original mode and account’s API key;
a live invoice is never replaced with a test invoice.

### Does VeliraPay email my customers?

The invoice itself is not emailed: the customer is sent straight to its page. In
live mode, when a customer email address is available, VeliraPay emails that address
on the store’s behalf and alongside WooCommerce’s own emails, a receipt when the
payment confirms, a notice when it falls short, and a notice of each refund you 
record. In test mode it only emails addresses of your VeliraPay account’s own members.

### How is the plugin updated?

From WordPress.org: WordPress offers each new version on its Plugins and Updates
screens, like any other plugin’s.

### How are refunds handled?

By hand. Send the coins back from your wallet and record the refund in the VeliraPay
dashboard; the plugin adds a note to the order.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“VeliraPay for WooCommerce” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ VeliraPay ](https://profiles.wordpress.org/velirapay/)

[Translate “VeliraPay for WooCommerce” into your language.](https://translate.wordpress.org/projects/wp-plugins/velirapay-for-woocommerce)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/velirapay-for-woocommerce/),
check out the [SVN repository](https://plugins.svn.wordpress.org/velirapay-for-woocommerce/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/velirapay-for-woocommerce/)
by [RSS](https://plugins.trac.wordpress.org/log/velirapay-for-woocommerce/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 0.4.7

 * Orders with a billing name can pay even when the store has no email address for
   the customer.

#### 0.4.6

 * Requests to VeliraPay are encoded with wp_json_encode(), and the webhook URL 
   field on the settings page no longer carries an inline script.

#### 0.4.5

 * What VeliraPay sends, webhook deliveries and API answers alike, is sanitized 
   as soon as it is decoded, before it reaches an order note, the order’s meta or
   a redirect. A webhook’s raw body is still checked against its signature as it
   came.

#### 0.4.4

 * A detected payment is noted the same way in every coin: the Lightning-specific
   order note and the “BTC (Lightning)” label are gone, since VeliraPay no longer
   offers Bitcoin over Lightning.

#### 0.4.3

 * The plugin’s admin notices show only on the Plugins screen and WooCommerce’s 
   settings and order lists, instead of on every admin page.

#### 0.4.2

 * The note on a late payment says first when VeliraPay quoted its charge again 
   in the coin the customer sent, USDT on Tron instead of TRX or the other way round,
   and what is now due.

#### 0.4.1

 * The invoice’s page sends the customer back to the store: a button to the order-
   received page once they have paid, and a link back to the order’s payment page
   until then.

#### 0.4.0

 * A late payment puts an order still waiting for payment on hold, so the “Hold 
   stock” timer no longer cancels it and voids its invoice meanwhile.
 * An invoice paid by accepting a late payment, or a short one no top-up followed,
   holds the order instead of marking it paid. A short payment topped up in time
   still completes it.
 * A detected or short payment only adds a note to a cancelled order. Its invoice
   being paid still brings it back, on hold when you accepted a short or late payment.
 * The “Hold stock” timer no longer cancels an order whose invoice is being paid.
 * The method is only offered for totals VeliraPay takes: the currency’s lowest 
   price, and a coin the account takes for that amount.
 * Replacing an outdated invoice can no longer cancel the order, even when the new
   invoice cannot be created.
 * An order held for a payment that never confirmed goes back to pending payment.
 * The checkout shows why VeliraPay refused the customer’s email or the amount, 
   and an order without an email uses the customer’s account email.
 * Voiding a cancelled order’s invoice is retried when VeliraPay cannot be reached,
   and a trashed or deleted unpaid order’s invoice is voided too.
 * API requests never follow redirects, the webhook URL is always shown with https://,
   and a new API key is checked with VeliraPay when saved.
 * Order notes name the coin’s network, and a Lightning payment is noted as final.
 * The plugin’s folder and text domain are now velirapay-for-woocommerce, its slug
   on WordPress.org, where new versions come from once it is listed there.
 * Exception messages are escaped, and request input and saved keys are sanitized.
 * The privacy policy guide suggests text about VeliraPay.
 * Tested up to WooCommerce 11.3.

#### 0.3.1

 * Retrying an order after changing modes or accounts no longer replaces its existing
   invoice.
 * Delayed events leave refunded orders and orders with a recorded payment date 
   alone.
 * Pending-order polling continues beyond fifty orders, in batches at least a minute
   apart.
 * The settings explain that an endpoint receives nothing until it is verified.

#### 0.3.0

 * A payout.sent or payout.confirmed webhook adds a note saying your share of the
   charge went out or reached your wallet, on an endpoint subscribed to them.

#### 0.2.0

 * The webhook receiver answers the verification challenge an endpoint has to pass
   before it receives anything.
 * A paid invoice only completes an order it still covers; one for a different amount
   or currency puts the order on hold with a note.
 * Paying again for an order whose invoice was voided or outdated no longer reaches
   that invoice, and an outdated invoice with a payment on its way is kept rather
   than replaced.
 * A payment that reaches an invoice the order replaced is noted, and puts the order
   on hold.

#### 0.1.0

 * First release: the payment method, the webhook receiver, the status sync and 
   the settings page.

## Meta

 *  Version **0.4.7**
 *  Last updated **10 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.4 or higher **
 *  Tested up to **7.1.5**
 *  PHP version ** 8.1 or higher **
 * Tags
 * [bitcoin](https://wordpress.org/plugins/tags/bitcoin/)[crypto](https://wordpress.org/plugins/tags/crypto/)
   [ethereum](https://wordpress.org/plugins/tags/ethereum/)[payments](https://wordpress.org/plugins/tags/payments/)
   [woocommerce](https://wordpress.org/plugins/tags/woocommerce/)
 *  [Advanced View](https://wordpress.org/plugins/velirapay-for-woocommerce/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/velirapay-for-woocommerce/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/velirapay-for-woocommerce/reviews/)

## Contributors

 *   [ VeliraPay ](https://profiles.wordpress.org/velirapay/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/velirapay-for-woocommerce/)