Logo officiel du MASTR MASTR
Menu

Bitcoin : récupération et Lightning

BOLT 11 invoices: what a Lightning payment request actually says

A signed invoice carries payment conditions; it is neither a reusable bank account nor proof of delivery.

Mis à jour le 30 septembre 2026 · MASTR Labs

Les articles et schémas techniques sont en anglais. La navigation est disponible en 7 langues.

Guides de référence
  1. A structured request
  2. Expiry and destination
  3. Invoice, address and receipt
  4. Practical review
  5. Exemple concret
  6. Sources et originaux

A structured request

A BOLT 11 invoice encodes a Lightning payment request with a network prefix, timestamp, tagged fields and a signature. Fields can include a payment hash, amount, description or description hash, expiry and routing hints. Not every invoice has a fixed amount. The payer’s wallet must interpret the actual fields instead of relying on the surrounding webpage’s label. 1

Expiry and destination

Expiry tells the payer how long the request is intended to remain usable; it does not reserve a route or liquidity. Routing hints can help reach a recipient whose channels are not fully public. An invoice’s cryptographic signature is useful for validating the request’s structure and origin key, but does not establish that the key belongs to a trustworthy merchant or that goods will arrive.

Invoice, address and receipt

An invoice is not an on-chain Bitcoin address. Nor is it the same as a Lightning address, which is a human-readable way to ask a service for payment information. A settled payment is another object again. Payment hashes and their preimages help the protocol coordinate completion; a wallet’s history and relevant payment details support later reconciliation. Do not reuse old invoice screenshots as new payment requests. 2

Practical review

Before paying, compare the decoded amount, network, description and expiry with what you intended to purchase. A description hash commits to supplied description material; the wallet needs that material to make it meaningful to a person. A valid invoice can still be unaffordable to route, expired by the time you act, or supplied by an impostor. Treat invoice decoding as one check in a broader payment decision.

3 objects, 3 different jobs
Schéma explicatif. Ouvrir en pleine taille. Credits ↗ A signed request is not a delivery guarantee.

Exemple concret

A store shows a price of 20,000 sats, but the decoded request has no amount. The payer must set and confirm the intended value. The website’s text is not a substitute for the wallet’s decoded payment request. No real invoice or payment destination is included in this example.

Sources et originaux

  1. BOLT 11: payment encoding
  2. BOLT 4: onion routing and payment processing

Pour aller plus loin

Bitcoin : récupération et Lightning →

MASTR

Soutenir la recherche indépendante

Les enquêtes, les preuves originales et les guides sont en accès libre. Les dons volontaires contribuent au financement de la recherche et au maintien des outils MASTR.

Ouvrir le portefeuille