Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
24 commits
Select commit Hold shift + click to select a range
6f7e8cd
Sending bitcoin page Lightning addition
GBKS Dec 7, 2021
49ba904
Copy and image iteration
GBKS Dec 13, 2021
250f00b
Update guide/payments/payment-request-formats.md
GBKS Dec 15, 2021
6443aa1
Update guide/payments/payment-request-formats.md
GBKS Dec 15, 2021
7011d13
Update guide/payments/payment-request-formats.md
GBKS Dec 15, 2021
a636129
Update guide/payments/payment-request-formats.md
GBKS Dec 15, 2021
c9196c1
Update guide/payments/send.md
GBKS Dec 15, 2021
82883c5
Update guide/payments/send.md
GBKS Dec 15, 2021
8faa7e6
Update guide/payments/send.md
GBKS Dec 15, 2021
7af17eb
Update guide/payments/send.md
GBKS Dec 16, 2021
cb14a02
Update guide/payments/send.md
GBKS Dec 16, 2021
71c485c
Update guide/payments/send.md
GBKS Dec 16, 2021
0a852a7
Update guide/payments/send.md
GBKS Dec 16, 2021
d30a53f
Update guide/payments/send.md
GBKS Dec 16, 2021
9b61ae6
Update guide/payments/send.md
GBKS Dec 16, 2021
ece269d
Minor fixes based on feedback
GBKS Dec 17, 2021
a9d7334
Merge branch 'feature/sending-bitcoin-lightning-iteration' of https:/…
GBKS Dec 17, 2021
ab48f00
Various minor tweaks to address feedback
GBKS Dec 20, 2021
9606e39
Minor copy tweaks
GBKS Dec 20, 2021
2969599
Added transaction history screen with status info
GBKS Dec 20, 2021
67664bd
SEO title revision and image alt texts
GBKS Dec 20, 2021
718169e
Added link to article around response time limits
GBKS Dec 20, 2021
ada5fbe
Revised first sentence
GBKS Dec 20, 2021
a3442d0
Merge branch 'master' into feature/sending-bitcoin-lightning-iteration
GBKS Dec 21, 2021
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 51 additions & 0 deletions _compress_images_cache.yml
Original file line number Diff line number Diff line change
Expand Up @@ -1481,3 +1481,54 @@ assets/images/guide/private-key-management/external-signers/external-signing-dev
assets/images/guide/private-key-management/external-signers/external-signing-device-preview.png: external-signing-device-preview.png
assets/images/guide/private-key-management/external-signers/external-signing-device.png: external-signing-device.png
assets/images/guide/private-key-management/external-signers/external-signing-device@2x.png: external-signing-device@2x.png
assets/images/guide/payments/send/donation-qr-code-1.png: donation-qr-code-1.png
assets/images/guide/payments/send/donation-qr-code.png: donation-qr-code.png
assets/images/guide/payments/send/donation-page-copy.png: donation-page-copy.png
assets/images/guide/payments/send/donation-page-copy@2x.png: donation-page-copy@2x.png
assets/images/guide/payments/send/donation-page-link.png: donation-page-link.png
assets/images/guide/payments/send/donation-page-link@2x.png: donation-page-link@2x.png
assets/images/guide/payments/send/donation-qr-code@2x.png: donation-qr-code@2x.png
assets/images/guide/payments/send/home.png: home.png
assets/images/guide/payments/send/home@2x.png: home@2x.png
assets/images/guide/payments/send/pick-contact.png: pick-contact.png
assets/images/guide/payments/send/pick-contact@2x.png: pick-contact@2x.png
assets/images/guide/payments/send/review-with-label-and-tags.png: review-with-label-and-tags.png
assets/images/guide/payments/send/review-with-label-and-tags@2x.png: review-with-label-and-tags@2x.png
assets/images/guide/payments/send/review.png: review.png
assets/images/guide/payments/send/review@2x.png: review@2x.png
assets/images/guide/payments/send/generic-error-details.png: generic-error-details.png
assets/images/guide/payments/send/generic-error-details@2x.png: generic-error-details@2x.png
assets/images/guide/payments/send/generic-error.png: generic-error.png
assets/images/guide/payments/send/generic-error@2x.png: generic-error@2x.png
assets/images/guide/payments/send/routing-error.png: routing-error.png
assets/images/guide/payments/send/routing-error@2x.png: routing-error@2x.png
assets/images/guide/payments/send/Withdraw invoice.png: Withdraw invoice.png
assets/images/guide/payments/send/Withdraw invoice@2x.png: Withdraw invoice@2x.png
assets/images/guide/payments/send/error-incompatibility.png: error-incompatibility.png
assets/images/guide/payments/send/error-incompatibility@2x.png: error-incompatibility@2x.png
assets/images/guide/payments/send/error-invoice-expired.png: error-invoice-expired.png
assets/images/guide/payments/send/error-invoice-expired@2x.png: error-invoice-expired@2x.png
assets/images/guide/payments/send/lightning-address-options.png: lightning-address-options.png
assets/images/guide/payments/send/lightning-address-options@2x.png: lightning-address-options@2x.png
assets/images/guide/payments/send/pay-invoice-with-details.png: pay-invoice-with-details.png
assets/images/guide/payments/send/pay-invoice-with-details@2x.png: pay-invoice-with-details@2x.png
assets/images/guide/payments/send/pay-invoice-without-amount.png: pay-invoice-without-amount.png
assets/images/guide/payments/send/pay-invoice-without-amount@2x.png: pay-invoice-without-amount@2x.png
assets/images/guide/payments/send/withdraw-invoice.png: withdraw-invoice.png
assets/images/guide/payments/send/withdraw-invoice@2x.png: withdraw-invoice@2x.png
assets/images/guide/payments/send/fee-options.png: fee-options.png
assets/images/guide/payments/send/fee-options@2x.png: fee-options@2x.png
assets/images/guide/payments/send/confirm.png: confirm.png
assets/images/guide/payments/send/confirm@2x.png: confirm@2x.png
assets/images/guide/payments/send/processing.png: processing.png
assets/images/guide/payments/send/processing@2x.png: processing@2x.png
assets/images/guide/payments/send/success.png: success.png
assets/images/guide/payments/send/success@2x.png: success@2x.png
assets/images/guide/payments/send/processing-longer-wait.png: processing-longer-wait.png
assets/images/guide/payments/send/processing-longer-wait@2x.png: processing-longer-wait@2x.png
assets/images/guide/payments/send/processing-on-chain.png: processing-on-chain.png
assets/images/guide/payments/send/processing-on-chain@2x.png: processing-on-chain@2x.png
assets/images/guide/payments/send/confirm-fees.png: confirm-fees.png
assets/images/guide/payments/send/confirm-fees@2x.png: confirm-fees@2x.png
assets/images/guide/payments/send/processing-transactions.png: processing-transactions.png
assets/images/guide/payments/send/processing-transactions@2x.png: processing-transactions@2x.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/images/guide/payments/send/confirm.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/images/guide/payments/send/confirm@2x.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/images/guide/payments/send/fee-options.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/images/guide/payments/send/home.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/images/guide/payments/send/home@2x.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/images/guide/payments/send/processing.png
Binary file added assets/images/guide/payments/send/review.png
Binary file added assets/images/guide/payments/send/review@2x.png
Binary file added assets/images/guide/payments/send/success.png
Binary file added assets/images/guide/payments/send/success@2x.png
2 changes: 1 addition & 1 deletion guide/payments/coin-selection.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
layout: guide
title: Coin Selection
description: A primer on how UTXOs are chosen to fund new bitcoin transactions.
nav_order: 1
nav_order: 2
grand_parent: Payments
parent: Sending bitcoin
permalink: /guide/payments/send/coin-selection/
Expand Down
139 changes: 139 additions & 0 deletions guide/payments/payment-request-formats.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,139 @@
---
layout: guide
title: Payment request formats
description: An introduction to how sending bitcoin works.
nav_order: 1
grand_parent: Payments
parent: Sending bitcoin
has_children: false
permalink: /guide/payments/send/payment-request-formats/
main_classes: -no-top-padding
image: /assets/images/guide/payments/send/bitcoin-payments-social.jpg

image_base: /assets/images/guide/payments/send/
images:
- file: home
alt:
caption:
---

<!--

Editor's notes

-->

# Payment request formats

Payment information can be shared in many formats and over diverse communication channels. Each has its advantages and limitations, these formats seen together allow for broad flexibility in initiating payments. Some of them are still maturing and have varying support across applications.

### On-chain addresses

Addresses are used for transactions on the base layer. More details on the [address page]({{ '/guide/glossary/address/' | relative_url }}) in the Glossary.

### Lightning invoices ([BOLT 11](https://github.com/lightning/bolts/blob/master/11-payment-encoding.md))

Lightning invoices are the basic payment mechanism on the Lightning network. They are usually set to expire after 1 hour and should only be paid once for best security and privacy. Invoices must be created by the recipient and shared with the sender, who then makes the payment.

### Offers ([BOLT 12](https://bolt12.org))

This draft specification has similarities with to LNURL-Pay and LNURL-Withdraw, but uses the Lightning network itself as the communication channel.

### [Lightning AMP invoices](https://docs.lightning.engineering/lightning-network-tools/lnd/amp) (Atomic Multi-Path)

This type of invoice allows for small payments to be broken up, potentially increasing the likelihood of success for larger amounts. Invoices typically expire after one day but can also be configured to be static and be paid multiple times. Unlike BOLT 11 invoices, AMP invoices can also be initiated by the sender without action by the recipient.

### Lightning node IDs

Senders can initiate payments to recipients only knowing their node ID, using [Keysend](https://lightning.readthedocs.io/lightning-keysend.7.html) and AMP invoices.

### [LNURL](https://coincharge.io/en/lnurl-for-lightning-wallets/)

This internet-based protocol establishes techniques on top of Lightning invoices for several important use cases, including the following:

**LNURL-Pay**

Makes it possible to generate Lightning invoices on-demand, based on a static identifier (in contrast with regular Lightning invoices, which expire and should only be paid once).

**LNURL-Withdraw**

Allows for invoices to offer withdrawals with optional minimum and maximum amounts.

### [Lightning addresses](https://lightningaddress.com)

This identifier builds on top of LNURL-Pay and introduces the familiar format of email addresses as identifiers.

## Examples

Each request format has its own unique approach to bundle payment information for transmission. Unique are Lightning addresses, which are easily readable and memorizable by users.

{% include fact/open.html color="blue" label="On-chain address" icon="triangle" %}

<span style="word-break: break-word;">bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq</span>

{% include fact/close.html %}

{% include fact/open.html color="blue" label="Lightning invoice (BOLT 11)" icon="triangle" %}

<span style="word-break: break-word;">LNBC1PVJLUEZSP5ZYG3ZYG3ZYG3ZYG3ZYG3ZYG3ZYG3ZYG3ZYG3ZYG3ZYG3ZYG3ZYGSPP5QQQSYQCYQ5RQWZQFQQQSYQCYQ5RQWZQFQQQSYQCYQ5RQWZQFQYPQDPL2PKX2CTNV5SXXMMWWD5KGETJYPEH2URSDAE8G6TWVUS8G6RFWVS8QUN0DFJKXAQ9QRSGQ357WNC5R2UEH7CK6Q93DJ32DLQNLS087FXDWK8QAKDYAFKQ3YAP9US6V52VJJSRVYWA6RT52CM9R9ZQT8R2T7MLCWSPYETP5H2TZTUGP9LFYQL</span>

{% include fact/close.html %}

{% include fact/open.html color="blue" label="Offer (BOLT 12)" icon="triangle" %}

<span style="word-break: break-word;">LNO1PG257ENXV4EZQCNEYPE82UM50YNHXGRWDAJX283QFWDPL28QQMC78YMLVHMXCSYWDK5WRJNJ36JRYG488QWLRNZYJCZS</span>

{% include fact/close.html %}

{% include fact/open.html color="blue" label="Lightning AMP invoice" icon="triangle" %}

<span style="word-break: break-word;">lnbc1pvjluezsp5zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygspp5qqqsyqcyq5rqwzqfqqqsyqcyq5rqwzqfqqqsyqcyq5rqwzqfqypqdpl2pkx2ctnv5sxxmmwwd5kgetjypeh2ursdae8g6twvus8g6rfwvs8qun0dfjkxaq9qrsgq357wnc5r2ueh7ck6q93dj32dlqnls087fxdwk8qakdyafkq3yap9us6v52vjjsrvywa6rt52cm9r9zqt8r2t7mlcwspyetp5h2tztugp9lfyql</span>

{% include fact/close.html %}

{% include fact/open.html color="blue" label="Lightning node ID" icon="triangle" %}

<span style="word-break: break-word;">026e6215d95fa7ef6c3d214ffa24be987dec4aa2d9474b82a6dd07c0d927d3640b@35.234.119.46:9735</span>

{% include fact/close.html %}

{% include fact/open.html color="blue" label="LNURL-Pay" icon="triangle" %}

<span style="word-break: break-word;">LNURL1DP68GURN8GHJ7MRWW4EXCTT5DAHKCCN00QHXGET8WFJK2UM0VEAX2UN09E3K7MF0W5LHZ0TPVC6RQENRXQMXXDFNXSCRYDE3V5UXXDNXVDNX2DNYXGURXER98QURWWP3XAJNZVPHVGCXYDPCVDJRSC3S8QUNWVF5XVUNSVF4XG6NGAKYX3T</span>

{% include fact/close.html %}

{% include fact/open.html color="blue" label="LNURL-Withdraw" icon="triangle" %}

<span style="word-break: break-word;">LNURL1DP68GURN8GHJ7MRWW4EXCTT5DAHKCCN00QHXGET8WFJK2UM0VEAX2UN09E3K7MF0W5LHZ0FHXSMRSVNXVESKVEPEX9NRGETYX5ENGVTYXCUR2ENYVE3KVDFKXYCXVDF4XCURSVR9XFJR2DMPX9NRVETPXPSKVCTPX3SKGEPCXGCRYKNQXCW</span>

{% include fact/close.html %}

{% include fact/open.html color="blue" label="LNURL-Auth" icon="triangle" %}

<span style="word-break: break-word;">LNURL1DP68GURN8GHJ7MRWW4EXCTT5DAHKCCN00QHXGET8WFJK2UM0VEAX2UN09E3K7MF0W5LHGCT884KX7EMFDCNXKVFAVGURWWT9XYCNYE35XUMRXCEHVY6NGDEHVSUNWWPEV5UN2VMY8Q6RGDF4XVEXYE33V56NSETRVVMRGEFEVCMRWENPXCUXYEP48PNX2EQPG3G5S</span>

{% include fact/close.html %}

{% include fact/open.html color="blue" label="LNURL-Channel" icon="triangle" %}

<span style="word-break: break-word;">LNURL1DP68GURN8GHJ7MRWW4EXCTT5DAHKCCN00QHXGET8WFJK2UM0VEAX2UN09E3K7MF0W5LHZ0F4VFJK2CEHX5CR2DT9XP3XZWP4V5EN2VF489SKYCFJX5UR2VTYV4SKYWRZX93RSEPJV9SKGVRRXYER2WT9XEJNZEPKX4NRGDEEXS6R2XNW3D6</span>

{% include fact/close.html %}

{% include fact/open.html color="blue" label="Lightning addresses" icon="triangle" %}

<span style="word-break: break-word;">satoshi@yourdomain.com</span>

{% include fact/close.html %}

---

Sending is one side of the process. Let's look at things from the [receiver's perspective](/guide/payments/receive).

{% include next-previous.html
previousUrl = "/guide/payments/transactions/"
previousName = "Transactions overview"
nextUrl = "/guide/payments/receive"
nextName = "Receiving bitcoin"
%}
Loading