PaymentManager: enableDelegations() method

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

Non-standard: This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.

The enableDelegations() method of the PaymentManager interface delegates responsibility for providing various parts of the required payment information to the payment app rather than collecting it from the browser (for example, via autofill).

For example, if the requestShipping option is set to true in the options object when invoking the PaymentRequest() constructor, a shipping address will be returned.

  • If enableDelegations() was used to delegate shippingAddress, that address will come from the payment app.
  • If not, it will come from the browser autofill.

Syntax

js

enableDelegations(delegations)

Parameters

delegations Optional

An array containing one or more enumerated values that specify the payment information you want to delegate to the payment app. Possible values can be:

payerEmail

The payment app will provide the payer's email whenever it is needed.

payerName

The payment app will provide the payer's name whenever it is needed.

payerPhone

The payment app will provide the payer's phone number whenever it is needed.

shippingAddress

The payment app will provide the shipping address whenever it is needed.

Return value

A Promise that resolves with a value of undefined.

Examples

js

navigator.serviceWorker.register("serviceworker.js").then((registration) => {
  registration.paymentManager.userHint = "Card number should be 16 digits";

  registration.paymentManager
    .enableDelegations(["shippingAddress", "payerName"])
    .then(() => {
      // ...
    });

  // ...
});

Specifications

No specification found

No specification data found for api.PaymentManager.enableDelegations.
Check for problems with this page or contribute a missing spec_url to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.

Browser compatibility

BCD tables only load in the browser

See also