summaryrefslogtreecommitdiff
path: root/bip-0072.mediawiki
diff options
context:
space:
mode:
Diffstat (limited to 'bip-0072.mediawiki')
-rw-r--r--bip-0072.mediawiki63
1 files changed, 63 insertions, 0 deletions
diff --git a/bip-0072.mediawiki b/bip-0072.mediawiki
new file mode 100644
index 0000000..77c1276
--- /dev/null
+++ b/bip-0072.mediawiki
@@ -0,0 +1,63 @@
+{{bip}}
+
+<pre>
+ BIP: 72
+ Title: bitcoin: uri extensions for Payment Protocol
+ Author: Gavin Andresen <gavinandresen@gmail.com>
+ Status: Draft
+ Type: Standards Track
+ Created: 29-07-2013
+</pre>
+
+==Abstract==
+
+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
+"request" 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 "request" 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:?request=... ).
+
+When Bitcoin wallet software that supports this BIP receives a
+bitcoin: URI with a request 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
+request parameter and will initiate a payment to bitcoin address.
+
+==Examples==
+A backwards-compatible request:
+<pre>
+bitcoin:mq7se9wy2egettFxPbmn99cK8v5AFq55Lx?amount=0.11&request=https%3A%2F%2Fmerchant.com%2Fpay.php%3Fh%3D2a8628fc2fbe
+</pre>
+Non-backwards-compatible equivalent:
+<pre>
+bitcoin:?request=https%3A%2F%2Fmerchant.com%2Fpay.php%3Fh%3D2a8628fc2fbe
+</pre>
+[[Category:BIP]]