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

# Changes to Update a payment method

`PATCH /payment_methods/{paymentMethodId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 11 revisions.

- **2026-07-13** `859097ed3fe6`: 4 breaking, 4 warning, 25 info

## Changes

- **2026-07-13** `859097ed3fe6`: 4 breaking, 4 warning, 25 info
  - added the new required request property `data/relationships/market/data`
  - added the new required request property `data/relationships/payment_gateway/data`
  - request property `data/attributes/payment_source_type` was restricted to a list of enum values
  - request property `data/type` was restricted to a list of enum values
  - removed the request property `data/relationships/market/id`
  - removed the request property `data/relationships/market/type`
  - removed the request property `data/relationships/payment_gateway/id`
  - removed the request property `data/relationships/payment_gateway/type`
  - added the new optional request property `data/attributes/_disable`
  - added the new optional request property `data/attributes/_enable`
  - added the new optional request property `data/attributes/auto_capture`
  - added the new optional request property `data/attributes/auto_capture_max_amount_cents`
  - added the new optional request property `data/attributes/auto_place`
  - added the new optional request property `data/attributes/name`
  - added the new optional request property `data/attributes/require_capture`
  - added the new optional request property `data/relationships/store`
  - the request property `data/attributes/currency_code` became nullable
  - the request property `data/attributes/metadata` became nullable
  - the request property `data/attributes/reference` became nullable
  - the request property `data/attributes/reference_origin` became nullable
  - the `type` request property default value `payment_methods` was removed
  - added the new `adyen_payments` enum value to the request property `data/attributes/payment_source_type`
  - added the new `axerve_payments` enum value to the request property `data/attributes/payment_source_type`
  - added the new `braintree_payments` enum value to the request property `data/attributes/payment_source_type`
  - added the new `checkout_com_payments` enum value to the request property `data/attributes/payment_source_type`
  - added the new `external_payments` enum value to the request property `data/attributes/payment_source_type`
  - added the new `klarna_payments` enum value to the request property `data/attributes/payment_source_type`
  - added the new `payment_methods` enum value to the request property `data/type`
  - added the new `paypal_payments` enum value to the request property `data/attributes/payment_source_type`
  - added the new `satispay_payments` enum value to the request property `data/attributes/payment_source_type`
  - added the new `stripe_payments` enum value to the request property `data/attributes/payment_source_type`
  - added the new `wire_transfers` enum value to the request property `data/attributes/payment_source_type`
  - added the media type `application/vnd.api+json` for the response with the status `200`

---

[Operation](https://skmtc.dev/commercelayer/apis/commerce-layer-api/docs/payment_methods/:paymentMethodId/patch.md) - [API](https://skmtc.dev/commercelayer/apis/commerce-layer-api.md) - [Page](https://skmtc.dev/commercelayer/apis/commerce-layer-api/changes/payment_methods/:paymentMethodId/patch)