Coinbase Commerce Setup: 1% Fees, 10+ Cryptos

Key Takeaways

Coinbase Commerce charges 1% per transaction with no monthly subscription (source: Coinbase Commerce docs 2026), making it one of the most accessible crypto payment gateways for e-commerce merchants at every level.
Shopify surpasses 4.6 million active stores worldwide in 2026 (source: BuiltWith) and now offers a native integration with Coinbase Commerce through its third-party payment providers system — no external plugin required.
WooCommerce holds 36% of global e-commerce market share, roughly 6.5 million active sites (source: BuiltWith 2026), and remains the platform where Coinbase Commerce integration offers the most flexibility through the official plugin or direct API.
Merchant crypto payments surged 70% between 2023 and 2026 according to Chainalysis, driven by mainstream adoption of stablecoins like USDC and lower fees on Layer 2 networks like Base.
Coinbase Commerce supports over 10 cryptocurrencies including BTC, ETH, USDC, and DOGE across the Base, Ethereum, and Polygon networks (source: Coinbase 2026), with crypto-only settlement — fiat conversion requires a separate Coinbase account.

Coinbase Commerce in 2026: What's Changed

Coinbase Commerce is a completely different beast from what launched in 2018. The current version — sometimes called "Commerce 2.0" — ditched the old charge-based architecture in favor of a system built on Coinbase Onramp checkouts. In practice, the customer scans a QR code or clicks a payment link, and the transaction routes through the Coinbase network.

The biggest shift in 2026–2026 centers on Base, Coinbase's own Ethereum Layer 2. USDC payments on Base now cost pennies in network fees, compared to several dollars on Ethereum mainnet. For a merchant selling products at $30 or $50, that difference is a dealbreaker.

Another key development: the regulatory landscape has become clearer on both sides of the Atlantic. In the US, the SEC and CFTC have continued refining their approach to crypto service providers, while FinCEN enforces anti-money laundering requirements for money services businesses. Coinbase holds state money transmitter licenses across most US states and is registered as a regulated entity, which gives merchants a solid legal footing when using Coinbase Commerce. In the EU, the MiCA regulation has created a harmonized framework for crypto-asset service providers (CASPs), and Coinbase obtained its CASP registration in multiple European countries.

On the competitive front, Coinbase Commerce goes up against BitPay, NOWPayments, and even Stripe, which re-introduced crypto payments via USDC in 2024. But the positioning stays distinct: 1% all-in fees, no subscription, and direct integration into the Coinbase ecosystem for fund management.

Prerequisites Before Installation

Coinbase Commerce Account and API Keys

Before touching Shopify or WooCommerce, you need an active Coinbase Commerce account. Since 2025, Coinbase Commerce is tied to a standard Coinbase account — there's no longer a separate Commerce account.

Create an account at commerce.coinbase.com
Link it to a verified Coinbase account (identity, address)
Generate an API key in the Commerce dashboard under "Developer settings"
Note the Shared Secret for webhooks — essential for callback verification

The Coinbase Commerce API key lets your store create charges (payment requests) and verify their status. The Shared Secret authenticates notifications sent from Coinbase to your server.

KYB Verification and Compliance

For US-based businesses, Coinbase requires identity verification that aligns with FinCEN's anti-money laundering rules and state money transmitter requirements. Depending on your business structure, you'll typically need to provide:

EIN (Employer Identification Number) and business registration documents
Government-issued ID for the business owner or authorized representative
Proof of business address
Description of your commercial activity

For UK merchants, the FCA's registration requirements for crypto-asset businesses apply. Expect to provide Companies House documentation and KYC details for directors.

Verification turnaround ranges from 48 hours to two weeks. Plan ahead — this step blocks activation of live payments.

Installing Coinbase Commerce on Shopify

Activate the Native Payment Provider

Shopify has added Coinbase Commerce to its list of alternative payment providers. Installation no longer requires a third-party app.

From your Shopify admin, go to Settings > Payments
Under "Alternative payment methods," click Add a payment method
Search for "Coinbase Commerce" in the provider list
Enter the API key generated in the Coinbase Commerce dashboard
Select the cryptocurrencies you want to accept (BTC, ETH, USDC, DOGE, etc.)
Save

The advantage of this native integration: orders paid in crypto show up in the same dashboard as your Stripe or PayPal orders. Payment status syncs automatically via webhooks.

Configure Shopify Webhooks

Webhooks are the mechanism by which Coinbase Commerce notifies your store that a payment has been confirmed, expired, or failed.

In the Coinbase Commerce dashboard, go to Settings > Webhooks
Add the Shopify webhook URL, which follows this format: https://your-store.myshopify.com/services/coinbase-commerce/webhooks
Paste the Shared Secret in the corresponding field on the Shopify side
Test the connection with the "Send test webhook" button

If the test returns a 200 code, you're good. A 4xx or 5xx code points to a firewall issue, SSL certificate problem, or incorrect URL.

Test an Order in Sandbox Mode

Coinbase Commerce doesn't offer a true sandbox mode the way Stripe does. Here's the recommended approach:

Create a test product priced at $1
Place a real order, paying in USDC on Base (network fees under $0.01)
Verify that the webhook triggers a proper order status update in Shopify
Process a manual refund through the Coinbase dashboard if needed

This step is non-negotiable. A misconfigured webhook means orders stuck on "pending" indefinitely, frustrated customers, and unnecessary support tickets.

Installing Coinbase Commerce on WooCommerce

Official Plugin vs. Direct API Integration

Two options exist for WooCommerce, and the choice depends on your technical profile.

The official Coinbase Commerce plugin (available in the WordPress plugin directory) works for 90% of use cases. It adds a payment gateway to WooCommerce, handles webhooks automatically, and requires zero code.

Direct API integration is for developers who want total control: custom checkout, granular confirmation handling, integration with an ERP or bespoke invoicing system. It involves using the Coinbase Commerce REST API to create charges, listen for webhook events, and manage statuses manually.

For the vast majority of merchants, the plugin is plenty. Only go the API route if you have a specific need the plugin doesn't cover — like recurring subscriptions or a fully custom purchase funnel.

WordPress and WooCommerce Setup: Step by Step

1. Install the Plugin

From WordPress admin: Plugins > Add New > Search "Coinbase Commerce". Install and activate the plugin developed by Coinbase, Inc. Make sure your WooCommerce version is 8.0 or higher and you're running PHP 8.1 minimum.

2. Configure the Gateway

Go to WooCommerce > Settings > Payments. The "Coinbase Commerce" gateway appears in the list. Click Manage and fill in:

API Key: the one generated in the Coinbase Commerce dashboard
Shared Secret: for webhook verification
Display Title: for example, "Pay with Bitcoin, ETH, or USDC"
Description: a short blurb explaining the process to customers

3. Set Up HTTPS

Coinbase Commerce requires an HTTPS connection. If your WordPress site isn't running SSL yet, install a certificate via Let's Encrypt (free) or your hosting provider. Without HTTPS, webhooks will be rejected every time.

4. Check Permalinks

WooCommerce webhooks depend on the permalink structure. Go to Settings > Permalinks and make sure you're not using "Plain." "Post name" or any custom structure works fine.

Configure WooCommerce Webhooks

The plugin automatically creates a webhook endpoint at: https://your-site.com/?wc-api=coinbase_commerce

Copy this URL
Add it in the Coinbase Commerce dashboard under Settings > Webhooks
Enter the corresponding Shared Secret
Send a test webhook from Coinbase Commerce
Check the WooCommerce logs (WooCommerce > Status > Logs) to confirm the webhook was received and processed

If you're running a caching plugin (WP Rocket, W3 Total Cache), exclude the webhook URL from caching. A cached webhook returns a stale response, and Coinbase Commerce will treat the delivery as failed.

Test the Crypto Checkout End-to-End

Same approach as Shopify, adapted for WooCommerce:

Create a test product called "Crypto payment test" priced at $1
Add to cart, proceed to checkout, select "Coinbase Commerce"
The customer gets redirected to the Coinbase payment page — verify the amount and currency are correct
Pay in USDC on Base to minimize fees
After on-chain confirmation (a few seconds on Base), verify the order moves to "Processing" or "Completed" status in WooCommerce
Check the Coinbase Commerce dashboard: the payment should appear with the transaction hash

Managing Payment Settlement

Crypto Settlement vs. Automatic Fiat Conversion

Coinbase Commerce settles exclusively in cryptocurrency. When a customer pays in BTC, you receive BTC. When they pay in USDC, you receive USDC.

To convert to USD, you have two options:

Manual: Transfer funds to your Coinbase account, convert to USD, then withdraw to your bank account via ACH or wire transfer. Timeline: 1–3 business days.
Semi-automatic: Set up automatic conversion rules in Coinbase. Every incoming payment gets converted to USD at the market rate immediately. Coinbase applies a spread of 0.5% to 1.5% on top of the Commerce fees.

If you prefer direct fiat settlement without the manual Coinbase step, BitPay or Stripe (USDC) offer that functionality natively. This is a real limitation of Coinbase Commerce compared to its competitors.

Accounting and Sales Tax on Crypto Payments

In the US, a payment received in crypto must be recorded in USD at the fair market value on the date of the transaction. The IRS does not distinguish between a credit card payment and a Bitcoin payment when it comes to income recognition — sales tax applies exactly the same way.

Key considerations:

Exchange rate: Use the rate at the exact moment of the transaction (Coinbase Commerce provides this rate in each charge's details)
Accounting entries: The crypto payment constitutes a digital asset on your balance sheet. Any subsequent conversion to USD may trigger a taxable capital gain or loss, reportable on Form 8949
Invoices: Show the amount in USD, not in crypto, in line with standard US invoicing practices

A CPA familiar with digital assets is practically a must once your volume exceeds a few transactions per month. Tools like Cryptio or Bitwave can automate reconciliation between Coinbase Commerce and your accounting software.

Optimizing Checkout Conversion Rates

Reducing Crypto Cart Abandonment

Crypto payments suffer from higher cart abandonment rates than credit cards. The main culprits: blockchain confirmation times, perceived complexity, and uncertainty around network fees.

Some concrete tactics:

Prioritize payments on Base or Polygon: Confirmation in seconds, negligible fees. Feature these networks prominently in the checkout interface.
State the timeline clearly: "Payment confirmed in under 30 seconds on the Base network" reassures the customer.
Default to USDC: No volatility, no surprise amount between click and confirmation.
Display the timer: Coinbase Commerce gives 60 minutes to complete a payment. Show this countdown to create urgency.

Display Accepted Cryptos on Product Pages

A "Bitcoin accepted" or "Pay with crypto" badge on product pages and the homepage attracts a specific audience. According to a 2024 PYMNTS/BitPay study, 40% of crypto-holding customers say they choose one merchant over another based on crypto acceptance.

On Shopify, add a badge via the theme customizer or a badge app. On WooCommerce, a simple shortcode or sidebar widget does the trick. Coinbase Commerce provides downloadable graphic assets (logos of accepted cryptos) from the dashboard.

Common Issues and Troubleshooting

Payment Stuck on Pending: What to Do

A "pending" payment means the transaction has been detected on the blockchain but hasn't reached the required number of confirmations. On Bitcoin, Coinbase Commerce requires 3 confirmations (roughly 30 minutes). On Ethereum mainnet, 12 confirmations. On Base, a few seconds is typically enough.

Steps to take:

Check the transaction hash on a blockchain explorer (Blockchair for BTC, Etherscan for ETH, Basescan for Base)
If the transaction is confirmed but the status remains "pending" in your store, the webhook likely failed — retrigger it manually from the Coinbase Commerce dashboard
If the transaction is genuinely pending (Bitcoin mempool congestion), be patient. Do not manually mark the order as paid until confirmation

Common WooCommerce Plugin Conflicts

Plugin conflicts are the number-one cause of Coinbase Commerce malfunctions on WooCommerce. The usual suspects:

Caching plugins (WP Rocket, LiteSpeed Cache): They cache webhook endpoints. Solution: Exclude /?wc-api=coinbase_commerce from the cache.
Security plugins (Wordfence, Sucuri): They block incoming POST requests from Coinbase Commerce. Solution: Whitelist Coinbase's IPs in your firewall rules.
HTTPS redirect plugins: They can interfere with callbacks. Solution: Verify that your site forces HTTPS everywhere without redirect loops.
WooCommerce Subscriptions: The standard Coinbase Commerce plugin doesn't handle recurring payments. For subscriptions, you'll need to build a custom integration via the API or use a streaming protocol like Superfluid.

When in doubt, deactivate every plugin except WooCommerce and Coinbase Commerce, test, then reactivate one by one to isolate the conflict.

Shopify vs. WooCommerce: Which Integration Should You Choose?

The choice doesn't come down to Coinbase Commerce itself — the tool works well on both platforms. It depends on your technical and business context.

Shopify is the move if you want a 10-minute setup with zero code, managed hosting, and no server maintenance. The downside: less customization of the checkout flow, and Shopify charges its own commission on top of the 1% Coinbase Commerce fee if you're not using Shopify Payments as your primary gateway.

WooCommerce makes sense if you need full control, a custom checkout, ERP integration, or you refuse to depend on a proprietary SaaS platform. The downside: you're responsible for hosting, WordPress updates, SSL security, and plugin conflicts.

In terms of webhook reliability, Shopify has the edge: managed infrastructure, no caching plugin to configure, no firewall to whitelist. On WooCommerce, every hosting provider has its quirks, and webhooks are the number-one source of problems.

For a merchant just getting started with crypto payments who wants a frictionless test run, Shopify is the pragmatic choice. For a technical merchant already running a WooCommerce store, migrating to Shopify just for Coinbase Commerce makes zero sense — the WooCommerce plugin gets the job done.

FAQ

Does Coinbase Commerce work with all Shopify themes, or do I need a specific one?

Coinbase Commerce works with every Shopify theme, no exceptions. The integration runs through Shopify's native payment provider system, which operates independently of the theme. The customer is redirected to a payment page hosted by Coinbase, so no template modifications are needed.

How do I receive Coinbase Commerce payments directly in USD to my bank account?

Coinbase Commerce doesn't offer direct fiat settlement. To receive USD, you need to transfer the crypto you've received to a Coinbase account, convert it to USD, then withdraw to your bank via ACH or wire transfer. You can set up automatic conversions in Coinbase to cut down on manual work. If native fiat settlement is a dealbreaker, BitPay or Stripe offer that feature out of the box.

Do I need to handle sales tax differently if I accept Bitcoin payments on WooCommerce?

No. Sales tax applies exactly the same way as any other payment method. The transaction amount must be recorded in USD at the fair market value on the date of the transaction, and sales tax is calculated on that USD amount. The only wrinkle involves accounting for the digital asset on your books and any potential capital gain or loss when you later convert it to fiat — which is reportable on IRS Form 8949.

Is Coinbase Commerce compatible with WooCommerce Subscriptions?

The official Coinbase Commerce plugin for WooCommerce does not support automatic recurring payments. Cryptocurrencies operate on a "push" model (the customer initiates each payment), unlike bank direct debits. For subscriptions, you'd need to build a custom integration via the Coinbase Commerce API that sends a payment request at each billing cycle, or use a specialized protocol like Superfluid for USDC payment streaming.

Is Coinbase Commerce legal to use in the US in 2026?

Yes. Coinbase is a publicly traded company (NASDAQ: COIN) registered with FinCEN as a money services business and holds money transmitter licenses in most US states. The SEC and CFTC continue to oversee crypto service providers, and Coinbase operates within this regulatory framework. US merchants can use Coinbase Commerce legally, provided they comply with their own tax and accounting obligations related to accepting crypto payments — including proper income recognition and capital gains reporting to the IRS.

What's the difference between the Coinbase Commerce WooCommerce plugin and the API integration?

The official plugin installs in a few clicks, handles webhooks automatically, and adds Coinbase Commerce as a standard payment method in WooCommerce. Direct API integration requires development work: you create charges via REST calls, listen for webhooks with your own endpoint, and manage order statuses manually. The API gives you more control (custom checkout, specific business logic, ERP integration) but demands solid technical skills and ongoing maintenance.

Coinbase Commerce: Shopify & WooCommerce Setup Guide (2026)