{"id":405562,"date":"2026-11-20T05:07:22","date_gmt":"2026-11-20T05:07:22","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/velirapay-for-woocommerce\/"},"modified":"2026-11-20T10:56:27","modified_gmt":"2026-11-20T10:56:27","slug":"velirapay-for-woocommerce","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/velirapay-for-woocommerce\/","author":23606161,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"0.4.7","stable_tag":"0.4.7","tested":"7.1.5","requires":"6.4","requires_php":"8.1","requires_plugins":null,"header_name":"VeliraPay for WooCommerce","header_author":"VeliraPay","header_description":"Take Bitcoin, Ethereum, USDC and other coins at checkout with VeliraPay. Each order becomes a VeliraPay invoice the customer pays on a hosted page.","last_updated":"2026-11-20 10:56:27","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/github.com\/VeliraPay\/velirapay-woocommerce","header_author_uri":"https:\/\/velirapay.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":63,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"0.4.6":{"tag":"0.4.6","author":"velirapay","date":"2026-11-20 05:06:52","revision":3812972},"0.4.7":{"tag":"0.4.7","author":"velirapay","date":"2026-11-20 10:56:27","revision":3813491}},"upgrade_notice":{"0.4.0":"<p>Orders paid by accepting a short or late payment now wait on hold for you. The plugin&#039;s folder is now velirapay-for-woocommerce: deactivate and delete a copy installed from an earlier zip before uploading this one. Its settings are kept.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3812972,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3812972,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon.svg":{"filename":"icon.svg","revision":3812972,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3812972,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3812972,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.4.6","0.4.7"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[1886,21057,18737,1887,286],"plugin_category":[45],"plugin_contributors":[294104],"plugin_business_model":[],"class_list":["post-405562","plugin","type-plugin","status-publish","hentry","plugin_tags-bitcoin","plugin_tags-crypto","plugin_tags-ethereum","plugin_tags-payments","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-velirapay","plugin_committers-velirapay"],"banners":{"banner":"https:\/\/ps.w.org\/velirapay-for-woocommerce\/assets\/banner-772x250.png?rev=3812972","banner_2x":"https:\/\/ps.w.org\/velirapay-for-woocommerce\/assets\/banner-1544x500.png?rev=3812972","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/velirapay-for-woocommerce\/assets\/icon.svg?rev=3812972","icon":"https:\/\/ps.w.org\/velirapay-for-woocommerce\/assets\/icon.svg?rev=3812972","icon_2x":false,"generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p><a href=\"https:\/\/velirapay.com\">VeliraPay<\/a> is a crypto payment processor. This plugin adds it as a payment method to WooCommerce, on the classic and the block checkout.<\/p>\n\n<p>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.<\/p>\n\n<ul>\n<li>Every coin VeliraPay takes, chosen by the customer at the moment of payment.<\/li>\n<li>Orders priced in USD, EUR, GBP, CAD, AUD, CHF or TRY, the store's own currency.<\/li>\n<li>Webhooks checked against the endpoint's signing secret, each event applied once, with the store's test and live modes kept apart.<\/li>\n<li>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.<\/li>\n<li>Order notes for everything VeliraPay reports: payments seen on chain, underpayments, expired quotes, late payments and refunds.<\/li>\n<li>High-Performance Order Storage and block checkout support.<\/li>\n<\/ul>\n\n<p>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.<\/p>\n\n<h3>External services<\/h3>\n\n<p>This plugin connects to VeliraPay's API, https:\/\/api.velirapay.com, the crypto payment processor it adds to the store, to take payments:<\/p>\n\n<ul>\n<li>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.<\/li>\n<li>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.<\/li>\n<li>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.<\/li>\n<li>It voids the order's invoice when the order is cancelled, trashed or deleted.<\/li>\n<li>When you save an API key, it reads the account and its invoices to check the key.<\/li>\n<\/ul>\n\n<p>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.<\/p>\n\n<p>The plugin calls no other service.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Under Plugins \u2192 Add New Plugin, search for \"VeliraPay for WooCommerce\", install it and activate it. WooCommerce 8.3 or later must be active.<\/li>\n<li>In the VeliraPay dashboard, under Developers \u2192 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.<\/li>\n<li>Go to WooCommerce \u2192 Settings \u2192 Payments \u2192 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.<\/li>\n<li>Under Developers \u2192 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.<\/li>\n<li>Enable the gateway and save.<\/li>\n<li>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.<\/li>\n<\/ol>\n\n<p>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.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"which%20currencies%20can%20the%20store%20use%3F\"><h3>Which currencies can the store use?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"is%20there%20a%20smallest%20order%3F\"><h3>Is there a smallest order?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"which%20coins%20can%20customers%20pay%20in%3F\"><h3>Which coins can customers pay in?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"what%20happens%20to%20the%20order%20while%20the%20customer%20pays%3F\"><h3>What happens to the order while the customer pays?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"does%20cancelling%20an%20order%20stop%20the%20payment%3F\"><h3>Does cancelling an order stop the payment?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"what%20if%20the%20customer%20pays%20too%20little%2C%20or%20too%20late%3F\"><h3>What if the customer pays too little, or too late?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"what%20if%20a%20webhook%20never%20arrives%3F\"><h3>What if a webhook never arrives?<\/h3><\/dt>\n<dd><p>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.<\/p>\n\n<p>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.<\/p><\/dd>\n<dt id=\"can%20i%20test%20without%20real%20coins%3F\"><h3>Can I test without real coins?<\/h3><\/dt>\n<dd><p>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.<\/p>\n\n<p>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.<\/p><\/dd>\n<dt id=\"does%20velirapay%20email%20my%20customers%3F\"><h3>Does VeliraPay email my customers?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"how%20is%20the%20plugin%20updated%3F\"><h3>How is the plugin updated?<\/h3><\/dt>\n<dd><p>From WordPress.org: WordPress offers each new version on its Plugins and Updates screens, like any other plugin's.<\/p><\/dd>\n<dt id=\"how%20are%20refunds%20handled%3F\"><h3>How are refunds handled?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>0.4.7<\/h4>\n\n<ul>\n<li>Orders with a billing name can pay even when the store has no email address for the customer.<\/li>\n<\/ul>\n\n<h4>0.4.6<\/h4>\n\n<ul>\n<li>Requests to VeliraPay are encoded with wp_json_encode(), and the webhook URL field on the settings page no longer carries an inline script.<\/li>\n<\/ul>\n\n<h4>0.4.5<\/h4>\n\n<ul>\n<li>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.<\/li>\n<\/ul>\n\n<h4>0.4.4<\/h4>\n\n<ul>\n<li>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.<\/li>\n<\/ul>\n\n<h4>0.4.3<\/h4>\n\n<ul>\n<li>The plugin's admin notices show only on the Plugins screen and WooCommerce's settings and order lists, instead of on every admin page.<\/li>\n<\/ul>\n\n<h4>0.4.2<\/h4>\n\n<ul>\n<li>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.<\/li>\n<\/ul>\n\n<h4>0.4.1<\/h4>\n\n<ul>\n<li>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.<\/li>\n<\/ul>\n\n<h4>0.4.0<\/h4>\n\n<ul>\n<li>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.<\/li>\n<li>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.<\/li>\n<li>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.<\/li>\n<li>The \"Hold stock\" timer no longer cancels an order whose invoice is being paid.<\/li>\n<li>The method is only offered for totals VeliraPay takes: the currency's lowest price, and a coin the account takes for that amount.<\/li>\n<li>Replacing an outdated invoice can no longer cancel the order, even when the new invoice cannot be created.<\/li>\n<li>An order held for a payment that never confirmed goes back to pending payment.<\/li>\n<li>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.<\/li>\n<li>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.<\/li>\n<li>API requests never follow redirects, the webhook URL is always shown with https:\/\/, and a new API key is checked with VeliraPay when saved.<\/li>\n<li>Order notes name the coin's network, and a Lightning payment is noted as final.<\/li>\n<li>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.<\/li>\n<li>Exception messages are escaped, and request input and saved keys are sanitized.<\/li>\n<li>The privacy policy guide suggests text about VeliraPay.<\/li>\n<li>Tested up to WooCommerce 11.3.<\/li>\n<\/ul>\n\n<h4>0.3.1<\/h4>\n\n<ul>\n<li>Retrying an order after changing modes or accounts no longer replaces its existing invoice.<\/li>\n<li>Delayed events leave refunded orders and orders with a recorded payment date alone.<\/li>\n<li>Pending-order polling continues beyond fifty orders, in batches at least a minute apart.<\/li>\n<li>The settings explain that an endpoint receives nothing until it is verified.<\/li>\n<\/ul>\n\n<h4>0.3.0<\/h4>\n\n<ul>\n<li>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.<\/li>\n<\/ul>\n\n<h4>0.2.0<\/h4>\n\n<ul>\n<li>The webhook receiver answers the verification challenge an endpoint has to pass before it receives anything.<\/li>\n<li>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.<\/li>\n<li>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.<\/li>\n<li>A payment that reaches an invoice the order replaced is noted, and puts the order on hold.<\/li>\n<\/ul>\n\n<h4>0.1.0<\/h4>\n\n<ul>\n<li>First release: the payment method, the webhook receiver, the status sync and the settings page.<\/li>\n<\/ul>","raw_excerpt":"Take Bitcoin, Ethereum, USDC and other coins at checkout. Each order becomes a VeliraPay invoice the customer pays on a hosted page.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/405562","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=405562"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/velirapay"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=405562"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=405562"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=405562"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=405562"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=405562"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=405562"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}