Skip to content

LUD-XX Webhook notification for a third-party in pay protocol - #147

Draft
hsjoberg wants to merge 1 commit into
lnurl:ludsfrom
hsjoberg:webhook-notification
Draft

LUD-XX Webhook notification for a third-party in pay protocol#147
hsjoberg wants to merge 1 commit into
lnurl:ludsfrom
hsjoberg:webhook-notification

Conversation

@hsjoberg

@hsjoberg hsjoberg commented Apr 12, 2022

Copy link
Copy Markdown
Collaborator

I submit this pull request in a friendly manner as an alternative to the LUD-22 proposal.
The reason is that I think that LUD-22 as it stands right now worsens the user experience in a way I don't think is sound, it does not feel LNURL-ish.

LUD-22 strips the user out of LNURL-pay and they're only given a BOLT11. Unfortunately due to the way BOLT11 and LNURL-pay works, the only thing they get is a payment hash.

In LUD-23, the user and the wallet would still experience LNURL-pay as they normally do without a webhook.
The user possibly also opt out of the sending the third party notification if the wallet software makes this option available for them (possible privacy benefit).

Comment thread 23.md Outdated
Comment thread 23.md Outdated
@hsjoberg
hsjoberg force-pushed the webhook-notification branch from 4eb76be to 7d24b51 Compare April 14, 2022 12:58
Comment thread 23.md
`WALLET` `MAY` inform the user if the `webhookAllowed` response in the first
wallet does not exist.

`WALLET` `MUST` disallow payments if `webhookAllowed` is set to `false`.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

what should the wallet do if the webhook param was in the lnurl request but the first callback didn't contain the webhookAllowed param

@hsjoberg hsjoberg Sep 20, 2022

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@benthecarman Hmm yeah that would mean that the third party server is trying to use a feature that is not supported by the LNURL-pay service.
I think failing makes the most sense in that situation.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That should probably be specified

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Indeed, I'll address this.

@hsjoberg
hsjoberg marked this pull request as draft September 20, 2022 18:22

@andycreed0x andycreed0x left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I support this

Comment thread 23.md
`lnurl1dp68gurn8ghj7er0d4skjm3wvdhk6tmsv9un7am9vf5x7mmt846xs6tjv3cxzun50yhxxmmd9amk2cngdahkkxmx8qr`

Translated Lightning Address:
`lnurlp://domain.com/.well-known/lnurlp/user?webhook=thirdparty.com/webhook`

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
`lnurlp://domain.com/.well-known/lnurlp/user?webhook=thirdparty.com/webhook`
`lnurlp://domain.com/.well-known/lnurlp/<username>?webhook=thirdparty.com/webhook`

@andrerfneves andrerfneves added contested Competing proposals for the same LUD number — needs arbitration new-lud Brand new protocol extension proposal ready Author considers it final, needs review/merge decision labels May 25, 2026
@andrerfneves andrerfneves changed the title LUD-23 Webhook notification for a third-party in pay protocol LUD-XX Webhook notification for a third-party in pay protocol May 30, 2026
@andrerfneves andrerfneves removed the contested Competing proposals for the same LUD number — needs arbitration label May 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

new-lud Brand new protocol extension proposal ready Author considers it final, needs review/merge decision

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants