core-lightning/doc
Vincenzo Palazzo 6f0dbbb20f bolt12: allow to inject payer_metadata
Payer metadata is a field that controls the payer ID
provided during the fetchinvoice process.

There are use cases where this is highly useful, such as
proving that the payer has paid for the correct item.

Imagine visiting a merchant's website to pay for multiple offers, where
one of these offers is a default offer (with no description and no set amount).

In this scenario, the merchant could claim not to have received
payment for a specific item. Since the same offer may be used to
fetch invoices for different products, there needs to be a way to
identify which product the invoice corresponds to.

With this commit, it will be possible to inject payer metadata,
which helps solve the issue described above.

For example, possible payer metadata could be `to_hex(b"{payer_node_id}.{product_id}.{created_at}")`.

Changelog-Added: JSON-RPC: `fetchinvoice` allows setting invreq_metadata via `payer_metadata` parameter.
Signed-off-by: Vincenzo Palazzo <vincenzopalazzodev@gmail.com>
2024-11-19 22:54:22 +01:00
..
beginners-guide docs: Added info for NFS version 2024-08-22 11:52:19 -07:00
contribute-to-core-lightning pytest: Allow a specific lightningd for DEBUG_SUBD 2024-11-18 11:03:26 +10:30
developers-guide lightningd: deprecate experimental-offers option. 2024-11-18 10:42:54 +01:00
getting-started lightningd: deprecate experimental-offers option. 2024-11-18 10:42:54 +01:00
miscellaneous move old misc file to another folder 2023-07-16 12:59:40 +09:30
node-operators-guide doc: Updated dev command warning 2024-04-04 13:16:27 +10:30
schemas bolt12: allow to inject payer_metadata 2024-11-19 22:54:22 +01:00
.gitignore doc: document the sql command. 2023-01-30 15:15:41 -06:00
CHANGELOG.md docs: Add configuration for the sphinx documentation generator 2019-02-18 02:42:29 +00:00
index.rst xpay: new plugin which uses askrene, injectpaymentonion. 2024-11-18 11:03:26 +10:30
LICENSE.md docs: Add LICENSE to the About section 2023-03-25 15:40:35 +10:30
lightning-cli.1.md Add missing docs and Changelog-Added line. 2024-05-08 21:05:49 -05:00
lightning-hsmtool.8.md lightning-hsmtool.8.md: Update documentation showing new method 2024-11-15 12:48:44 +10:30
lightningd-config.5.md lightningd: deprecate experimental-offers option. 2024-11-18 10:42:54 +01:00
lightningd-rpc.7.md doc: fix typos 2024-02-11 11:27:41 +01:00
lightningd.8.md newaddr: various fixes for msggen and docs 2024-04-17 14:47:52 +02:00
Makefile xpay: new plugin which uses askrene, injectpaymentonion. 2024-11-18 11:03:26 +10:30
reckless.7.md doc: update reckless documentation 2024-02-07 13:24:34 +01:00
rpc-schema-draft.json doc: fix all JSON schemas to enforce no additional properties. 2024-10-30 15:39:12 +10:30
undoc-flags.list tools/check-manpage.sh: update undoc to a simple list. 2023-08-18 20:29:34 +09:30