Skip to content

Configuration

WoompaLoompa edited this page Jul 12, 2026 · 1 revision

Navigate to your store settings and click CLINK Lightning in the integrations sidebar to access the configuration page.

Settings

Setting Type Default Description
Enable CLINK Payments checkbox false Turn CLINK payments on/off for this store
CLINK Offer String text Your noffer1... string from a CLINK-compatible wallet
Title text Lightning (CLINK) Payment method title shown at checkout
Description textarea Pay with your Lightning wallet via the CLINK protocol. Description shown to customers at checkout
Invoice Timeout number 600 Seconds before the Lightning invoice expires (min: 60, max: 3600)
Poll Interval number 5000 Milliseconds between payment status checks (min: 2000, max: 30000)
Additional Nostr Relays textarea Optional relay URLs for redundancy, one per line

Connection String Format

Alternatively, CLINK can be configured as a Lightning connection string in the store's Lightning node settings:

type=clink-noffer;noffer=noffer1...;ndebit=ndebit1...
Key Required Description
type Yes Must be clink-noffer
noffer Yes Your CLINK offer string
ndebit No Your nDebit string for subscription auto-pay

Example

type=clink-noffer;noffer=noffer1qyz3unz...your-offer-data...;ndebit=ndebit1...your-debit-data...

Offer String Validation

The configuration page includes a Validate button next to the offer string field. It checks:

  • Starts with noffer1
  • Is at least 60 characters long

For detailed instructions on generating an offer string, see Generating a nOffer.

Additional Relays

Adding multiple Nostr relays improves reliability. If the primary relay (embedded in your offer string) is temporarily unavailable, the plugin will use the additional relays.

wss://relay.example.com
wss://relay2.example.com

Each relay should be on its own line. The plugin always uses the primary relay from your offer string first, then falls back to additional relays.

Timeout Settings

  • Invoice Timeout: How long a Lightning invoice is valid. If the customer doesn't pay within this window, the invoice expires. Default of 600 seconds (10 minutes) works for most use cases.
  • Poll Interval: How frequently the plugin checks Nostr for payment confirmation. Lower values = faster confirmation detection but more relay traffic. Default of 5000ms (5 seconds) is recommended.

Changes Take Effect

After saving configuration changes, new invoices will use the updated settings immediately. Existing unpaid invoices are not affected.

Clone this wiki locally