Web/API/PayerErrors

The PayerErrors dictionary is used by the Payment Request API to indicate the presence of—and to explain how to correct—validation errors in the payer details. For each field in the payment information that fails validation, the PayerErrors object contains a string explaining the error.

The payer details include the payer's name, phone number, and email address.

Properties

email Optional

If present, this DOMString is a string describing the validation error from which the payer's email address—as given by PaymentResponse.payerEmail—currently suffers. If this property is absent from the PayerErrors object, the email address passed validation.

name Optional

If this DOMString is present in the object, the PaymentResponse.payerName property failed validation, and this string explains what needs to be corrected. If this property is absent, the paer name is fine

phone Optional

If present, this string is an error message explaining why the payer's phone number (PaymentResponse.payerPhone) failed validation. This property is absent if the phone number passed validation.

Specifications

Specification	Status	Comment
Payment Request APIThe definition of 'PayerErrors' in that specification.	Candidate Recommendation	Initial definition.

Browser compatibility

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
PayerErrors	Chrome Full support 71 Disabled' Full support 71 Disabled' Disabled' From version 71: this feature is behind the #web-payments preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags. No support 69 — 71 Alternate Name' Disabled' Alternate Name' Uses the non-standard name: PayerErrorFields Disabled' From version 69 until version 71 (exclusive): this feature is behind the #web-payments preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.	Edge Full support ≤79 Disabled' Full support ≤79 Disabled' Disabled' From version ≤79: this feature is behind the #web-payments preference (needs to be set to Enabled).	Firefox Full support 64 Notes' Full support 64 Notes' Notes' Enabled by default in nightly US English builds of Firefox 64 and later, and on other localizations when geolocation indicates the user is in the United States or Canada. Full support 56 Disabled' Disabled' From version 56: this feature is behind the dom.payments.request.enabled preference (needs to be set to true) and the dom.payments.request.supportedRegions preference (needs to be set to comma-delineated 2-character country code list). To change preferences in Firefox, visit about:config.	IE No support No	Opera No support No	Safari ?	WebView Android No support No	Chrome Android Full support 71 Disabled' Full support 71 Disabled' Disabled' From version 71: this feature is behind the #web-payments preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags. No support 69 — 71 Alternate Name' Disabled' Alternate Name' Uses the non-standard name: PayerErrorFields Disabled' From version 69 until version 71 (exclusive): this feature is behind the #web-payments preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.	Firefox Android Full support 64 Notes' Full support 64 Notes' Notes' Enabled by default in nightly US English builds of Firefox 64 and later, and on other localizations when geolocation indicates the user is in the United States or Canada. Full support 56 Disabled' Disabled' From version 56: this feature is behind the dom.payments.request.enabled preference (needs to be set to true) and the dom.payments.request.supportedRegions preference (needs to be set to comma-delineated 2-character country code list). To change preferences in Firefox, visit about:config.	Opera Android No support No	Safari iOS ?	Samsung Internet Android No support No
email Experimental'	Chrome Full support 71 Disabled' Full support 71 Disabled' Disabled' From version 71: this feature is behind the #web-payments preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags. No support 69 — 71 Alternate Name' Disabled' Alternate Name' Uses the non-standard name: payerEmailError Disabled' From version 69 until version 71 (exclusive): this feature is behind the #web-payments preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.	Edge Full support ≤79 Disabled' Full support ≤79 Disabled' Disabled' From version ≤79: this feature is behind the #web-payments preference (needs to be set to Enabled).	Firefox Full support 64 Notes' Full support 64 Notes' Notes' Enabled by default in nightly US English builds of Firefox 64 and later, and on other localizations when geolocation indicates the user is in the United States or Canada. Full support 56 Disabled' Disabled' From version 56: this feature is behind the dom.payments.request.enabled preference (needs to be set to true) and the dom.payments.request.supportedRegions preference (needs to be set to comma-delineated 2-character country code list). To change preferences in Firefox, visit about:config.	IE No support No	Opera No support No	Safari ?	WebView Android No support No	Chrome Android Full support 71 Disabled' Full support 71 Disabled' Disabled' From version 71: this feature is behind the #web-payments preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags. No support 69 — 71 Alternate Name' Disabled' Alternate Name' Uses the non-standard name: payerEmailError Disabled' From version 69 until version 71 (exclusive): this feature is behind the #web-payments preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.	Firefox Android Full support 64 Notes' Full support 64 Notes' Notes' Enabled by default in nightly US English builds of Firefox 64 and later, and on other localizations when geolocation indicates the user is in the United States or Canada. Full support 56 Disabled' Disabled' From version 56: this feature is behind the dom.payments.request.enabled preference (needs to be set to true) and the dom.payments.request.supportedRegions preference (needs to be set to comma-delineated 2-character country code list). To change preferences in Firefox, visit about:config.	Opera Android No support No	Safari iOS ?	Samsung Internet Android No support No
name Experimental'	Chrome Full support 71 Disabled' Full support 71 Disabled' Disabled' From version 71: this feature is behind the #web-payments preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags. No support 69 — 71 Alternate Name' Disabled' Alternate Name' Uses the non-standard name: payerNameError Disabled' From version 69 until version 71 (exclusive): this feature is behind the #web-payments preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.	Edge Full support ≤79 Disabled' Full support ≤79 Disabled' Disabled' From version ≤79: this feature is behind the #web-payments preference (needs to be set to Enabled).	Firefox Full support 64 Notes' Full support 64 Notes' Notes' Enabled by default in nightly US English builds of Firefox 64 and later, and on other localizations when geolocation indicates the user is in the United States or Canada. Full support 56 Disabled' Disabled' From version 56: this feature is behind the dom.payments.request.enabled preference (needs to be set to true) and the dom.payments.request.supportedRegions preference (needs to be set to comma-delineated 2-character country code list). To change preferences in Firefox, visit about:config.	IE No support No	Opera No support No	Safari ?	WebView Android No support No	Chrome Android Full support 71 Disabled' Full support 71 Disabled' Disabled' From version 71: this feature is behind the #web-payments preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags. No support 69 — 71 Alternate Name' Disabled' Alternate Name' Uses the non-standard name: payerNameError Disabled' From version 69 until version 71 (exclusive): this feature is behind the #web-payments preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.	Firefox Android Full support 64 Notes' Full support 64 Notes' Notes' Enabled by default in nightly US English builds of Firefox 64 and later, and on other localizations when geolocation indicates the user is in the United States or Canada. Full support 56 Disabled' Disabled' From version 56: this feature is behind the dom.payments.request.enabled preference (needs to be set to true) and the dom.payments.request.supportedRegions preference (needs to be set to comma-delineated 2-character country code list). To change preferences in Firefox, visit about:config.	Opera Android No support No	Safari iOS ?	Samsung Internet Android No support No
phone Experimental'	Chrome Full support 71 Disabled' Full support 71 Disabled' Disabled' From version 71: this feature is behind the #web-payments preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags. No support 69 — 71 Alternate Name' Disabled' Alternate Name' Uses the non-standard name: payerPhoneError Disabled' From version 69 until version 71 (exclusive): this feature is behind the #web-payments preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.	Edge Full support ≤79 Disabled' Full support ≤79 Disabled' Disabled' From version ≤79: this feature is behind the #web-payments preference (needs to be set to Enabled).	Firefox Full support 64 Notes' Full support 64 Notes' Notes' Enabled by default in nightly US English builds of Firefox 64 and later, and on other localizations when geolocation indicates the user is in the United States or Canada. Full support 56 Disabled' Disabled' From version 56: this feature is behind the dom.payments.request.enabled preference (needs to be set to true) and the dom.payments.request.supportedRegions preference (needs to be set to comma-delineated 2-character country code list). To change preferences in Firefox, visit about:config.	IE No support No	Opera No support No	Safari ?	WebView Android No support No	Chrome Android Full support 71 Disabled' Full support 71 Disabled' Disabled' From version 71: this feature is behind the #web-payments preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags. No support 69 — 71 Alternate Name' Disabled' Alternate Name' Uses the non-standard name: payerPhoneError Disabled' From version 69 until version 71 (exclusive): this feature is behind the #web-payments preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.	Firefox Android Full support 64 Notes' Full support 64 Notes' Notes' Enabled by default in nightly US English builds of Firefox 64 and later, and on other localizations when geolocation indicates the user is in the United States or Canada. Full support 56 Disabled' Disabled' From version 56: this feature is behind the dom.payments.request.enabled preference (needs to be set to true) and the dom.payments.request.supportedRegions preference (needs to be set to comma-delineated 2-character country code list). To change preferences in Firefox, visit about:config.	Opera Android No support No	Safari iOS ?	Samsung Internet Android No support No

Legend

Full support  

Full support

No support  

No support

Compatibility unknown  

Compatibility unknown

Experimental. Expect behavior to change in the future.'

Experimental. Expect behavior to change in the future.

See implementation notes.'

See implementation notes.

User must explicitly enable this feature.'

User must explicitly enable this feature.

Uses a non-standard name.'

Uses a non-standard name.

PayerErrors by Mozilla Contributors is licensed under CC-BY-SA 2.5.