Skip to content

Frequently Asked Questions

Jump to bottom
WoompaLoompa edited this page Jul 21, 2026 · 2 revisions

Common questions about the CLINK payment plugin.

General

What is CLINK?

CLINK (Common Lightning Interface for Nostr Keys) is a protocol for Lightning Network payments that uses Nostr for transport. Unlike LNURL or Bolt12, it doesn't require a web server for your Lightning node.

Why use CLINK instead of other Lightning methods?

Feature CLINK LNURL Bolt12
Web server required No Yes No
Nostr integration Native No No
Privacy High Medium Medium
Setup complexity Low High Medium

Is it secure?

Yes! CLINK uses:

  • Cryptographic signatures
  • NIP-44 encryption
  • Ephemeral keys for privacy
  • No pre-shared secrets

Installation

What Medusa version is supported?

Medusa v2.x. v1 support is experimental.

Do I need a Lightning node?

Yes, or a wallet that supports CLINK:

  • ShockWallet (iOS/Android)
  • Lightning.Pub (self-hosted)
  • ZEUS (iOS/Android)

How much does it cost?

The plugin is free and open source (GPL-3.0). You only need a Lightning wallet.

Payments

What currencies are supported?

All currencies supported by CoinGecko/Kraken:

  • USD, EUR, GBP, JPY, and 50+ others

How fast are payments?

Lightning payments settle in:

  • Typically 1-3 seconds
  • Maximum ~10 seconds

What are the fees?

Lightning network fees are minimal:

  • Usually 0.1-1% of the amount
  • Often just a few sats

Can I receive regular Bitcoin?

No, this uses Lightning Network for instant payments. Regular Bitcoin transactions are too slow for checkout.

Subscriptions

How do auto-renewals work?

  1. Customer pays first invoice manually
  2. Gets ndebit1... string from wallet
  3. Pastes in subscription settings
  4. Future payments process automatically

Can customers cancel?

Yes! Customers can:

  • Disable auto-renewal anytime
  • Remove their nDebit
  • Pay manually instead

What if payment fails?

The plugin will:

  • Retry payment
  • Notify customer
  • Allow manual payment

Troubleshooting

Payment not confirming?

  1. Check invoice hasn't expired
  2. Verify Nostr relay connection
  3. Enable debug mode
  4. Check logs

Wrong amount showing?

  1. Check currency source
  2. Verify exchange rate API
  3. Try fixed rate temporarily

Plugin not appearing?

  1. Verify installation
  2. Check config syntax
  3. Restart Medusa

Technical

Can I customize the checkout UI?

Yes! The plugin returns invoice data that you can display however you want.

Does it work with Medusa Cloud?

Yes! The plugin works with Medusa Cloud deployments.

Can I add my own exchange rate source?

Yes! The architecture supports custom sources. See Contributing guide.

Support

Where can I get help?

How do I report a bug?

  1. Check existing issues
  2. Create new issue with:
    • Steps to reproduce
    • Expected vs actual behavior
    • Environment details
    • Logs (if available)

How do I request a feature?

  1. Check discussions
  2. Create feature request issue
  3. Describe use case and proposed solution

Related Pages

Clone this wiki locally