|
|
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]] |