Draft This page is not complete.
The email
property is included in a PayerErrors
object if the PaymentResponse.payerEmail
property failed validation; in this case, the property should contain a string describing how to correct the problem. If the payer's email address passed validation, this property is not included in the PayerErrors
object.
Syntax
payerEmail = payerErrors.email;
Value
If validation of the payer's email address (PaymentResponse.payerEmail
) found problems, this property should be set to a DOMString
that explains the validation problem and how to correct it. If the email address is valid, this property should be omitted from 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.email' 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.email by Mozilla Contributors is licensed under CC-BY-SA 2.5.