--- title: "Changes to Update payment" method: PATCH path: "/v2/payments/{paymentId}" --- # Changes to Update payment `PATCH /v2/payments/{paymentId}` > Every recorded change to this endpoint, newest first. > 79 revisions in range; 9 not diffed. ## Timeline Changed in 14 of 79 revisions. - **2026-08-27** `8e5a936eb5bd` — 6 warning - **2026-08-07** `86a9cd830b06` — 3 warning - **2026-08-06** `64c0511a62bc` — 28 breaking, 13 warning, 1 info - **2026-08-05** `42479670d8c9` — 1 breaking, 1 info - **2026-07-30** `160fcdd65af7` — 1 warning, 2 info - **2026-07-08** `4d4ab81fb2d5` — 2 warning, 2 info - **2026-07-02** `226f9009e928` — 13 warning - **2026-06-22** `245eb8c59534` — 37 breaking, 39 info - **2026-06-09** `327472893a89` — 1 warning - **2026-05-19** `7cab62b21830` — 1 info - **2026-05-12** `331cb8579126` — 1 info - **2026-05-12** `ef4b5a97b56a` — 2 info - **2026-05-05** `f3d6346a1412` — 2 warning, 2 info - **2026-05-04** `18e0e58eb54d` — 1 info ## Changes - **2026-08-27** `8e5a936eb5bd` — 6 warning - added the new `Cartes Bancaires` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/cardLabel` response property for the response status `200` - added the new `cartes-bancaires-business` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `200` - added the new `cartes-bancaires-consumer` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `200` - added the new `mastercard-debit-consumer-inter` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `200` - added the new `visa-debit-consumer-inter` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `200` - added the new `visa-debit-consumer-intra-eea` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `200` - **2026-08-07** `86a9cd830b06` — 3 warning - added the new `en_BE` enum value to the `allOf[#/components/schemas/entity-payment-response]/locale` response property for the response status `200` - added the new `en_NL` enum value to the `allOf[#/components/schemas/entity-payment-response]/locale` response property for the response status `200` - added the new `visa-credit-consumer-inter` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `200` - **2026-08-06** `64c0511a62bc` — 28 breaking, 13 warning, 1 info - removed the enum value `ca_ES` of the request property `locale` - removed the enum value `cs_CZ` of the request property `locale` - removed the enum value `da_DK` of the request property `locale` - removed the enum value `de_AT` of the request property `locale` - removed the enum value `de_CH` of the request property `locale` - removed the enum value `de_DE` of the request property `locale` - removed the enum value `de_LU` of the request property `locale` - removed the enum value `en_GB` of the request property `locale` - removed the enum value `en_US` of the request property `locale` - removed the enum value `es_ES` of the request property `locale` - removed the enum value `fi_FI` of the request property `locale` - removed the enum value `fr_BE` of the request property `locale` - removed the enum value `fr_FR` of the request property `locale` - removed the enum value `fr_LU` of the request property `locale` - removed the enum value `hu_HU` of the request property `locale` - removed the enum value `is_IS` of the request property `locale` - removed the enum value `it_IT` of the request property `locale` - removed the enum value `lt_LT` of the request property `locale` - removed the enum value `lv_LV` of the request property `locale` - removed the enum value `nb_NO` of the request property `locale` - removed the enum value `nl_BE` of the request property `locale` - removed the enum value `nl_NL` of the request property `locale` - removed the enum value `null` of the request property `locale` - removed the enum value `pl_PL` of the request property `locale` - removed the enum value `pt_PT` of the request property `locale` - removed the enum value `sk_SK` of the request property `locale` - removed the enum value `sv_SE` of the request property `locale` - the `shippingAddress` request property type changed from `object` to no type - removed the request property `shippingAddress/city` - removed the request property `shippingAddress/country` - removed the request property `shippingAddress/email` - removed the request property `shippingAddress/familyName` - removed the request property `shippingAddress/givenName` - removed the request property `shippingAddress/organizationName` - removed the request property `shippingAddress/phone` - removed the request property `shippingAddress/postalCode` - removed the request property `shippingAddress/region` - removed the request property `shippingAddress/streetAdditional` - removed the request property `shippingAddress/streetAndNumber` - removed the request property `shippingAddress/title` - …2 more - **2026-08-05** `42479670d8c9` — 1 breaking, 1 info - the response property `allOf[#/components/schemas/entity-payment-response]/dueDate` became nullable for the status `200` - the request property `dueDate` became nullable - **2026-07-30** `160fcdd65af7` — 1 warning, 2 info - added the new `billink` enum value to the `allOf[subschema #2]/method` response property for the response status `200` - added the new `billink` enum value to the request property `method/oneOf[#/components/schemas/method]/` - added the new `billink` enum value to the request property `method/oneOf[subschema #2]/items/` - **2026-07-08** `4d4ab81fb2d5` — 2 warning, 2 info - added the new `cs_CZ` enum value to the `allOf[#/components/schemas/entity-payment-response]/locale` response property for the response status `200` - added the new `sk_SK` enum value to the `allOf[#/components/schemas/entity-payment-response]/locale` response property for the response status `200` - added the new `cs_CZ` enum value to the request property `locale` - added the new `sk_SK` enum value to the request property `locale` - **2026-07-02** `226f9009e928` — 13 warning - added the new `mastercard-credit-business-domestic` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `200` - added the new `mastercard-credit-consumer-domestic` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `200` - added the new `mastercard-credit-consumer-intra-eea` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `200` - added the new `mastercard-debit-business-domestic` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `200` - added the new `mastercard-debit-business-intra-eea` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `200` - added the new `mastercard-debit-consumer-domestic` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `200` - added the new `mastercard-debit-consumer-intra-eea` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `200` - added the new `visa-credit-business-domestic` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `200` - added the new `visa-credit-consumer-domestic` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `200` - added the new `visa-credit-consumer-intra-eea` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `200` - added the new `visa-debit-business-domestic` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `200` - added the new `visa-debit-business-intra-eea` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `200` - added the new `visa-debit-consumer-domestic` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `200` - **2026-06-22** `245eb8c59534` — 37 breaking, 39 info - the request property `method` became not nullable - removed the enum value `alma` of the request property `method` - removed the enum value `applepay` of the request property `method` - removed the enum value `bacs` of the request property `method` - removed the enum value `bancomatpay` of the request property `method` - removed the enum value `bancontact` of the request property `method` - removed the enum value `banktransfer` of the request property `method` - removed the enum value `belfius` of the request property `method` - removed the enum value `billie` of the request property `method` - removed the enum value `bizum` of the request property `method` - removed the enum value `blik` of the request property `method` - removed the enum value `creditcard` of the request property `method` - removed the enum value `directdebit` of the request property `method` - removed the enum value `eps` of the request property `method` - removed the enum value `giftcard` of the request property `method` - removed the enum value `ideal` of the request property `method` - removed the enum value `in3` of the request property `method` - removed the enum value `kbc` of the request property `method` - removed the enum value `klarna` of the request property `method` - removed the enum value `mbway` of the request property `method` - removed the enum value `mobilepay` of the request property `method` - removed the enum value `multibanco` of the request property `method` - removed the enum value `mybank` of the request property `method` - removed the enum value `paybybank` of the request property `method` - removed the enum value `paypal` of the request property `method` - removed the enum value `paysafecard` of the request property `method` - removed the enum value `pointofsale` of the request property `method` - removed the enum value `przelewy24` of the request property `method` - removed the enum value `riverty` of the request property `method` - removed the enum value `satispay` of the request property `method` - removed the enum value `swish` of the request property `method` - removed the enum value `trustly` of the request property `method` - removed the enum value `twint` of the request property `method` - removed the enum value `vipps` of the request property `method` - removed the enum value `voucher` of the request property `method` - the `method` request property type changed from `string, null` to no type - the `allOf[#/components/schemas/entity-payment-response]/method` response's property type changed from `string, null` to no type for status `200` - added `#/components/schemas/method, subschema #2` to the `method` request property `oneOf` list - removed the `alma` enum value from the `allOf[#/components/schemas/entity-payment-response]/method` response property for the response status `200` - removed the `applepay` enum value from the `allOf[#/components/schemas/entity-payment-response]/method` response property for the response status `200` - …36 more - **2026-06-09** `327472893a89` — 1 warning - added the new `googlepay` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/wallet` response property for the response status `200` - **2026-05-19** `7cab62b21830` — 1 info - added the non-success response with the status `429` - **2026-05-12** `331cb8579126` — 1 info - the response required property `allOf[#/components/schemas/entity-payment-response]/routing/items/_links` became read-only for the status `200` - **2026-05-12** `ef4b5a97b56a` — 2 info - the endpoint scheme security `advancedAccessToken` was added to the API - the endpoint scheme security `organizationAccessToken` was removed from the API - **2026-05-05** `f3d6346a1412` — 2 warning, 2 info - added the new `de_LU` enum value to the `allOf[#/components/schemas/entity-payment-response]/locale` response property for the response status `200` - added the new `fr_LU` enum value to the `allOf[#/components/schemas/entity-payment-response]/locale` response property for the response status `200` - added the new `de_LU` enum value to the request property `locale` - added the new `fr_LU` enum value to the request property `locale` - **2026-05-04** `18e0e58eb54d` — 1 info - response property `allOf[#/components/schemas/entity-payment-response]/settlementAmount` deprecated --- [Operation](https://skmtc.dev/mollie/apis/mollie-api/docs/v2/payments/:paymentId/patch.md) · [API](https://skmtc.dev/mollie/apis/mollie-api.md) · [Page](https://skmtc.dev/mollie/apis/mollie-api/changes/v2/payments/:paymentId/patch)