joshua/dash-docs
1
0
Fork 0
mirror of https://github.com/seigler/dash-docs synced 2025-07-27 09:46:12 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Clarification Of PaymentRequestss And Payment Verification

Browse source 
* Clarify a few places where payment request was used instead of
  PaymentRequest.

* Clarify that payment isn't necessarily verified until the merchant
  says so. Suggested by @saivann (thanks!)
This commit is contained in:
David A. Harding 2014-06-09 13:44:23 -04:00
parent 74be6424de
commit fe16cd7781
No known key found for this signature in database
GPG key ID: 4B29C30FF29EC4B7
1 changed files with 8 additions and 8 deletions
Download patch file Download diff file Expand all files Collapse all files

16
_includes/guide_payment_processing.md
View file

@ -316,9 +316,9 @@ a `bitcoin:` URI for Charlie to click to pay.
Charlie clicks on the `bitcoin:` URI in his browser. His browser's URI Charlie clicks on the `bitcoin:` URI in his browser. His browser's URI
handler sends the URI to his wallet program. The wallet is aware of the handler sends the URI to his wallet program. The wallet is aware of the
Payment Protocol, so it parses the `r` parameter and sends an HTTP GET Payment Protocol, so it parses the `r` parameter and sends an HTTP GET
to that URL looking for a payment request. to that URL looking for a PaymentRequest message.
The PaymentRequest message may include private information, such as Charlie's The PaymentRequest message returned may include private information, such as Charlie's
mailing address, but the wallet must be able to access it without using prior mailing address, but the wallet must be able to access it without using prior
authentication, such as HTTP cookies, so a publicly-accessible HTTPS URL authentication, such as HTTP cookies, so a publicly-accessible HTTPS URL
with a guess-resistant part is typically used. The with a guess-resistant part is typically used. The
@ -327,8 +327,8 @@ a unique identifier. This is why, in the example URI above, the PaymentRequest
URL contains the P2PKH address: URL contains the P2PKH address:
`https://example.com/pay/mjSk1Ny9spzU2fouzYgLqGUD8U41iR35QN` `https://example.com/pay/mjSk1Ny9spzU2fouzYgLqGUD8U41iR35QN`
After receiving the HTTP GET to the URL above, the Payment After receiving the HTTP GET to the URL above, the
Request-generating CGI program on Bob's webserver takes the PaymentRequest-generating CGI program on Bob's webserver takes the
unique identifier from the URL and looks up the corresponding details in unique identifier from the URL and looks up the corresponding details in
the database. It then creates a PaymentDetails message with the the database. It then creates a PaymentDetails message with the
following information: following information:
@ -352,7 +352,7 @@ payment request to Charlie's wallet in the reply to the HTTP GET.
![Bitcoin Core Showing Validated Payment Request](/img/dev/en-btcc-payment-request.png) ![Bitcoin Core Showing Validated Payment Request](/img/dev/en-btcc-payment-request.png)
Charlie's wallet receives the payment request, checks its signature, and Charlie's wallet receives the PaymentRequest message, checks its signature, and
then displays the details from the PaymentDetails message to Charlie. Charlie then displays the details from the PaymentDetails message to Charlie. Charlie
agrees to pay, so the wallet constructs a payment to the output script agrees to pay, so the wallet constructs a payment to the output script
Bob's server provided. Unlike a traditional Bitcoin payment, Charlie's Bob's server provided. Unlike a traditional Bitcoin payment, Charlie's
@ -377,9 +377,9 @@ from Bob's server thanking Charlie for his patronage and providing other
information about the order, such as the expected arrival date. information about the order, such as the expected arrival date.
Charlie's wallet sees the PaymentACK and tells Charlie that the payment Charlie's wallet sees the PaymentACK and tells Charlie that the payment
has been sent. The PaymentACK doesn't mean that Charlie has actually has been sent. The PaymentACK doesn't mean that Bob has verified
paid Bob---see the Verifying Payment subsection below---but it does mean Charlie's payment---see the Verifying Payment subsection below---but it does mean
that he can go do something else while the transaction gets confirmed. that Charlie can go do something else while the transaction gets confirmed.
After Bob's server verifies from the block chain that Charlie's After Bob's server verifies from the block chain that Charlie's
transaction has been suitably confirmed, it authorizes shipping transaction has been suitably confirmed, it authorizes shipping
Charlie's order. Charlie's order.