--- title: "Changes to Request a payment method" method: POST path: "/merchants/{merchantId}/paymentMethodSettings" --- # Changes to Request a payment method `POST /merchants/{merchantId}/paymentMethodSettings` > Every recorded change to this operation, newest first. ## Timeline Changed in 18 of 50 revisions. - **2026-09-23** (v3) `55cb8143ce0e`: 2 warning, 14 info - **2026-07-13** (v3) `f634b6afa653`: 26 breaking, 3 info - **2026-05-01** (v3) `e6341bd2895a`: 29 breaking, 1 warning, 31 info - **2025-12-10** (v3) `509d18bb9de7`: 3 info - **2025-12-04** (v3) `58cb644baa7b`: 1 breaking, 2 warning, 6 info - **2025-11-05** (v3) `10a962d5411c`: 9 info - **2025-09-23** (v3) `55ae7a4c7a88`: 1 info - **2025-08-11** (v3) `74e1736d3eb3`: 14 warning, 10 info - **2025-07-02** (v3) `0b0dd6c4f20e`: 48 info - **2025-05-14** (v3) `2198be4c7fb1`: 1 breaking, 3 warning, 6 info - **2025-02-26** (v3) `303286ccccbd`: 10 info - **2024-11-25** (v3) `d9a037efa6cf`: 1 breaking, 2 warning, 8 info - **2024-10-03** (v3) `3202711dd51f`: 1 breaking, 5 info - **2024-09-04** (v3) `d45e6af93de5`: 31 info - **2024-07-31** (v3) `6d729576877c`: 5 info - **2024-06-05** (v3) `b4976e7eda02`: 2 warning - **2024-05-29** (v3) `4422f3fae1d1`: 4 info - **2024-04-17** (v3) `56148efc8798`: 3 info ## Changes - **2026-09-23** (v3) `55cb8143ce0e`: 2 warning, 14 info - removed the request property `valuelink/submitterId` - removed the optional property `valuelink/submitterId` from the response with the `200` status - added the new optional request property `alipayPlus/branchName` - added the new optional request property `alipayPlus/merchantMobileAppName` - added the new optional request property `alipayPlus/productServiceDescription` - added the new optional request property `ancv` - added the new optional request property `ebt` - added the new optional request property `valuelink/alternateMerchantNumber` - added the new `ancv` enum value to the request property `type` - added the new `ebt` enum value to the request property `type` - added the new `wero` enum value to the request property `type` - 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, 3 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 `carnet/addMccAcronym` - added the new `cashapp` enum value to the request property `type` - added the optional property `associatedPaymentMethods` to the response with the `200` status - **2026-05-01** (v3) `e6341bd2895a`: 29 breaking, 1 warning, 31 info - removed the enum value `BRONZE` of the request property `affirm/pricePlan` - removed the enum value `GOLD` of the request property `affirm/pricePlan` - removed the enum value `SILVER` of the request property `affirm/pricePlan` - 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 optional property `affirm/pricePlan` from the response with the `200` status - added the new optional request property `carnet` - request property `paybybank_plaid/logo` deprecated - added the new `alipay_plus_alipay_cn` enum value to the request property `type` - added the new `alipay_plus_alipay_hk` enum value to the request property `type` - added the new `alipay_plus_dana` enum value to the request property `type` - added the new `alipay_plus_gcash` enum value to the request property `type` - added the new `alipay_plus_kakaopay` enum value to the request property `type` - added the new `alipay_plus_kplus` enum value to the request property `type` - added the new `alipay_plus_naverpay` enum value to the request property `type` - added the new `alipay_plus_rabbitlinepay` enum value to the request property `type` - …21 more - **2025-12-10** (v3) `509d18bb9de7`: 3 info - request property `sofort` deprecated - added the new `blik_pos` enum value to the request property `type` - response property `sofort` deprecated - **2025-12-04** (v3) `58cb644baa7b`: 1 breaking, 2 warning, 6 info - removed the enum value `valueLink` of the request property `type` - removed the request property `valueLink` - removed the optional property `valueLink` from the response with the `200` status - added the new optional request property `givex` - added the new optional request property `valuelink` - added the new `givex` enum value to the request property `type` - added the new `valuelink` enum value to the request property `type` - 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`: 9 info - added the new optional request property `affirm/pricePlan` - added the new optional request property `svs` - added the new optional request property `valueLink` - added the new `klarna_b2b` enum value to the request property `type` - added the new `svs` enum value to the request property `type` - added the new `valueLink` enum value to the request property `type` - 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-09-23** (v3) `55ae7a4c7a88`: 1 info - added the new `br_schemes` enum value to the request property `type` - **2025-08-11** (v3) `74e1736d3eb3`: 14 warning, 10 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 new `abrapetite` enum value to the request property `type` - added the new `abrapetite_credit` enum value to the request property `type` - added the new `abrapetite_debit` enum value to the request property `type` - added the new `abrapetite_prepaid` enum value to the request property `type` - added the new `romcard` enum value to the request property `type` - added the new `romcard_credit` enum value to the request property `type` - added the new `romcard_debit` enum value to the request property `type` - added the new `sepadirectdebit` enum value to the request property `type` - added the optional property `sepadirectdebit` to the response with the `200` status - **2025-07-02** (v3) `0b0dd6c4f20e`: 48 info - added the new optional request property `alipayPlus` - added the new optional request property `maestro_usa` - added the new `alipay_plus` enum value to the request property `type` - added the new `avancard` enum value to the request property `type` - added the new `avancard_credit` enum value to the request property `type` - added the new `avancard_debit` enum value to the request property `type` - added the new `cooper` enum value to the request property `type` - added the new `cooper_credit` enum value to the request property `type` - added the new `cooper_debit` enum value to the request property `type` - added the new `cooper_food_debit` enum value to the request property `type` - added the new `cooper_meal_debit` enum value to the request property `type` - added the new `cooper_prepaid` enum value to the request property `type` - added the new `cooper_private_credit` enum value to the request property `type` - added the new `cooper_retail_credit` enum value to the request property `type` - added the new `green_card` enum value to the request property `type` - added the new `green_card_credit` enum value to the request property `type` - added the new `green_card_debit` enum value to the request property `type` - added the new `green_card_food_prepaid` enum value to the request property `type` - added the new `green_card_meal_prepaid` enum value to the request property `type` - added the new `green_card_prepaid` enum value to the request property `type` - added the new `le_card` enum value to the request property `type` - added the new `le_card_credit` enum value to the request property `type` - added the new `le_card_debit` enum value to the request property `type` - added the new `maestro_usa` enum value to the request property `type` - added the new `maxifrota` enum value to the request property `type` - added the new `maxifrota_prepaid` enum value to the request property `type` - added the new `megaleve` enum value to the request property `type` - added the new `megaleve_credit` enum value to the request property `type` - added the new `megaleve_debit` enum value to the request property `type` - added the new `nutricash` enum value to the request property `type` - added the new `nutricash_prepaid` enum value to the request property `type` - added the new `personal_card` enum value to the request property `type` - added the new `personal_card_credit` enum value to the request property `type` - added the new `personal_card_debit` enum value to the request property `type` - added the new `senff` enum value to the request property `type` - added the new `senff_credit` enum value to the request property `type` - added the new `up_brazil` enum value to the request property `type` - added the new `up_brazil_debit` enum value to the request property `type` - added the new `up_brazil_prepaid` enum value to the request property `type` - added the new `vegas_card` enum value to the request property `type` - …8 more - **2025-05-14** (v3) `2198be4c7fb1`: 1 breaking, 3 warning, 6 info - removed the enum value `payshop` of the request property `type` - removed the request property `giroPay` - 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 `afterpayTouch/supportEmail` - added the new optional request property `paybybank_plaid` - added the new `paybybank_plaid` enum value to the request property `type` - added the new `paymentDesignatorContract` enum value to the request property `jcb/serviceLevel` - 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`: 10 info - added the new optional request property `affirm` - added the new optional request property `eft_directdebit_CA` - added the new optional request property `payto` - added the new `ach` enum value to the request property `type` - added the new `alipay_wap` enum value to the request property `type` - added the new `eft_directdebit_CA` enum value to the request property `type` - added the new `payto` enum value to the request property `type` - 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-11-25** (v3) `d9a037efa6cf`: 1 breaking, 2 warning, 8 info - the response property `jcb/serviceLevel` became optional for the status `200` - the `amex/midNumber` request property's maxLength was set to `10` - the `jcb/midNumber` request property's maxLength was set to `14` - added the new optional request property `diners/midNumber` - added the new optional request property `diners/serviceLevel` - added the new required request property `diners/reuseMidNumber` with a default value - the request property `jcb/serviceLevel` became optional - added the new `affirm` enum value to the request property `type` - 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`: 1 breaking, 5 info - added the new required request property `jcb/serviceLevel` - added the new optional request property `jcb/midNumber` - added the new optional request property `jcb/reuseMidNumber` - 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`: 31 info - added the new optional request property `accel` - added the new optional request property `nyce` - added the new optional request property `payme` - added the new optional request property `pulse` - added the new optional request property `sodexo` - added the new optional request property `star` - added the new `accel` enum value to the request property `type` - added the new `alelo` enum value to the request property `type` - added the new `banese_card` enum value to the request property `type` - added the new `banese_card_credit` enum value to the request property `type` - added the new `banese_card_debit` enum value to the request property `type` - added the new `banese_card_prepaid` enum value to the request property `type` - added the new `credtodos` enum value to the request property `type` - added the new `credtodos_private_credit` enum value to the request property `type` - added the new `credtodos_private_debit` enum value to the request property `type` - added the new `nyce` enum value to the request property `type` - added the new `payme` enum value to the request property `type` - added the new `payme_pos` enum value to the request property `type` - added the new `pulse` enum value to the request property `type` - added the new `sodexo` enum value to the request property `type` - added the new `star` enum value to the request property `type` - added the new `todo_giftcard` enum value to the request property `type` - added the new `up_brazil_credit` enum value to the request property `type` - added the new `vale_refeicao` enum value to the request property `type` - added the new `vale_refeicao_prepaid` enum value to the request property `type` - 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`: 5 info - added the new optional request property `ticket` - added the new `paynow` enum value to the request property `type` - added the new `paynow_pos` enum value to the request property `type` - added the new `ticket` enum value to the request property `type` - 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`: 4 info - added the new optional request property `wechatpay` - added the new optional request property `wechatpay_pos` - 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`: 3 info - added the new optional request property `amex` - added the new `clicktopay` enum value to the request property `type` - added the optional property `amex` to the response with the `200` status --- [Operation](https://skmtc.dev/adyen/apis/management-api/docs/merchants/:merchantId/paymentMethodSettings/post.md) - [API](https://skmtc.dev/adyen/apis/management-api.md) - [Page](https://skmtc.dev/adyen/apis/management-api/changes/merchants/:merchantId/paymentMethodSettings/post)