Skip to content

Configuration

D edited this page Aug 2, 2026 · 1 revision

Configuration

Navigate to WooCommerce → Settings → Payments → CLINK (Lightning).

Setting Description
Enable/Disable Turn the gateway on/off.
Title Payment method title shown at checkout. Default: Bitcoin Lightning (via CLINK).
Description Payment method description shown at checkout. Supports HTML.
CLINK Offer String (noffer) Your noffer1... string from ShockWallet / Lightning.Pub. The plugin validates that it starts with noffer1 when saving.
Bitcoin Network The network your CLINK offer operates on: Mainnet (lnbc…), Testnet (lntb…), or Regtest (lnbcrt…). Invoices from a different network are rejected at checkout. Default: Mainnet.
Display Amount As How prices appear on product pages, cart, and checkout: Satoshis, BTC, or ₿ (bip-0177). This overrides WooCommerce frontend prices across the whole store. Default: Satoshis.
Fixed BTC Rate (optional) Set a fixed BTC price in your store currency (e.g. 75000.00). Leave empty to use the live CoinGecko rate (cached 5 minutes).
Invoice Timeout (seconds) How long the customer has to pay the invoice before it expires. Default: 600, range 60–3600.
Poll Interval (ms) How often the plugin checks whether the payment was confirmed. Default: 5000, range 2000–30000.

Minimal Setup

For a live store you only need to fill in the CLINK Offer String (noffer) field. Everything else has sensible defaults:

  1. Enable the gateway
  2. Paste your noffer1... string
  3. Confirm Bitcoin Network matches the network your noffer was created on (almost always Mainnet)
  4. Save changes

Notes

  • Display Amount As overrides the store currency display everywhere on the frontend — including on the product page, cart, checkout, and order confirmation. It does not change how prices are stored or charged.
  • The Fixed BTC Rate bypasses CoinGecko entirely; the exchange rate will never change until you update it manually.
  • Invoices that don't match the order total (within 1 sat) or that expire in under 60 seconds are rejected for security.

Clone this wiki locally