Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

List other URL-based payment method identifiers #38581

Open
jyasskin opened this issue Mar 11, 2025 · 4 comments
Open

List other URL-based payment method identifiers #38581

jyasskin opened this issue Mar 11, 2025 · 4 comments
Labels
Content:WebAPI Web API docs help wanted If you know something about this topic, we would love your help!

Comments

@jyasskin
Copy link
Contributor

MDN URL

https://developer.mozilla.org/en-US/docs/Web/API/Payment_Request_API/Concepts

What specific section or headline is this issue about?

URL-based payment method identifiers

What information was incorrect, unhelpful, or incomplete?

This section only lists https://apple.com/apple-pay and https://google.com/pay as options.

What did you expect to see?

I'm told that at least a couple other URLs work. It would be good to find and list them, or explain how developers can discover them.

cc/ @stephenmcgruer who might have some more breadcrumbs toward the right thing to write here.

Do you have any supporting links, references, or citations?

No response

Do you have anything more you want to share?

No response

MDN metadata

Page report details
@jyasskin jyasskin added the needs triage Triage needed by staff and/or partners. Automatically applied when an issue is opened. label Mar 11, 2025
@github-actions github-actions bot added the Content:WebAPI Web API docs label Mar 11, 2025
@stephenmcgruer
Copy link

stephenmcgruer commented Mar 11, 2025

Some I was able to find (can't track down a public source for PayTm, which is another payment app we are aware of using Payment Request):

There's also the use in the Digital Goods API, which is a little different:


That said, I'm not sure that MDN should be listing these, since they're generally provided by the payment app to an integrating merchant, and may change! Not to mention that payment apps generally require a lot more than just a URL (e.g., they'll need you to pass them a merchant token and other transaction information in the data member), so it doesn't seem that useful to document here?

Also, I don't love "This is currently supported only by Chrome and Chromium-based browsers" being documented for https://google.com/pay , as it makes it sound like Google / Google Pay is doing that restriction. Could we extend it to "This is currently supported only by Chrome and Chromium-based browsers, because Payment Request on Safari only accepts Apple Pay" ?

@jyasskin
Copy link
Contributor Author

jyasskin commented Mar 12, 2025

My thought was more that MDN should give potential users of the API enough breadcrumbs that they can find how to use it with a variety of handlers, even if doing so requires a contract with a handler instead of just passing in that handler's string.

MDN should also probably point to the ways to be a handler via a native app (e.g. https://web.dev/articles/android-payment-apps-developers-guide), but that would be in a different article.

Re Stephen's last paragraph, maybe "Only Chromium-based browsers support handlers that aren't built into the browser"?

@stephenmcgruer
Copy link

My thought was more that MDN should give potential users of the API enough breadcrumbs that they can find how to use it with a variety of handlers, even if doing so requires a contract with a handler instead of just passing in that handler's string.

Ack, that's fair. No strong opposition from me :).

@Josh-Cena Josh-Cena added help wanted If you know something about this topic, we would love your help! and removed needs triage Triage needed by staff and/or partners. Automatically applied when an issue is opened. labels Mar 13, 2025
@Josh-Cena
Copy link
Member

Welcoming PRs to revise any outdated information and link more resources on other payment methods, but I don't think we want to document their specificities or even to give a list ourselves.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Content:WebAPI Web API docs help wanted If you know something about this topic, we would love your help!
Projects
None yet
Development

No branches or pull requests

3 participants