Secure context
This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The MerchantValidationEvent
interface of the the Payment Request API enables a merchant to verify themselves as allowed to use a particular payment handler.
To learn more about merchant validation, see Merchant validation in Payment processing concepts.
Constructor
MerchantValidationEvent()
Secure context- Creates a new
MerchantValidationEvent
object describing amerchantvalidation
event that will be sent to the payment handler to request that it validate the merchant.
Properties
MerchantValidationEvent.methodName
Secure context- A
DOMString
providing a unique payment method identifier for the payment handler that's requiring validation. This may be either one of the standard payment method identifier strings or a URL that both identifies and handles requests for the payment handler, such ashttps://apple.com/apple-pay
. MerchantValidationEvent.validationURL
Secure context- A
USVString
specifying a URL from which the site or app can fetch payment handler specific validation information. Once this data is retrieved, the data (or a promise resolving to the validation data) should be passed intocomplete()
to validate that the payment request is coming from an authorized merchant.
Methods
MerchantValidationEvent.complete()
Secure context- Pass the data retrieved from the URL specified by
validationURL
intocomplete()
to complete the validation process for thePaymentRequest
.
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 | 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 |
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 |
complete() | Chrome No support No | Edge No support No | Firefox
Full support
64
| IE No support No | Opera No support No | Safari No support No | 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 |
methodName | 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 |
validationURL | 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.
- User must explicitly enable this feature.
- User must explicitly enable this feature.