Payment Request API

The Payment Request API defines a consistent user experience across payment methods, payment systems, platforms, and merchants. It is not a new payment method; rather, it is a conduit from the user's preferred payment method to a merchant.

Payment Request Concepts and Usage

Many problems related to online purchase abandonment can be traced to checkout forms, which are user-intensive, difficult to use, slow to load and refresh, and require multiple steps to complete. The Payment Request API is a system that is meant to eliminate checkout forms. It vastly improves user workflow during the purchase process, providing a more consistent user experience and enabling web merchants to easily leverage disparate payment methods.

To request a payment, a web page creates a PaymentRequest object in response to a user action that initiates a payment, such as clicking a "Purchase" button. The PaymentRequest allows the web page to exchange information with the user agent while the user provides input to complete the transaction.

Interfaces

PaymentRequest

Manages the process of a user making a payment.

PaymentRequestUpdateEvent

Enables the web page to update the details of the payment request in response to a user action.

PaymentResponse

Returned after a user selects a payment method and approves a payment request.

PaymentAddress

Stores address information.

Related interfaces defined in the Basic card payment spec

BasicCardRequest

Defines an object structure for containing payment request details such as card type.

BasicCardResponse

Defines an object structure for payment response details such as the number/expiry date of the card used to make the payment, and the billing address.

Specifications

Browser Compatibility

[1] Supported but disabled on all versions. Hidden behind the dom.payments.request.enabled pref.