Payment Request API
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Secure context: This feature is available only insecure contexts (HTTPS), in some or allsupporting browsers.
ThePayment Request API provides a consistent user experience for merchants and users. It is not a new way of paying for things; instead, it's a way for users to select their preferred way of paying for things and make that information available to a merchant.
In this article
Concepts and usage
Many problems related to online shopping cart abandonment can be traced to checkout forms, which can be difficult and time-consuming to fill out and often require multiple steps to complete. ThePayment Request API is meant to reduce the steps needed to complete payment online, potentially doing away with checkout forms. It aims to make the checkout process more accessible by having payment apps store a user's details, which are passed along to a merchant, hopefully without requiring an HTML form.
To request a payment, a web page creates aPaymentRequest object in response to a user action that initiates a payment, such as clicking a "Purchase" button. ThePaymentRequest allows the web page to exchange information with the user agent while the user provides input to complete the transaction.
You can find a complete guide inUsing the Payment Request API.
Note:The API is available inside cross-origin<iframe> elements only if they have had theallowpaymentrequest attribute set on them.
Interfaces
PaymentAddressDeprecatedNon-standardAn object that contains address information; used for billing and shipping addresses, for example.
PaymentRequestAn object that provides the API for creating and managing theuser agent's payment interface.
PaymentRequestUpdateEventEnables the web page to update the details of the payment request in response to a user action.
PaymentMethodChangeEventRepresents the user changing payment instrument (e.g., switching from one payment method to another).
PaymentResponseAn object returned after the user selects a payment method and approves a payment request.
MerchantValidationEventDeprecatedRepresents the browser requiring the merchant (website) to validate themselves as allowed to use a particular payment handler (e.g., registered as allowed to use Apple Pay).
Specifications
| Specification |
|---|
| Payment Request API> # paymentrequest-interface> |