Skip to content

lnbits/lnurlp

Repository files navigation

LNbits

License: MIT Built for LNbits

LNURLp - LNbits extension

For more about LNBits extension check this tutorial

Features

  • Reusable pay links - one QR code or link can receive many payments
  • Lightning Address - receive payments at names like alice@example.com
  • Fixed or flexible amounts - set one amount or a min/max range
  • Fiat pricing - price in a fiat currency and convert to sats at payment time
  • Comments and success messages - collect a short note and reply after payment
  • Webhooks - notify another system when a link is paid
  • Nostr zaps - receive NIP-57 zaps through a pay link

Overview

LNURLp creates reusable Lightning payment links. The QR code stays the same, but every time someone scans it with an LNURL-compatible wallet, LNbits creates a fresh invoice for that payment.

Use LNURLp for donation pages, tip jars, checkout links, printed QR codes, Lightning Addresses, or simple payment pages that do not need a full shop.

Wallets supporting LNURL

Usage

  1. Create a new pay link.

    Create LNURLp

  2. Fill in the basics:

    • Wallet to receive payments
    • Description shown to the payer
    • Amount, or min/max amount if it is not fixed
    • Currency, if you want fiat pricing instead of sats
  3. Open the link details.

    LNURLp list

  4. Share the page, copy the LNURL, write it to NFC, or print the QR code.

    View LNURLp

Lightning Address

Add a username to a pay link to create a Lightning Address.

For example, username alice on example.com becomes:

alice@example.com

You can also set a custom domain on the pay link. Use this when your public Lightning Address domain is different from the LNbits host.

Fiat Amounts

Set a currency such as EUR or USD when you want the payer to pay a fiat-denominated price. LNbits converts the amount to sats when the wallet requests the invoice.

Use fixed amounts for products or donations with a set price. Use min/max amounts for tips, pay-what-you-want pages, and open donations.

Comments and Success Actions

LNURLp can ask the payer for a short comment. This is useful for names, order notes, blog comments, or donation messages.

After payment, the payer's wallet can show:

  • A success message
  • A secure https:// success URL

Use success actions for thank-you notes, download links, gated pages, or next steps after payment.

Webhooks

Add a webhook URL when another app should be notified after a payment. LNURLp sends payment details to the webhook and can include:

  • The payment hash and invoice
  • The paid amount
  • The payer comment
  • Custom webhook data
  • Optional custom headers and body data
  • Zap receipt data when Nostr zaps are enabled

Nostr Zaps

Enable zaps when the pay link should support NIP-57 Nostr zap payments. Admins can set the extension's Nostr private key in the LNURLp settings dialog.

When a zap payment is paid, LNURLp signs a zap receipt and sends it to the relays from the zap request.

Disposable Pay Requests

LNURLp supports disposable and storeable pay requests. The default is disposable, which is the safest option for normal reusable QR codes and payment pages.

When enabled, wallets can save the LNURLp or lnaddress, for reuse later. LUD-11

Only change this if you know your wallet or integration needs storeable pay requests.

Powered by LNbits

LNbits is a free and open-source lightning accounts system.

Visit LNbits Shop Try myLNbits SaaS

About

LNbits Pay Links with lnurlp extension

Resources

License

Security policy

Stars

13 stars

Watchers

5 watching

Forks

Contributors