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 API The 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.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
name | Chrome
Full support
71
| Edge
Full support
≤79
| Firefox
Full support
64
| IE No support No | Opera No support No | Safari ? | WebView Android No support No | Chrome Android
Full support
71
| Firefox Android
Full support
64
| 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.