LNbits Docs

Appearance

WooCommerce Plugin ​

Accept Bitcoin on-chain and Lightning payments in your WooCommerce store via LNbits.

eCommerce Plugin

This is an eCommerce plugin, not an LNbits extension. It runs inside WordPress / WooCommerce and connects to your LNbits server via its API.

Introduction ​

This WooCommerce extensions lets you accept onchain and lightning Bitcoin payments using the LNbits Satspay Server extension.

Follow the instructions at https://github.com/lnbits/woocommerce-payment-gateway/blob/main/README.md to configure and setup the plugin.

You will need access to an LNbits instance to use this plugin. You can use the demo LNbits instance at https://legend.lnbits.com/ to test this plugin.

License ​

This plugin is released under the MIT license.

Installation ​

LNbits configuration ​

  1. Open your LNbits instance e.g. https://demo.lnbits.com/

  2. Create a new wallet, or use an existing wallet if you already have one you want to use

  3. From the sidebar, take a note of the Wallet ID and Invoice/read key. You will need this later

  4. Click manage extensions in the sidemenu and enable the Satspay Server and Watch Only extensions

  5. Open the Watch Only extension and import an xpub/ypub/zpub to add a new watch only wallet

  6. Take a note of the watch only wallet ID that has been created. You will need this later

  7. That's it. Now, let's set up the WooCommerce plugin!

WooCommerce Plugin Setup ​

  1. Install the plugin using your Wordpress admin panel by searching for "LNbits - Bitcoin Lightning and Onchain Payment Gateway" or drop this repo into your wp-content/plugins directory

  2. Activate the plugin

  3. Open WooCommerce > Settings > Payments and activate the LNbits payment method, then click manage.

  4. Edit the Title and Description fields as you want

  5. Enter the LNbits URL for your LNbits server and paste in your settings for the Invoice/Read Key, Wallet ID and Watch Only Extension Wallet ID

  6. Click "Save changes"

Development ​

To build the blocks integration:

  1. Install dependencies:
bash
npm install
  1. Build the assets:
bash
npm run build

For development, you can use:

bash
npm run start

The plugin supports both classic WooCommerce checkout and the newer block-based checkout.

Acknowledgements ​

This plugin is a fork of Phaedrus' original LNBits For WooCommerce.

Thank you to Phaedrus for the work on the original plugin on which this plugin leans heavily.

News · Shop · SaaS · Telegram · Released under the MIT License.

Copyright 2018-present LNbits Contributors