/coinbase-commerce-woocommerce

Accept Bitcoin on your WooCommerce-powered website.

Primary LanguagePHPApache License 2.0Apache-2.0

Coinbase Commerce for WooCommerce

Note: This repository is not actively maintained.

A WooCommerce payment gateway that allows your customers to pay with cryptocurrency via Coinbase Commerce

Installation

From WordPress.org

This plugin is available on the WordPress.org plugin repository, and can be installed either directly from there or from the admin dashboard within your website.

Within your WordPress dashboard

  1. Visit ‘Plugins > Add New’
  2. Search for ‘Coinbase Commerce’
  3. Activate Coinbase Commerce from your Plugins page.

From WordPress.org plugin repository

  1. Download Coinbase Commerce from https://wordpress.org/plugins/coinbase-commerce/
  2. Upload to your ‘/wp-content/plugins/’ directory, using your favorite method (ftp, sftp, scp, etc…)
  3. Activate Coinbase Commerce from your Plugins page.

From this repository

Within the Github repository, click the Clone or Download button and Download a zip file of the repository, or clone it directly via command line.

Within your WordPress administration panel, go to Plugins > Add New and click the Upload Plugin button on the top of the page.

Alternatively, you can move the zip file into the wp-content/plugins folder of your website and unzip.

You will then need to go to your WordPress administration Plugins page, and activate the plugin.

Configuring Coinbase Commerce

You will need to set up an account on Coinbase Commerce.

Within the WordPress administration area, go to the WooCommerce > Settings > Payments page and you will see Coinbase in the table of payment gateways.

Clicking the Manage button on the right hand side will take you into the settings page, where you can configure the plugin for your store.

Note: If you are running version of WooCommerce older than 3.4.x your Coinbase Commerce tab will be underneath the WooCommerce > Settings > Checkout tab

Settings

Enable / Disable

Turn the Coinbase Commerce payment method on / off for visitors at checkout.

Title

Title of the payment method on the checkout page

Description

Description of the payment method on the checkout page

API Key

Your Coinbase Commerce API key. Available within the Coinbase Commerce settings page.

Using an API key allows your website to periodically check Coinbase Commerce for payment confirmation.

Webhook Shared Secret

Your webhook shared secret. Available within the Coinbase Commerce settings page.

Using webhooks allows Coinbase Commerce to send payment confirmation messages to the website. To fill this out:

  1. In your Coinbase Commerce settings page, scroll to the 'Webhook subscriptions' section
  2. Click 'Add an endpoint' and paste the URL from within your settings page.
  3. Make sure to select "Send me all events", to receive all payment updates.
  4. Click "Show shared secret" and paste into the box within your settings page.

Debug log

Whether or not to store debug logs.

If this is checked, these are saved within your wp-content/uploads/wc-logs/ folder in a .log file prefixed with coinbase-

Prerequisites

To use this plugin with your WooCommerce store you will need:

Frequently Asked Questions

What cryptocurrencies does the plugin support?

The plugin supports all cryptocurrencies available at Coinbase Commerce

Does Coinbase Commerce have integrations with other commerce platforms?

Yes, the list of all integrations can be found here: Coinbase Commerce Integrations.

License

This project is licensed under the Apache 2.0 License

Changelog

1.4.1

  • Tested against WordPress 6.5.3
  • Tested against WooCommerce 8.9.1

1.4

  • Declare HPOS Compatibility
  • Remove deprecated Charge status mappings
  • Fix order_id incorrect format error
  • Update coinbase_charge_id to be charge.id

1.3

  • Adds HPOS support

1.2

  • Tested against WordPress 6.0
  • Tested against WooCommerce 6.5.1

1.1.4

  • Bug fix: Sending order confirmation emails in WooCommerce.

1.1.0

  • Added support for charge cancel url.
  • Handle cancelled events from API.
  • Add option to disable icons on checkout page.
  • Add Coinbase Commerce transaction ID to WooCommerce order output (Admin order page, Customer order page, email confirmation).
  • Updated README.md

1.0.2

  • Tested against WordPress 4.9.4

1.0.1

  • Tested against WordPress 4.9.7
  • Tested against WooCommerce 3.4.3
  • Updated README.md
  • Updated plugin meta in coinbase-commerce.php

1.0.0

  • Coinbase Commerce