Secure context
This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The MerchantValidationEvent()
constructor creates a new MerchantValidationEvent
object. You should not have to create these events yourself; instead, just handle the merchantvalidation
event.
Syntax
merchantValidationEvent = new MerchantValidationEvent(type, options);
Parameters
type
- A
DOMString
which must bemerchantvalidation
, the only type of event which uses theMerchantValidationEvent
interface. options
Optional-
An optional dictionary which may contain zero or more of the following properties:
methodName
Optional- A
DOMString
containing the payment method identifier for the payment handler being used. This is an empty string by default. validationURL
Optional- The URL from which to retrieve payment handler specific verification information used to validate the merchant. This is an empty string by default.
Return value
A newly-created MerchantValidationEvent
providing the information that needs to be delivered to the client-side code to present to the user agent by calling complete()
.
Exceptions
TypeError
- The string specified as
validationURL
could not be parsed as a URL. RangeError
- The specified
methodName
does not correspond to a known and supported merchant or is not a well-formed standard payment method identifier.
Specifications
Specification | Status | Comment |
---|---|---|
Payment Request API The definition of 'MerchantValidationEvent()' 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 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
MerchantValidationEvent() constructor | Chrome No support No | Edge No support No | Firefox
Full support
64
| IE No support No | Opera No support No | Safari ? | WebView Android No support No | Chrome Android No support No | 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
- See implementation notes.
- See implementation notes.