Skip to content
Developer guides

Set up Coinvay crypto payments for WooCommerce

Configure the Coinvay WooCommerce module on staging and test invoice confirmation, scheduled reconciliation and store rules.

THE SHORT ANSWER

Coinvay provides a WooCommerce payment module that creates hosted crypto invoices and confirms orders through authenticated checks. Install and configure it on staging first; downloading a plugin does not verify compatibility with your store configuration.

Configure the module on a staging store

Download the WooCommerce package from Coinvay Integrations, back up the store and review its version requirements. Upload and activate the plugin, then open WooCommerce payment settings to configure the Coinvay origin and merchant API key. The current module supports USD store currency. Set your receiving wallets in Coinvay before enabling checkout, and keep the gateway disabled until your staging acceptance checks succeed.

Understand how confirmation reaches the order

The module saves an invoice mapping and holds the order pending authenticated confirmation. An eligible webhook plan can deliver to the displayed callback URL using the configured signing secret. A reconciliation job also polls pending invoices; drive WP-Cron from a real scheduler rather than assuming customer visits will run every check. Classic checkout and Checkout Blocks have integration code, but you must test the exact versions and HPOS settings used by your store.

Test your commerce rules

For a cart containing a physical product, verify the complete USD total including shipping and tax. Return from an unpaid checkout and confirm the order does not become paid. Then test duplicate callbacks, delayed settlement, API outages, changed totals and downloadable products. The module does not advertise automatic WooCommerce Subscriptions renewals or automatic refunds. Refunds are separately authorized wallet transfers and must be recorded in the store. Sandbox checkout can validate the gateway experience, but the plugin is not automatically wired to the interactive Sandbox endpoints.

Practical checklist

  • Verify USD currency, supported runtime versions and the module setup guide.
  • Configure a real reconciliation schedule and a separate, appropriate webhook callback if used.
  • Test stock, tax, shipping, duplicate notifications and fulfillment in your actual staging store.

Common questions

Does returning to the WooCommerce order page complete payment?+

No. The module waits for authenticated confirmation and checks the invoice against the saved order. Browser navigation is not proof.

Are automatic subscription renewals included?+

The current WooCommerce package is advertised for one-time checkout. Automatic token billing is a separate Coinvay system, not a WooCommerce Subscriptions integration.

Sources and further reading

Primary references and Coinvay product documentation. Check the linked pages for current details.

  1. Coinvay merchant API documentation
  2. WooCommerce payment gateway development reference

AI-assisted drafting, published by Coinvay. Examples are illustrative. Read our editorial approach.

Back to all articles