diff --git a/bip-0072.mediawiki b/bip-0072.mediawiki new file mode 100644 index 00000000..77c12761 --- /dev/null +++ b/bip-0072.mediawiki @@ -0,0 +1,63 @@ +{{bip}} + +
+ BIP: 72 + Title: bitcoin: uri extensions for Payment Protocol + Author: Gavin Andresen+ +==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: ++ Status: Draft + Type: Standards Track + Created: 29-07-2013 +
Accept: application/bitcoin-paymentrequest+ +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: +
+bitcoin:mq7se9wy2egettFxPbmn99cK8v5AFq55Lx?amount=0.11&request=https%3A%2F%2Fmerchant.com%2Fpay.php%3Fh%3D2a8628fc2fbe ++Non-backwards-compatible equivalent: +
+bitcoin:?request=https%3A%2F%2Fmerchant.com%2Fpay.php%3Fh%3D2a8628fc2fbe ++[[Category:BIP]]