Draft This page is not complete.
The name
property is included in a PayerErrors
object if the payerName
returned in the response couldn't be validated. The value is a string explaining the problem. If the payer's name validated successfully, the name
property is omitted from the PayerErrors
object.
Syntax
payerName = payerErrors.name;
Value
If this property is present in the PayerErrors
object, the payer's name couldn't be successfully validated, and the name
property's value is a DOMString
explaining the error. This string will be displayed to the user by the user agent's payment handling user interface.
If the payer's name is valid, this property is left out of the PayerErrors
object.
Example
function validatePayment(response) {
const correctionPromises
let paymentErrors = {};
let payerErrors = {};
// Check payer details
if (!validEmail(response.payerEmail)) {
payerErrors.email = "Please make sure you enter a valid email address."
}
if (!validName(response.payerName)) {
payerErrors.email = "Please enter a valid name, using only <appropriate characters>."
}
if (!validPhone(response.payerPhone)) {
payerErrors.phone = "Please enter a valid phone number in the form ###-###-####."
}
// Check everything else too...
//
}
Specifications
Specification | Status | Comment |
Payment Request APIThe definition of 'PayerErrors.name' 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 Full support 71 Full support 71 Disabled' From version 71: this feature is behind the Alternate Name' Uses the non-standard name: |
Edge Full support ≤79 Full support ≤79 Disabled' From version ≤79: this feature is behind the |
Firefox Full support 64 Full support 64 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' From version 56: this feature is behind the |
IE
No support No |
Opera
No support No |
Safari
? |
WebView Android
No support No |
Chrome Android Full support 71 Full support 71 Disabled' From version 71: this feature is behind the Alternate Name' Uses the non-standard name: |
Firefox Android Full support 64 Full support 64 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' From version 56: this feature is behind the |
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.name by Mozilla Contributors is licensed under CC-BY-SA 2.5.