Skip to content
>
Mode: standard
Dashboard

WooCommerce

WooCommerce logo
eCommerceOfficial plugin

Accept cryptocurrency at WooCommerce checkout on any WordPress store.

The SDK-based CoinPayments gateway for WooCommerce. Shoppers choose CoinPayments at checkout, pay in the cryptocurrency of their choice, and orders move to processing automatically once the payment is confirmed — no custom code required.
WordPress · WooCommerce 6.0+ · PHP 8.1+
Install WooCommerceCreate your integrationAll plugins

What you get

7 capabilities

Native checkout payment method

CoinPayments appears as a payment option at WooCommerce checkout. Customers complete payment in their desired cryptocurrency on the hosted checkout.

Accept Cryptocurrency

Let customers pay in cryptocurrency. Funds land in your CoinPayments merchant wallets.

Automatic payment updates

Confirmations are delivered by webhook, so orders and invoices reconcile themselves the moment a payment settles.

Settle the way you want

Hold incoming crypto or use auto-conversion and auto-sweep to consolidate into the coins you prefer.

Secure by design

Connect with a scoped Client ID / Client Secret pair, granular permissions, and IP allow-listing.

Show prices in crypto

The bundled Exchange Rates add-on can display your product prices in the cryptocurrencies you accept.

Sell worldwide

Take borderless payments from customers in 190+ countries, settled in cryptocurrency.

What's in the package

2 components

CoinPayments.net Gateway

The payment-gateway module — accept cryptocurrency at WooCommerce checkout.

CoinPayments.net Exchange Rates

The exchange-rates module — display product prices in your accepted cryptocurrencies. (optional)

Before you start

Installation & setup

6 steps
Step 1Create your CoinPayments account
Register at coinpayments.net/register, then confirm your email, enable two-factor authentication, and sign in. Full walkthrough in the account setup guide.
Step 2Complete compliance verification
Verification is required before commercial tools — invoicing, API integrations, eCommerce plugins, and payment collection — become available. Complete the personal or business steps in the account setup guide. The LTCT test currency is available for testing before verification.
Step 3Find your CoinPayments instance
Accounts are routed to instance A, B, or C based on your business registration country — find yours here. The WooCommerce setting maps each instance to its API host automatically:A → a-api.coinpayments.netB → b-api.coinpayments.netC → c-api.coinpayments.net
Step 4Create your API keys
In the dashboard, open Integrations → Add Integration → API Integrations, enter your store name and store URL, then copy the Client ID and Client Secret. Save the secret immediately — it is only shown once. See creating an integration.
Step 5Install and configure the plugin
  1. In wp-admin, go to Plugins → Add New → Upload Plugin, upload the package, then click Activate.
  2. Open WooCommerce → Settings → Payments, enable CoinPayments, and open its settings.
  3. Paste your Client ID and Client Secret and confirm the webhook configuration.
  4. Choose your CoinPayments instance (A, B, or C) and click Save changes.
  5. Click Test Connection — it calls the CoinPayments API with your saved instance and credentials. A successful result confirms your credentials and entity routing are valid.
Step 6Test payment reconciliation
Before going live, run a payment end-to-end:
  1. Create a small WooCommerce test cart and open the invoice as a customer.
  2. Click Pay with CoinPayments and complete the hosted checkout.
  3. Confirm WooCommerce marks the order as paid and that the transaction ID matches the CoinPayments invoice / payment event.
  4. Review the WooCommerce gateway logs for webhook delivery or signature errors.
References: invoice status route, webhooks, integration options.
CoinPayments dashboard plugin installation wizard for WooCommerce
The CoinPayments dashboard includes a guided wizard to download the WooCommerce plugin and walk through the WordPress install steps.

Keep your Client Secret safe

Your Client Secret is displayed only once when you create the integration. Store it securely — if it is lost you can regenerate it from the dashboard.

How it works

6 points
  • Invoices are created with the SDK postMerchantInvoicesV2 route.
  • Checkout uses the checkoutLink returned by that route.
  • The checkout opens in a new tab with target="_blank" and rel="noopener noreferrer".
  • Webhooks are verified with the SDK WebhookVerifier — see authenticating requests.
  • Paid / completed webhook events mark the WooCommerce order as processing for you to fulfill.
  • A created invoice is cached in the customer session to avoid duplicate invoices during invoice-page refreshes.

Troubleshooting

3 scenarios

If Test Connection fails

  • Confirm the gateway settings were saved before testing.
  • Confirm the selected instance matches your account.
  • Confirm the Client ID and Client Secret belong to the same instance.
  • Confirm the API integration credentials were copied correctly.
  • Check whether IP restrictions were added to the CoinPayments integration.

If invoice creation fails

  • Check the WooCommerce gateway logs for the CoinPayments API response payload.
  • Confirm the store currency is supported by CoinPayments.
  • Confirm the API integration has invoice permissions.

If payment reconciliation fails

  • Confirm webhooks are enabled in WooCommerce.
  • Confirm the callback URL is publicly reachable over HTTPS.
  • Confirm Auto-register Webhook completed without errors.
  • Confirm the WooCommerce server time is accurate; webhook signatures use timestamp freshness checks.

Tested environment

WooCommerce 10.8.1PHP 8.2Debian 13

CoinPayments tested this gateway module in the environment above. Validate the module in your own WooCommerce environment before accepting live payments.

Disclaimer

This module has been tested by CoinPayments for standard installation, configuration, invoice creation, checkout, webhook handling, and payment reconciliation. It is provided on an as-is and as-available basis, with no guarantee that it is error-free, uninterrupted, or compatible with every WooCommerce environment.

Merchants are responsible for validating the module in their own environment before accepting live payments — create and reconcile several low-value test invoices, confirm webhook delivery, and review the gateway logs. Use of this module is subject to CoinPayments’ User Agreement and Privacy Policy.

Report any unexpected behaviour, payment mismatch, duplicate credit, webhook failure, or reconciliation issue to CoinPayments Integrations support.

Where to next?

Pick the most useful next step.

Authentication & credentials
Create an integration and get your Client ID / Client Secret.
Integration guide
The full walkthrough for pre-built plugin integrations.