---
title: "Changes to Update a payment method"
method: PATCH
path: "/merchants/{merchantId}/paymentMethodSettings/{paymentMethodId}"
---

# Changes to Update a payment method

`PATCH /merchants/{merchantId}/paymentMethodSettings/{paymentMethodId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 18 of 50 revisions.

- **2026-09-23** (v3) `55cb8143ce0e`: 1 warning, 6 info
- **2026-07-13** (v3) `f634b6afa653`: 26 breaking, 2 info
- **2026-05-01** (v3) `e6341bd2895a`: 26 breaking, 9 warning, 20 info
- **2025-12-10** (v3) `509d18bb9de7`: 1 info
- **2025-12-04** (v3) `58cb644baa7b`: 1 warning, 2 info
- **2025-11-05** (v3) `10a962d5411c`: 3 info
- **2025-08-11** (v3) `74e1736d3eb3`: 14 warning, 2 info
- **2025-07-02** (v3) `0b0dd6c4f20e`: 3 info
- **2025-05-14** (v3) `2198be4c7fb1`: 2 warning, 3 info
- **2025-02-26** (v3) `303286ccccbd`: 4 info
- **2024-12-12** (v3) `dcf6d8388d63`: 2 info
- **2024-11-25** (v3) `d9a037efa6cf`: 1 breaking, 3 info
- **2024-10-03** (v3) `3202711dd51f`: 3 info
- **2024-09-04** (v3) `d45e6af93de5`: 10 info
- **2024-07-31** (v3) `6d729576877c`: 1 info
- **2024-06-05** (v3) `b4976e7eda02`: 2 warning
- **2024-05-29** (v3) `4422f3fae1d1`: 2 info
- **2024-04-17** (v3) `56148efc8798`: 1 info

## Changes

- **2026-09-23** (v3) `55cb8143ce0e`: 1 warning, 6 info
  - removed the optional property `valuelink/submitterId` from the response with the `200` status
  - added the new optional request property `ebt`
  - added the optional property `ancv` to the response with the `200` status
  - added the optional property `ebt` to the response with the `200` status
  - added the optional property `merchantCategoryCode` to the response with the `200` status
  - added the optional property `mid` to the response with the `200` status
  - added the optional property `valuelink/alternateMerchantNumber` to the response with the `200` status
- **2026-07-13** (v3) `f634b6afa653`: 26 breaking, 2 info
  - the response property `accel/processingType` became optional for the status `200`
  - the response property `applePay/domains` became optional for the status `200`
  - the response property `nyce/processingType` became optional for the status `200`
  - the response property `payme/displayName` became optional for the status `200`
  - the response property `payme/logo` became optional for the status `200`
  - the response property `payme/supportEmail` became optional for the status `200`
  - the response property `paypal/payerId` became optional for the status `200`
  - the response property `paypal/subject` became optional for the status `200`
  - the response property `payto/merchantName` became optional for the status `200`
  - the response property `payto/payToPurpose` became optional for the status `200`
  - the response property `pulse/processingType` became optional for the status `200`
  - the response property `sodexo/merchantContactPhone` became optional for the status `200`
  - the response property `sofort/currencyCode` became optional for the status `200`
  - the response property `sofort/logo` became optional for the status `200`
  - the response property `star/processingType` became optional for the status `200`
  - the response property `svs/authorisationMid` became optional for the status `200`
  - the response property `svs/currencyCode` became optional for the status `200`
  - the response property `swish/swishNumber` became optional for the status `200`
  - the response property `twint/logo` became optional for the status `200`
  - the response property `valuelink/authorisationMid` became optional for the status `200`
  - the response property `valuelink/pinSupport` became optional for the status `200`
  - the response property `vipps/logo` became optional for the status `200`
  - the response property `wechatpay/contactPersonName` became optional for the status `200`
  - the response property `wechatpay/email` became optional for the status `200`
  - the response property `wechatpay_pos/contactPersonName` became optional for the status `200`
  - the response property `wechatpay_pos/email` became optional for the status `200`
  - added the new optional request property `cashapp`
  - added the optional property `associatedPaymentMethods` to the response with the `200` status
- **2026-05-01** (v3) `e6341bd2895a`: 26 breaking, 9 warning, 20 info
  - the response property `afterpayTouch/supportUrl` became optional for the status `200`
  - the response property `amex/serviceLevel` became optional for the status `200`
  - the response property `cartesBancaires/siret` became optional for the status `200`
  - the response property `clearpay/supportUrl` became optional for the status `200`
  - the response property `diners/reuseMidNumber` became optional for the status `200`
  - the response property `givex/currencyCode` became optional for the status `200`
  - the response property `givex/password` became optional for the status `200`
  - the response property `givex/paymentFlow` became optional for the status `200`
  - the response property `givex/username` became optional for the status `200`
  - the response property `googlePay/merchantId` became optional for the status `200`
  - the response property `klarna/disputeEmail` became optional for the status `200`
  - the response property `klarna/region` became optional for the status `200`
  - the response property `klarna/supportEmail` became optional for the status `200`
  - the response property `mealVoucher_FR/conecsId` became optional for the status `200`
  - the response property `mealVoucher_FR/siret` became optional for the status `200`
  - the response property `mealVoucher_FR/subTypes` became optional for the status `200`
  - the `amex/midNumber` response property's maxLength was unset from `10` for the response status `200`
  - the `diners/midNumber` response property's maxLength was unset from `14` for the response status `200`
  - the `googlePay/merchantId` response property's maxLength was unset from `20` for the response status `200`
  - the `jcb/midNumber` response property's maxLength was unset from `14` for the response status `200`
  - the `klarna/region` response property's maxLength was unset from `2` for the response status `200`
  - the `mealVoucher_FR/siret` response property's maxLength was unset from `14` for the response status `200`
  - the `googlePay/merchantId` response property's minLength was decreased from `16` to `0` for the response status `200`
  - the `klarna/region` response property's minLength was decreased from `2` to `0` for the response status `200`
  - the `mealVoucher_FR/siret` response property's minLength was decreased from `14` to `0` for the response status `200`
  - removed the required property `affirm/supportEmail` from the response with the `200` status
  - removed the request property `accel/processingType`
  - removed the request property `bcmc/enableBcmcMobile`
  - removed the request property `cartesBancaires/siret`
  - removed the request property `nyce/processingType`
  - removed the request property `paybybank_plaid/logo`
  - removed the request property `pulse/processingType`
  - removed the request property `sepadirectdebit/creditorId`
  - removed the request property `star/processingType`
  - removed the optional property `affirm/pricePlan` from the response with the `200` status
  - added the new optional request property `affirm`
  - added the new optional request property `bcmc/transactionDescription`
  - added the new optional request property `carnet`
  - added the optional property `affirm/publicApiKey` to the response with the `200` status
  - added the optional property `bcmc/transactionDescription` to the response with the `200` status
  - …15 more
- **2025-12-10** (v3) `509d18bb9de7`: 1 info
  - response property `sofort` deprecated
- **2025-12-04** (v3) `58cb644baa7b`: 1 warning, 2 info
  - removed the optional property `valueLink` from the response with the `200` status
  - added the optional property `givex` to the response with the `200` status
  - added the optional property `valuelink` to the response with the `200` status
- **2025-11-05** (v3) `10a962d5411c`: 3 info
  - added the optional property `affirm/pricePlan` to the response with the `200` status
  - added the optional property `svs` to the response with the `200` status
  - added the optional property `valueLink` to the response with the `200` status
- **2025-08-11** (v3) `74e1736d3eb3`: 14 warning, 2 info
  - removed the request property `paybybank_plaid/countryCode`
  - removed the request property `paybybank_plaid/merchantCity`
  - removed the request property `paybybank_plaid/merchantLegalName`
  - removed the request property `paybybank_plaid/merchantShopUrl`
  - removed the request property `paybybank_plaid/merchantStateProvince`
  - removed the request property `paybybank_plaid/merchantStreetAddress`
  - removed the request property `paybybank_plaid/zipCode`
  - removed the optional property `paybybank_plaid/countryCode` from the response with the `200` status
  - removed the optional property `paybybank_plaid/merchantCity` from the response with the `200` status
  - removed the optional property `paybybank_plaid/merchantLegalName` from the response with the `200` status
  - removed the optional property `paybybank_plaid/merchantShopUrl` from the response with the `200` status
  - removed the optional property `paybybank_plaid/merchantStateProvince` from the response with the `200` status
  - removed the optional property `paybybank_plaid/merchantStreetAddress` from the response with the `200` status
  - removed the optional property `paybybank_plaid/zipCode` from the response with the `200` status
  - added the new optional request property `sepadirectdebit`
  - added the optional property `sepadirectdebit` to the response with the `200` status
- **2025-07-02** (v3) `0b0dd6c4f20e`: 3 info
  - added the new optional request property `maestro_usa`
  - added the optional property `alipayPlus` to the response with the `200` status
  - added the optional property `maestro_usa` to the response with the `200` status
- **2025-05-14** (v3) `2198be4c7fb1`: 2 warning, 3 info
  - removed the optional property `giroPay` from the response with the `200` status
  - added the new `paymentDesignatorContract` enum value to the `jcb/serviceLevel` response property for the response status `200`
  - added the new optional request property `paybybank_plaid`
  - added the optional property `afterpayTouch/supportEmail` to the response with the `200` status
  - added the optional property `paybybank_plaid` to the response with the `200` status
- **2025-02-26** (v3) `303286ccccbd`: 4 info
  - added the new optional request property `eft_directdebit_CA`
  - added the optional property `affirm` to the response with the `200` status
  - added the optional property `eft_directdebit_CA` to the response with the `200` status
  - added the optional property `payto` to the response with the `200` status
- **2024-12-12** (v3) `dcf6d8388d63`: 2 info
  - added the new optional request property `storeId`
  - request property `storeIds` deprecated
- **2024-11-25** (v3) `d9a037efa6cf`: 1 breaking, 3 info
  - the response property `jcb/serviceLevel` became optional for the status `200`
  - added the optional property `diners/midNumber` to the response with the `200` status
  - added the optional property `diners/serviceLevel` to the response with the `200` status
  - added the required property `diners/reuseMidNumber` to the response with the `200` status
- **2024-10-03** (v3) `3202711dd51f`: 3 info
  - added the optional property `jcb/midNumber` to the response with the `200` status
  - added the optional property `jcb/reuseMidNumber` to the response with the `200` status
  - added the required property `jcb/serviceLevel` to the response with the `200` status
- **2024-09-04** (v3) `d45e6af93de5`: 10 info
  - added the new optional request property `accel`
  - added the new optional request property `nyce`
  - added the new optional request property `pulse`
  - added the new optional request property `star`
  - added the optional property `accel` to the response with the `200` status
  - added the optional property `nyce` to the response with the `200` status
  - added the optional property `payme` to the response with the `200` status
  - added the optional property `pulse` to the response with the `200` status
  - added the optional property `sodexo` to the response with the `200` status
  - added the optional property `star` to the response with the `200` status
- **2024-07-31** (v3) `6d729576877c`: 1 info
  - added the optional property `ticket` to the response with the `200` status
- **2024-06-05** (v3) `b4976e7eda02`: 2 warning
  - removed the request property `bcmc/transactionDescription`
  - removed the optional property `bcmc/transactionDescription` from the response with the `200` status
- **2024-05-29** (v3) `4422f3fae1d1`: 2 info
  - added the optional property `wechatpay` to the response with the `200` status
  - added the optional property `wechatpay_pos` to the response with the `200` status
- **2024-04-17** (v3) `56148efc8798`: 1 info
  - added the optional property `amex` to the response with the `200` status

---

[Operation](https://skmtc.dev/adyen/apis/management-api/docs/merchants/:merchantId/paymentMethodSettings/:paymentMethodId/patch.md) - [API](https://skmtc.dev/adyen/apis/management-api.md) - [Page](https://skmtc.dev/adyen/apis/management-api/changes/merchants/:merchantId/paymentMethodSettings/:paymentMethodId/patch)
