|
|
| Line 10: |
Line 10: |
| </pre> | | </pre> |
|
| |
|
| ==Abstract==
| | {{BipMoved|bip-0072.mediawiki|BIP 0072}} |
|
| |
|
| This BIP describes an extension to the bitcoin: URI scheme (BIP 21) to
| |
| support the payment protocol (BIP 70).
| |
|
| |
| ==Motivation==
| |
|
| |
| Allow users to click on a link in a web page or email to initiate the
| |
| payment protocol, while being backwards-compatible with existing
| |
| bitcoin wallets.
| |
|
| |
| ==Specification==
| |
|
| |
| The bitcoin: URI scheme is extended with an additional, optional
| |
| "r" parameter, whose value is a URL from which a PaymentRequest
| |
| message should be fetched (unsafe and reserved octets in the URL value
| |
| must be encoded as described in RFC 1738).
| |
|
| |
| If the "r" parameter is provided and backwards compatibility
| |
| is not required, then the bitcoin address portion of the URI may be
| |
| omitted (the URI will be of the form: bitcoin:?r=... ).
| |
|
| |
| When Bitcoin wallet software that supports this BIP receives a
| |
| bitcoin: URI with a r parameter, it should ignore the bitcoin
| |
| address/amount/label/message in the URI and instead fetch a
| |
| PaymentRequest message and then follow the payment protocol, as
| |
| described in BIP 70.
| |
|
| |
| Bitcoin wallets must support fetching PaymentRequests via http and
| |
| https protocols; they may support other protocols. Wallets must
| |
| include an Accept HTTP header in HTTP requests:
| |
| <pre>Accept: application/bitcoin-paymentrequest</pre>
| |
|
| |
| If a PaymentRequest cannot be obtained (perhaps the server is
| |
| unavailable), then the customer should be informed that the merchant's
| |
| payment processing system is unavailable.
| |
|
| |
| ==Compatibility==
| |
|
| |
| Wallet software that does not support this BIP will simply ignore the
| |
| r parameter and will initiate a payment to bitcoin address.
| |
|
| |
| ==Examples==
| |
| A backwards-compatible request:
| |
| <pre>
| |
| bitcoin:mq7se9wy2egettFxPbmn99cK8v5AFq55Lx?amount=0.11&r=https%3A%2F%2Fmerchant.com%2Fpay.php%3Fh%3D2a8628fc2fbe
| |
| </pre>
| |
| Non-backwards-compatible equivalent:
| |
| <pre>
| |
| bitcoin:?r=https%3A%2F%2Fmerchant.com%2Fpay.php%3Fh%3D2a8628fc2fbe
| |
| </pre>
| |
| [[Category:BIP]] | | [[Category:BIP]] |
|
This page describes a BIP (Bitcoin Improvement Proposal).
Please see BIP 2 for more information about BIPs and creating them. Please do not just create a wiki page.
|
BIP: 72
Title: bitcoin: uri extensions for Payment Protocol
Author: Gavin Andresen <gavinandresen@gmail.com>
Status: Draft
Type: Standards Track
Created: 29-07-2013
|
Please do not modify this page. This is a mirror of the BIP from the source Git repository here.
|