|
|
| Line 10: |
Line 10: |
| | </pre> | | </pre> |
| | | | |
| − | ==Abstract==
| + | {{BipMoved|bip-0073.mediawiki|BIP 0073}} |
| − | | |
| − | This BIP describes an enhancement to the payment protocol ([[BIP 0070|BIP 70]])
| |
| − | that addresses the need for short URLs when scanning from QR codes. It
| |
| − | generalizes the specification for the behavior of a payment request URL in a
| |
| − | way that allows the client and server to negotiate the content of the
| |
| − | response using the HTTP Accept: header field. Specifically, the client
| |
| − | can indicate to the server whether it prefers to receive a bitcoin URI or
| |
| − | a payment request.
| |
| − | | |
| − | Implementation of this BIP does not require full payment request ([[BIP 0070|BIP 70]]) support.
| |
| − | | |
| − | ==Motivation==
| |
| − | | |
| − | The payment protocol augments the bitcoin: uri scheme with an additional
| |
| − | "payment" parameter that specifies a URL where a payment request can be
| |
| − | downloaded. This creates long URIs that, when rendered as a QR code, have
| |
| − | a high information density. Dense QR codes can be difficult to scan resulting
| |
| − | in a more frustrating user experience. The goal is to create a standard that
| |
| − | would allow QR scanning wallets to use less dense QR codes. It also makes
| |
| − | general purpose QR code scanners more usable with bitcoin accepting
| |
| − | websites.
| |
| − | | |
| − | ==Specification==
| |
| − | | |
| − | QR scanning wallets will consider a non bitcoin URI scanned from a QR code to
| |
| − | be an end point where either a bitcoin URI or a payment request can be obtained.
| |
| − | | |
| − | A wallet client uses the Accept: HTTP header to specify whether it can accept
| |
| − | a payment request, a URI, or both. A media type of text/uri-list specifies that
| |
| − | the client accepts a bitcoin URI. A media type of application/bitcoin-paymentrequest
| |
| − | specifies that the client can process a payment request. In the absence of an
| |
| − | Accept: header, the server is expected to respond with text/html suitable for
| |
| − | rendering in a browser. An HTML response will ensure that QR codes scanned
| |
| − | by non Bitcoin wallet QR scanners are useful (they could render an HTML page
| |
| − | with a payment link that when clicked would open a wallet on the device).
| |
| − | | |
| − | It is not required that the client and server support the full semantics of an
| |
| − | HTTP Accept header. If application/bitcoin-paymentrequest is specified in the
| |
| − | header, the server should send a payment request regardless of anything else
| |
| − | specified in the Accept header. If text/uri-list is specified (but not
| |
| − | application/bitcoin-paymentrequest), a valid Bitcoin URI should be returned. If
| |
| − | neither is specified, the server can return an HTML page. When a uri-list is returned
| |
| − | only the first item in the list is used (and expected to be a bitcoin URI), any additional
| |
| − | URIs should be ignored.
| |
| − | | |
| − | ==Compatibility==
| |
| − | | |
| − | Only QR scanning wallets that implement this BIP will be able to process QR
| |
| − | codes containing payment request URLs. There are two possible workarounds for QR
| |
| − | scanning wallets that do not implement this BIP: 1) the server gives the user an
| |
| − | option to change the QR code to a bitcoin: URI or 2) the user scans the code with
| |
| − | a generic QR code scanner.
| |
| − | | |
| − | In the second scenario, if the server responds with a webpage containing a link
| |
| − | to a bitcoin URI, the user can complete the payment by clicking that link provided
| |
| − | the user has a wallet installed on their device and it supports bitcoin URIs. If the
| |
| − | wallet/device does not have support for bitcoin URIs, the user can fall back on
| |
| − | address copy/paste.
| |
| − | | |
| − | This BIP should be fully compatible with BIP 70 assuming it is required that wallets
| |
| − | implementing BIP 70 make use of the Accept: HTTP header when retrieving a
| |
| − | payment request.
| |
| − | | |
| − | ==Examples==
| |
| − | The first image below is of a bitcoin URI with an amount and payment request
| |
| − | specified (note, this is a fairly minimal URI as it does not contain a
| |
| − | label and the request URL is of moderate size). The second image is a QR
| |
| − | code with only the payment request url specified.
| |
| | | | |
| | [[File:BIP_0073a.png]] [[File:BIP_0073b.png]] | | [[File:BIP_0073a.png]] [[File:BIP_0073b.png]] |
| | [[Category:BIP]] | | [[Category:BIP]] |
