<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "ApplePayontheWeb",
  "identifier" : "/documentation/ApplePayontheWeb/PaymentMethodChangeEvent",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Apple Pay on the Web"
    ],
    "preciseIdentifier" : "cl/PaymentMethodChangeEvent"
  },
  "title" : "PaymentMethodChangeEvent"
}
-->

# PaymentMethodChangeEvent

The Apple Pay extensions to the Payment Request payment change event.

```
interface PaymentMethodChangeEvent
```

## Overview

The Payment Request API sends a [`PaymentMethodChangeEvent`](/documentation/ApplePayontheWeb/PaymentMethodChangeEvent) when the user updates transaction information. For more information on [`PaymentMethodChangeEvent`](/documentation/ApplePayontheWeb/PaymentMethodChangeEvent), see the [W3C Payment Request API](https://www.w3.org/TR/payment-request/#paymentmethodchangeevent-interface).

### Apple Pay Events

Custom Apple Pay events include information in the [`methodDetails`](/documentation/ApplePayontheWeb/PaymentMethodChangeEvent/methodDetails) attribute of the change event:

- [`ApplePayCouponCodeDetails`](/documentation/ApplePayontheWeb/ApplePayCouponCodeDetails): A dictionary type that indicates the user updated the coupon code.
- [`ApplePayPaymentMethod`](/documentation/ApplePayontheWeb/ApplePayPaymentMethod): A dictionary type that indicates that the user changed the payment method.

## Topics

### Change Information

[`readonly attribute DOMString methodName;`](/documentation/ApplePayontheWeb/PaymentMethodChangeEvent/methodName)

The identifier for the payment method to use for the transaction.

[`readonly attribute object methodDetails;`](/documentation/ApplePayontheWeb/PaymentMethodChangeEvent/methodDetails)

A dictionary that contains the details of the change.

## See Also

[`dictionary ApplePayPaymentMethod {
	DOMString displayName;
	DOMString network;
	ApplePayPaymentMethodType type;
	ApplePayPaymentPass paymentPass;
	ApplePayPaymentContact billingContact;
};`](/documentation/ApplePayontheWeb/ApplePayPaymentMethod)

A dictionary that describes an Apple Pay payment method.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)