PaymentRequest: securePaymentConfirmationAvailability() static method

Secure contextLimited availability

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

Browser compatibility

See also

• Using Secure Payment Confirmation