search

w3c / payment-handler

Payment Handler API
https://w3c.github.io/payment-handler/
Other
74 stars 42 forks source link

API naming and confusion #417

Open rsolomakhin opened 2 months ago

rsolomakhin commented 2 months ago

Hi everyone,

As the PaymentRequest ecosystem has grown, there has been some confusion about what constitutes a "Payment Handler".

Some people take "Payment Handler" to mean any payment app that can handle a PaymentRequest, be it based on service worker (https://w3c.github.io/payment-handler/), Android intents (https://web.dev/articles/android-payment-apps-developers-guide), built into an OS or a user agent.

Other people take "Payment Handler" to mean specifically the "Payment Handler API" as defined in https://w3c.github.io/payment-handler/.

To resolve this confusion, we propose:

  1. Rename https://w3c.github.io/payment-handler/ to "Web Payment Handler API".
  2. "Payment Handler" is any payment app that works with the PaymentRequest API.

Please provide your feedback in responses to this issue in the following format:

  1. Yes/No - <Rename https://w3c.github.io/payment-handler/ to "Web Payment Handler API"?>
  2. Yes/No - <Should "Payment Handler" mean any payment app that works with the PaymentRequest API?>
stephenmcgruer commented 2 months ago

"Payment Handler" is any payment app that works with the PaymentRequest API.

Note: within the Payment Request spec, this is already how a Payment Handler is defined!

https://w3c.github.io/payment-request/#dfn-payment-handler

image

"The details of how to fulfill a payment request for a given payment method is an implementation detail of a payment handler, which is an application or service that handles requests for payment."

stephenmcgruer commented 2 months ago

And for posterity:

  1. Yes - <Rename https://w3c.github.io/payment-handler/ to "Web Payment Handler API"?>
  2. Yes - <Should "Payment Handler" mean any payment app that works with the PaymentRequest API?>
ianbjacobs commented 2 months ago
  1. Yes - <Rename https://w3c.github.io/payment-handler/ to "Web Payment Handler API"?>
  2. Yes - <Should "Payment Handler" mean any payment app that works with the PaymentRequest API?>
rsolomakhin commented 2 months ago

@marcoscaceres - can we get your take?