W3cubDocs

/Web APIs

PaymentRequest: securePaymentConfirmationAvailability() static method

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 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

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

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

	Desktop					Mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet	WebView Android	WebView on iOS
`securePaymentConfirmationAvailability_static`	139	139	No	123	No	139	No	91	No	No	No	No