arno/bitcoinbook
1
0
Fork 0
mirror of https://github.com/bitcoinbook/bitcoinbook synced 2024-12-23 23:18:42 +00:00
Code Issues Releases Wiki Activity

CH02::invoice: replace "payment request" with "invoice"

Browse Source 
The payment request language is confusing because BIP70 payment requests
look a lot like the URI used here but this is not a BIP70 payment
request (and BIP70 is dead, so we need not describe it).

Instead, update the text to use the more generic word "invoice", which
has the advantage of also being simpler English.
This commit is contained in:
David A. Harding 2023-02-04 06:41:58 -10:00
parent 562304b4cf
commit 7a5351efa8
1 changed files with 10 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
ch02.asciidoc
View File

@ -88,12 +88,12 @@ $750 USD
---- ----
((("payment requests")))((("QR codes", "payment requests")))Bob's ((("payment requests")))((("QR codes", "payment requests")))Bob's
e-commerce system will automatically create a QR code containing a e-commerce system will automatically create a QR code containing an
_payment request_ (see <<payment-request-QR>>). _invoice_ (see <<invoice-QR>>).
Unlike a QR code that simply contains a destination Bitcoin address, a Unlike a QR code that simply contains a destination Bitcoin address, this
payment request is a QR-encoded URL that contains a destination address, invoice is a QR-encoded URI that contains a destination address,
a payment amount, and a generic description such as "Bob's Store - Order a payment amount, and a description such as "Bob's Store - Order
512". This allows a bitcoin wallet application to prefill the 512". This allows a bitcoin wallet application to prefill the
information used to send the payment while showing a human-readable information used to send the payment while showing a human-readable
description to the user. You can scan the QR code with a bitcoin wallet description to the user. You can scan the QR code with a bitcoin wallet
@ -103,8 +103,8 @@ application to see what Alice would see.
TODO: Replace QR code with test-BTC address TODO: Replace QR code with test-BTC address
//// ////
[[payment-request-QR]] [[invoice-QR]]
.Payment request QR code .Invoice QR code
image::images/mbc2_0202.png["payment-request"] image::images/mbc2_0202.png["payment-request"]
[TIP] [TIP]
@ -114,14 +114,14 @@ and cautions")))((("warnings and cautions", "avoid sending money to
addresses appearing in book")))Try to scan this with your wallet to see addresses appearing in book")))Try to scan this with your wallet to see
the address and amount but DO NOT SEND MONEY. the address and amount but DO NOT SEND MONEY.
==== ====
[[payment-request-URL]] [[invoice-URI]]
.The payment request QR code encodes the following URL, defined in BIP-21: .The invoice QR code encodes the following URI, defined in BIP21:
---- ----
bitcoin:bc1qk2g6u8p4qm2s2lh3gts5cpt2mrv5skcuu7u3e4?amount=0.01577764& bitcoin:bc1qk2g6u8p4qm2s2lh3gts5cpt2mrv5skcuu7u3e4?amount=0.01577764&
label=Bob%27s%20Store& label=Bob%27s%20Store&
message=Purchase%20at%20Bob%27s%20Store message=Purchase%20at%20Bob%27s%20Store
Components of the URL Components of the URI
A Bitcoin address: "bc1qk2g6u8p4qm2s2lh3gts5cpt2mrv5skcuu7u3e4" A Bitcoin address: "bc1qk2g6u8p4qm2s2lh3gts5cpt2mrv5skcuu7u3e4"
The payment amount: "0.01577764" The payment amount: "0.01577764"