PaymentRequest: securePaymentConfirmationAvailability() static method

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The securePaymentConfirmationAvailability() static method of the PaymentRequest interface indicates whether the Secure payment confirmation (SPC) feature is available.

Syntax

js
securePaymentConfirmationAvailability()

Parameters

None.

Return value

A Promise that resolves with an enumerated value indicating whether SPC is available, and if not, a reason for non-availability.

Possible values are:

available

SPC is available in the calling frame. This doesn't guarantee that an SPC-compatible credential is available to authenticate against.

unavailable-unknown-reason

SPC is not available in the calling frame, for an unknown reason. The browser may return this result instead of a more specific reason, in order to protect user privacy.

unavailable-feature-not-enabled

SPC is not available in the calling frame because it is not enabled.

unavailable-no-permission-policy

SPC is not available in the calling frame, because it is blocked by a payment Permissions Policy.

unavailable-no-user-verifying-platform-authenticator

SPC is not available in the calling frame, because there is no user-verifying platform authenticator available (PublicKeyCredential.isUserVerifyingPlatformAuthenticatorAvailable() can also be used to discern this information).

Examples

js
async function spcSupport() {
  const support = await PaymentRequest.securePaymentConfirmationAvailability();
  if (support === "available") {
    // Commence SPC payment flow
  } else {
    // Fallback to traditional flows
  }
}

Specifications

Specification
Secure Payment Confirmation
# dom-paymentrequest-securepaymentconfirmationavailability

Browser compatibility

See also