The country
read-only property of the PaymentAddress
interface is a string identifying the address's country using the ISO 3166-1 alpha-2 standard. The string is always in its canonical upper-case form.
Some examples of valid country
values: "US"
, "GB"
, "CN"
, or "JP"
.
Syntax
var paymentCountry = PaymentAddress.country;
Value
A DOMString
which contains the ISO3166-1 alpha-2 code identifying the country in which the address is located, or an empty string if no country is available, which frequently can be assumed to mean "same country as the site owner."
Usage notes
If the payment handler validates the address and determines that the value of country
is invalid, a call to PaymentRequestUpdateEvent.updateWith()
will be made with a details
object containing a shippingAddressErrors
field. That field contains an AddressErrors
-compliant object whose country
property is a string indicating the validation error that occurred and, if possible, suggests how to fix it.
Specifications
Specification | Status | Comment |
Payment Request APIThe definition of 'PaymentAddress.country' 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 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
country
|
Chrome
Full support 60 |
Edge
Full support 15 |
Firefox No support No No support No Notes' Available only in nightly builds. |
IE
No support No |
Opera
Full support 47 |
Safari
Full support 11.1 |
WebView Android
No support No |
Chrome Android
Full support 56 |
Firefox Android No support No No support No Notes' Available only in nightly builds. |
Opera Android
Full support 44 |
Safari iOS
Full support 11.3 |
Samsung Internet Android
Full support Yes |
Legend
- Full support
- Full support
- No support
- No support
- See implementation notes.'
- See implementation notes.
See also
PaymentAddress.country by Mozilla Contributors is licensed under CC-BY-SA 2.5.