This page explains how to integrate Coinbase Commerce and WooCommerce, a WordPress-based ecommerce platform. Integrating Woocommerce with Coinbase Commerce lets you accept cryptocurrency peer-to-peer.

​
Summary of Steps

This page assumes that you have a Coinbase Commerce account and a paid WooCommerce account with a store configured to receive payments.

  1. (In Commerce) Create an API key and copy/save your new API key.
  2. (In Woo) Install the Coinbase Commerce plugin (the one authored by Coinbase).
  3. (In Woo) Add pay method, part 1: Paste Coinbase API key and copy WooCommerce webhook URL.
  4. (In Commerce) Paste the Woo webhook URL and copy/save your webhook secret.
  5. (In Woo) Add pay method, part 2: Paste Coinbase Commerce webhook secret.

​
Create Commerce API Key

This section assumes that you have a Coinbase Commerce account.

  1. Log in to Coinbase Commerce.

  2. From your avatar, click Settings and go to the Security tab.

  3. Under API keys, click New API key to generate a new key.

  4. Click Copy to clipboard and securely store your new API key.

Click image to enlarge

Create a Coinbase Commerce API key so that you can authenticate your account, for example, when integrating into a 3rd party app.

​
Install Coinbase Commerce Plugin

To add a new plugin, you must have a paid WooCommerce plan.

  1. Log in to your WooCommerce WordPress account.
  2. From your storefront dashboard, select Plugins > Add New Plugin.
  3. Search for Coinbase and select the Coinbase Commerce plugin.
  4. Click Install and Activate.

Click image to enlarge

​
Add Coinbase Payment Method, Pt 1

To add Coinbase Commerce as a payment gateway, you must be configured for live payments (not just sandbox).

  1. From your storefront dashboard, select Payments.
  2. Find “Coinbase” in the list of available payment gateways.
  3. Click on the Manage button on the right hand side.

Click image to enlarge

This takes you to the settings page, where you can configure the plugin for your store.

Click image to enlarge

  1. Paste the Coinbase Commerce API key into the API Key field.
  2. Copy the URL in step 2 under the Webhook Shared Secret field.
  3. Leave the dialog open so you can paste the webhook secret later.

​
Add Webhook Subscription

  1. Log in to Coinbase Commerce.

  2. From your avatar, click Settings and go to the Notifications tab.

  3. Under Webhook subscriptions, click Add an endpoint.

  4. Paste your webhook URL and click Save.

  5. Click Show shared secret, then Copy to clipboard and securely store your secret.

Click image to enlarge

Add the endpoint of a 3rd party app in Coinbase Commerce to create a webhook.

​
Add Coinbase Payment Method, Pt 2

  1. Return to the WooCommerce Payments management dialog.
  2. Paste your Coinbase Commerce webhook secret into the Webhook Shared Secret field.

Your customers are now able to checkout and pay with crypto using Coinbase Commerce.

See Also: