---
title: "Update a payment method"
method: PATCH
path: "/merchants/{merchantId}/paymentMethodSettings/{paymentMethodId}"
tags: ["Payment methods - merchant level"]
---

# Update a payment method

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

Updates payment method details for the merchant account and the payment method identified in the path.

To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions):
* Management API—Payment methods read and write

## Path parameters

- `merchantId` string, required
- `paymentMethodId` string, required

## Request body

- UpdatePaymentMethodInfo
  - `bcmc` BcmcInfo
    - `enableBcmcMobile` boolean — Indicates if [Bancontact mobile](https://docs.adyen.com/payment-methods/bancontact/bancontact-mobile) is enabled.
  - `cartesBancaires` CartesBancairesInfo
    - `siret` string, required — Cartes Bancaires SIRET. Format: 14 digits.
    - `transactionDescription` TransactionDescriptionInfo
      - `doingBusinessAsName` string — The text to be shown on the shopper's bank statement. We recommend sending a maximum of 22 characters, otherwise banks might truncate the string. Allowed characters: **a-z**, **A-Z**, **0-9**, spaces, and special characters **. , ' _ - ? + * /**.
      - `type` 'append' | 'dynamic' | 'fixed' — The type of transaction description you want to use: - **fixed**: The transaction description set in this request is used for all payments with this payment method. - **append**: The transaction description set in this request is used as a base for all payments with this payment method. The [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is appended to this base description. Note that if the combined length exceeds 22 characters, banks may truncate the string. - **dynamic**: Only the [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is used for payments with this payment method.
  - `countries` string[] — The list of countries where a payment method is available. By default, all countries supported by the payment method.
  - `cup` GenericPmWithTdiInfo
    - `transactionDescription` TransactionDescriptionInfo
      - `doingBusinessAsName` string — The text to be shown on the shopper's bank statement. We recommend sending a maximum of 22 characters, otherwise banks might truncate the string. Allowed characters: **a-z**, **A-Z**, **0-9**, spaces, and special characters **. , ' _ - ? + * /**.
      - `type` 'append' | 'dynamic' | 'fixed' — The type of transaction description you want to use: - **fixed**: The transaction description set in this request is used for all payments with this payment method. - **append**: The transaction description set in this request is used as a base for all payments with this payment method. The [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is appended to this base description. Note that if the combined length exceeds 22 characters, banks may truncate the string. - **dynamic**: Only the [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is used for payments with this payment method.
  - `currencies` string[] — The list of currencies that a payment method supports. By default, all currencies supported by the payment method.
  - `customRoutingFlags` string[] — Custom routing flags for acquirer routing.
  - `diners` GenericPmWithTdiInfo
    - `transactionDescription` TransactionDescriptionInfo
      - `doingBusinessAsName` string — The text to be shown on the shopper's bank statement. We recommend sending a maximum of 22 characters, otherwise banks might truncate the string. Allowed characters: **a-z**, **A-Z**, **0-9**, spaces, and special characters **. , ' _ - ? + * /**.
      - `type` 'append' | 'dynamic' | 'fixed' — The type of transaction description you want to use: - **fixed**: The transaction description set in this request is used for all payments with this payment method. - **append**: The transaction description set in this request is used as a base for all payments with this payment method. The [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is appended to this base description. Note that if the combined length exceeds 22 characters, banks may truncate the string. - **dynamic**: Only the [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is used for payments with this payment method.
  - `discover` GenericPmWithTdiInfo
    - `transactionDescription` TransactionDescriptionInfo
      - `doingBusinessAsName` string — The text to be shown on the shopper's bank statement. We recommend sending a maximum of 22 characters, otherwise banks might truncate the string. Allowed characters: **a-z**, **A-Z**, **0-9**, spaces, and special characters **. , ' _ - ? + * /**.
      - `type` 'append' | 'dynamic' | 'fixed' — The type of transaction description you want to use: - **fixed**: The transaction description set in this request is used for all payments with this payment method. - **append**: The transaction description set in this request is used as a base for all payments with this payment method. The [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is appended to this base description. Note that if the combined length exceeds 22 characters, banks may truncate the string. - **dynamic**: Only the [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is used for payments with this payment method.
  - `eftpos_australia` GenericPmWithTdiInfo
    - `transactionDescription` TransactionDescriptionInfo
      - `doingBusinessAsName` string — The text to be shown on the shopper's bank statement. We recommend sending a maximum of 22 characters, otherwise banks might truncate the string. Allowed characters: **a-z**, **A-Z**, **0-9**, spaces, and special characters **. , ' _ - ? + * /**.
      - `type` 'append' | 'dynamic' | 'fixed' — The type of transaction description you want to use: - **fixed**: The transaction description set in this request is used for all payments with this payment method. - **append**: The transaction description set in this request is used as a base for all payments with this payment method. The [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is appended to this base description. Note that if the combined length exceeds 22 characters, banks may truncate the string. - **dynamic**: Only the [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is used for payments with this payment method.
  - `enabled` boolean — Indicates whether the payment method is enabled (**true**) or disabled (**false**).
  - `girocard` GenericPmWithTdiInfo
    - `transactionDescription` TransactionDescriptionInfo
      - `doingBusinessAsName` string — The text to be shown on the shopper's bank statement. We recommend sending a maximum of 22 characters, otherwise banks might truncate the string. Allowed characters: **a-z**, **A-Z**, **0-9**, spaces, and special characters **. , ' _ - ? + * /**.
      - `type` 'append' | 'dynamic' | 'fixed' — The type of transaction description you want to use: - **fixed**: The transaction description set in this request is used for all payments with this payment method. - **append**: The transaction description set in this request is used as a base for all payments with this payment method. The [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is appended to this base description. Note that if the combined length exceeds 22 characters, banks may truncate the string. - **dynamic**: Only the [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is used for payments with this payment method.
  - `ideal` GenericPmWithTdiInfo
    - `transactionDescription` TransactionDescriptionInfo
      - `doingBusinessAsName` string — The text to be shown on the shopper's bank statement. We recommend sending a maximum of 22 characters, otherwise banks might truncate the string. Allowed characters: **a-z**, **A-Z**, **0-9**, spaces, and special characters **. , ' _ - ? + * /**.
      - `type` 'append' | 'dynamic' | 'fixed' — The type of transaction description you want to use: - **fixed**: The transaction description set in this request is used for all payments with this payment method. - **append**: The transaction description set in this request is used as a base for all payments with this payment method. The [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is appended to this base description. Note that if the combined length exceeds 22 characters, banks may truncate the string. - **dynamic**: Only the [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is used for payments with this payment method.
  - `interac_card` GenericPmWithTdiInfo
    - `transactionDescription` TransactionDescriptionInfo
      - `doingBusinessAsName` string — The text to be shown on the shopper's bank statement. We recommend sending a maximum of 22 characters, otherwise banks might truncate the string. Allowed characters: **a-z**, **A-Z**, **0-9**, spaces, and special characters **. , ' _ - ? + * /**.
      - `type` 'append' | 'dynamic' | 'fixed' — The type of transaction description you want to use: - **fixed**: The transaction description set in this request is used for all payments with this payment method. - **append**: The transaction description set in this request is used as a base for all payments with this payment method. The [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is appended to this base description. Note that if the combined length exceeds 22 characters, banks may truncate the string. - **dynamic**: Only the [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is used for payments with this payment method.
  - `jcb` GenericPmWithTdiInfo
    - `transactionDescription` TransactionDescriptionInfo
      - `doingBusinessAsName` string — The text to be shown on the shopper's bank statement. We recommend sending a maximum of 22 characters, otherwise banks might truncate the string. Allowed characters: **a-z**, **A-Z**, **0-9**, spaces, and special characters **. , ' _ - ? + * /**.
      - `type` 'append' | 'dynamic' | 'fixed' — The type of transaction description you want to use: - **fixed**: The transaction description set in this request is used for all payments with this payment method. - **append**: The transaction description set in this request is used as a base for all payments with this payment method. The [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is appended to this base description. Note that if the combined length exceeds 22 characters, banks may truncate the string. - **dynamic**: Only the [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is used for payments with this payment method.
  - `maestro` GenericPmWithTdiInfo
    - `transactionDescription` TransactionDescriptionInfo
      - `doingBusinessAsName` string — The text to be shown on the shopper's bank statement. We recommend sending a maximum of 22 characters, otherwise banks might truncate the string. Allowed characters: **a-z**, **A-Z**, **0-9**, spaces, and special characters **. , ' _ - ? + * /**.
      - `type` 'append' | 'dynamic' | 'fixed' — The type of transaction description you want to use: - **fixed**: The transaction description set in this request is used for all payments with this payment method. - **append**: The transaction description set in this request is used as a base for all payments with this payment method. The [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is appended to this base description. Note that if the combined length exceeds 22 characters, banks may truncate the string. - **dynamic**: Only the [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is used for payments with this payment method.
  - `mc` GenericPmWithTdiInfo
    - `transactionDescription` TransactionDescriptionInfo
      - `doingBusinessAsName` string — The text to be shown on the shopper's bank statement. We recommend sending a maximum of 22 characters, otherwise banks might truncate the string. Allowed characters: **a-z**, **A-Z**, **0-9**, spaces, and special characters **. , ' _ - ? + * /**.
      - `type` 'append' | 'dynamic' | 'fixed' — The type of transaction description you want to use: - **fixed**: The transaction description set in this request is used for all payments with this payment method. - **append**: The transaction description set in this request is used as a base for all payments with this payment method. The [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is appended to this base description. Note that if the combined length exceeds 22 characters, banks may truncate the string. - **dynamic**: Only the [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is used for payments with this payment method.
  - `storeIds` string[] — The list of stores for this payment method
  - `visa` GenericPmWithTdiInfo
    - `transactionDescription` TransactionDescriptionInfo
      - `doingBusinessAsName` string — The text to be shown on the shopper's bank statement. We recommend sending a maximum of 22 characters, otherwise banks might truncate the string. Allowed characters: **a-z**, **A-Z**, **0-9**, spaces, and special characters **. , ' _ - ? + * /**.
      - `type` 'append' | 'dynamic' | 'fixed' — The type of transaction description you want to use: - **fixed**: The transaction description set in this request is used for all payments with this payment method. - **append**: The transaction description set in this request is used as a base for all payments with this payment method. The [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is appended to this base description. Note that if the combined length exceeds 22 characters, banks may truncate the string. - **dynamic**: Only the [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is used for payments with this payment method.

## Response `200`

OK - the request has succeeded.

- PaymentMethod
  - `afterpayTouch` AfterpayTouchInfo
    - `supportUrl` string, required — Support Url
  - `allowed` boolean — Indicates whether receiving payments is allowed. This value is set to **true** by Adyen after screening your merchant account.
  - `amex` AmexInfo
    - `midNumber` string — MID (Merchant ID) number. Format: 10 numeric characters. Must be provided only when requesting `gatewayContract` or `paymentDesignatorContract` service levels.
    - `reuseMidNumber` boolean — Indicates whether the Amex Merchant ID is reused from a previously setup Amex payment method. This is only applicable for `gatewayContract` and `paymentDesignatorContract` service levels. The default value is `false`.
    - `serviceLevel` 'noContract' | 'gatewayContract' | 'paymentDesignatorContract', required — Specifies the service level (settlement type) of this payment method. Possible values: * **noContract** — Adyen holds the contract with American Express. * **gatewayContract** — American Express receives the settlement and handles disputes. They then pay out to the merchant directly. * **paymentDesignatorContract** — Adyen receives the settlement and handles disputes. Adyen then pays out to the merchant.
  - `applePay` ApplePayInfo
    - `domains` string[], required — The list of merchant domains. Maximum: 99 domains per request. For more information, see [Apple Pay documentation](https://docs.adyen.com/payment-methods/apple-pay/web-drop-in?tab=adyen-certificate-live_1#going-live).
  - `bcmc` BcmcInfo
    - `enableBcmcMobile` boolean — Indicates if [Bancontact mobile](https://docs.adyen.com/payment-methods/bancontact/bancontact-mobile) is enabled.
  - `businessLineId` string — The unique identifier of the business line. Required if you are a [platform model](https://docs.adyen.com/platforms).
  - `cartesBancaires` CartesBancairesInfo
    - `siret` string, required — Cartes Bancaires SIRET. Format: 14 digits.
    - `transactionDescription` TransactionDescriptionInfo
      - `doingBusinessAsName` string — The text to be shown on the shopper's bank statement. We recommend sending a maximum of 22 characters, otherwise banks might truncate the string. Allowed characters: **a-z**, **A-Z**, **0-9**, spaces, and special characters **. , ' _ - ? + * /**.
      - `type` 'append' | 'dynamic' | 'fixed' — The type of transaction description you want to use: - **fixed**: The transaction description set in this request is used for all payments with this payment method. - **append**: The transaction description set in this request is used as a base for all payments with this payment method. The [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is appended to this base description. Note that if the combined length exceeds 22 characters, banks may truncate the string. - **dynamic**: Only the [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is used for payments with this payment method.
  - `clearpay` ClearpayInfo
    - `supportUrl` string, required — Support Url
  - `countries` string[] — The list of countries where a payment method is available. By default, all countries supported by the payment method.
  - `cup` GenericPmWithTdiInfo
    - `transactionDescription` TransactionDescriptionInfo
      - `doingBusinessAsName` string — The text to be shown on the shopper's bank statement. We recommend sending a maximum of 22 characters, otherwise banks might truncate the string. Allowed characters: **a-z**, **A-Z**, **0-9**, spaces, and special characters **. , ' _ - ? + * /**.
      - `type` 'append' | 'dynamic' | 'fixed' — The type of transaction description you want to use: - **fixed**: The transaction description set in this request is used for all payments with this payment method. - **append**: The transaction description set in this request is used as a base for all payments with this payment method. The [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is appended to this base description. Note that if the combined length exceeds 22 characters, banks may truncate the string. - **dynamic**: Only the [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is used for payments with this payment method.
  - `currencies` string[] — The list of currencies that a payment method supports. By default, all currencies supported by the payment method.
  - `customRoutingFlags` string[] — The list of custom routing flags to route payment to the intended acquirer.
  - `diners` GenericPmWithTdiInfo
    - `transactionDescription` TransactionDescriptionInfo
      - `doingBusinessAsName` string — The text to be shown on the shopper's bank statement. We recommend sending a maximum of 22 characters, otherwise banks might truncate the string. Allowed characters: **a-z**, **A-Z**, **0-9**, spaces, and special characters **. , ' _ - ? + * /**.
      - `type` 'append' | 'dynamic' | 'fixed' — The type of transaction description you want to use: - **fixed**: The transaction description set in this request is used for all payments with this payment method. - **append**: The transaction description set in this request is used as a base for all payments with this payment method. The [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is appended to this base description. Note that if the combined length exceeds 22 characters, banks may truncate the string. - **dynamic**: Only the [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is used for payments with this payment method.
  - `discover` GenericPmWithTdiInfo
    - `transactionDescription` TransactionDescriptionInfo
      - `doingBusinessAsName` string — The text to be shown on the shopper's bank statement. We recommend sending a maximum of 22 characters, otherwise banks might truncate the string. Allowed characters: **a-z**, **A-Z**, **0-9**, spaces, and special characters **. , ' _ - ? + * /**.
      - `type` 'append' | 'dynamic' | 'fixed' — The type of transaction description you want to use: - **fixed**: The transaction description set in this request is used for all payments with this payment method. - **append**: The transaction description set in this request is used as a base for all payments with this payment method. The [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is appended to this base description. Note that if the combined length exceeds 22 characters, banks may truncate the string. - **dynamic**: Only the [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is used for payments with this payment method.
  - `eftpos_australia` GenericPmWithTdiInfo
    - `transactionDescription` TransactionDescriptionInfo
      - `doingBusinessAsName` string — The text to be shown on the shopper's bank statement. We recommend sending a maximum of 22 characters, otherwise banks might truncate the string. Allowed characters: **a-z**, **A-Z**, **0-9**, spaces, and special characters **. , ' _ - ? + * /**.
      - `type` 'append' | 'dynamic' | 'fixed' — The type of transaction description you want to use: - **fixed**: The transaction description set in this request is used for all payments with this payment method. - **append**: The transaction description set in this request is used as a base for all payments with this payment method. The [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is appended to this base description. Note that if the combined length exceeds 22 characters, banks may truncate the string. - **dynamic**: Only the [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is used for payments with this payment method.
  - `enabled` boolean — Indicates whether the payment method is enabled (**true**) or disabled (**false**).
  - `giroPay` GiroPayInfo
    - `supportEmail` string, required — The email address of merchant support.
  - `girocard` GenericPmWithTdiInfo
    - `transactionDescription` TransactionDescriptionInfo
      - `doingBusinessAsName` string — The text to be shown on the shopper's bank statement. We recommend sending a maximum of 22 characters, otherwise banks might truncate the string. Allowed characters: **a-z**, **A-Z**, **0-9**, spaces, and special characters **. , ' _ - ? + * /**.
      - `type` 'append' | 'dynamic' | 'fixed' — The type of transaction description you want to use: - **fixed**: The transaction description set in this request is used for all payments with this payment method. - **append**: The transaction description set in this request is used as a base for all payments with this payment method. The [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is appended to this base description. Note that if the combined length exceeds 22 characters, banks may truncate the string. - **dynamic**: Only the [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is used for payments with this payment method.
  - `googlePay` GooglePayInfo
    - `merchantId` string, required — Google Pay [Merchant ID](https://support.google.com/paymentscenter/answer/7163092?hl=en). Character length and limitations: 16 alphanumeric characters or 20 numeric characters.
    - `reuseMerchantId` boolean — Indicates whether the Google Pay Merchant ID is used for several merchant accounts. Default value: **false**.
  - `id` string, required — The identifier of the resource.
  - `ideal` GenericPmWithTdiInfo
    - `transactionDescription` TransactionDescriptionInfo
      - `doingBusinessAsName` string — The text to be shown on the shopper's bank statement. We recommend sending a maximum of 22 characters, otherwise banks might truncate the string. Allowed characters: **a-z**, **A-Z**, **0-9**, spaces, and special characters **. , ' _ - ? + * /**.
      - `type` 'append' | 'dynamic' | 'fixed' — The type of transaction description you want to use: - **fixed**: The transaction description set in this request is used for all payments with this payment method. - **append**: The transaction description set in this request is used as a base for all payments with this payment method. The [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is appended to this base description. Note that if the combined length exceeds 22 characters, banks may truncate the string. - **dynamic**: Only the [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is used for payments with this payment method.
  - `interac_card` GenericPmWithTdiInfo
    - `transactionDescription` TransactionDescriptionInfo
      - `doingBusinessAsName` string — The text to be shown on the shopper's bank statement. We recommend sending a maximum of 22 characters, otherwise banks might truncate the string. Allowed characters: **a-z**, **A-Z**, **0-9**, spaces, and special characters **. , ' _ - ? + * /**.
      - `type` 'append' | 'dynamic' | 'fixed' — The type of transaction description you want to use: - **fixed**: The transaction description set in this request is used for all payments with this payment method. - **append**: The transaction description set in this request is used as a base for all payments with this payment method. The [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is appended to this base description. Note that if the combined length exceeds 22 characters, banks may truncate the string. - **dynamic**: Only the [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is used for payments with this payment method.
  - `jcb` GenericPmWithTdiInfo
    - `transactionDescription` TransactionDescriptionInfo
      - `doingBusinessAsName` string — The text to be shown on the shopper's bank statement. We recommend sending a maximum of 22 characters, otherwise banks might truncate the string. Allowed characters: **a-z**, **A-Z**, **0-9**, spaces, and special characters **. , ' _ - ? + * /**.
      - `type` 'append' | 'dynamic' | 'fixed' — The type of transaction description you want to use: - **fixed**: The transaction description set in this request is used for all payments with this payment method. - **append**: The transaction description set in this request is used as a base for all payments with this payment method. The [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is appended to this base description. Note that if the combined length exceeds 22 characters, banks may truncate the string. - **dynamic**: Only the [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is used for payments with this payment method.
  - `klarna` KlarnaInfo
    - `autoCapture` boolean — Indicates the status of [Automatic capture](https://docs.adyen.com/online-payments/capture#automatic-capture). Default value: **false**.
    - `disputeEmail` string, required — The email address for disputes.
    - `region` 'NA' | 'EU' | 'CH' | 'AU', required — The region of operation. For example, **NA**, **EU**, **CH**, **AU**.
    - `supportEmail` string, required — The email address of merchant support.
  - `maestro` GenericPmWithTdiInfo
    - `transactionDescription` TransactionDescriptionInfo
      - `doingBusinessAsName` string — The text to be shown on the shopper's bank statement. We recommend sending a maximum of 22 characters, otherwise banks might truncate the string. Allowed characters: **a-z**, **A-Z**, **0-9**, spaces, and special characters **. , ' _ - ? + * /**.
      - `type` 'append' | 'dynamic' | 'fixed' — The type of transaction description you want to use: - **fixed**: The transaction description set in this request is used for all payments with this payment method. - **append**: The transaction description set in this request is used as a base for all payments with this payment method. The [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is appended to this base description. Note that if the combined length exceeds 22 characters, banks may truncate the string. - **dynamic**: Only the [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is used for payments with this payment method.
  - `mc` GenericPmWithTdiInfo
    - `transactionDescription` TransactionDescriptionInfo
      - `doingBusinessAsName` string — The text to be shown on the shopper's bank statement. We recommend sending a maximum of 22 characters, otherwise banks might truncate the string. Allowed characters: **a-z**, **A-Z**, **0-9**, spaces, and special characters **. , ' _ - ? + * /**.
      - `type` 'append' | 'dynamic' | 'fixed' — The type of transaction description you want to use: - **fixed**: The transaction description set in this request is used for all payments with this payment method. - **append**: The transaction description set in this request is used as a base for all payments with this payment method. The [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is appended to this base description. Note that if the combined length exceeds 22 characters, banks may truncate the string. - **dynamic**: Only the [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is used for payments with this payment method.
  - `mealVoucher_FR` MealVoucherFRInfo
    - `conecsId` string, required — Meal Voucher conecsId. Format: digits only
    - `siret` string, required — Meal Voucher siret. Format: 14 digits.
    - `subTypes` string[], required — The list of additional payment methods. Allowed values: **mealVoucher_FR_edenred**, **mealVoucher_FR_groupeup**, **mealVoucher_FR_natixis**, **mealVoucher_FR_sodexo**.
  - `paypal` PayPalInfo
    - `directCapture` boolean — Indicates if direct (immediate) capture for PayPal is enabled. If set to **true**, this setting overrides the [capture](https://docs.adyen.com/online-payments/capture) settings of your merchant account. Default value: **true**.
    - `payerId` string, required — PayPal Merchant ID. Character length and limitations: 13 single-byte alphanumeric characters.
    - `subject` string, required — Your business email address.
  - `reference` string — Your reference for the payment method. Supported characters a-z, A-Z, 0-9.
  - `shopperInteraction` string — The sales channel.
  - `sofort` SofortInfo
    - `currencyCode` string, required — Sofort currency code. For example, **EUR**.
    - `logo` string, required — Sofort logo. Format: Base64-encoded string.
  - `storeId` string — The ID of the [store](https://docs.adyen.com/api-explorer/#/ManagementService/latest/post/stores__resParam_id), if any.
  - `swish` SwishInfo
    - `swishNumber` string, required — Swish number. Format: 10 digits without spaces. For example, **1231111111**.
  - `twint` TwintInfo
    - `logo` string, required — Twint logo. Format: Base64-encoded string.
  - `type` string — Payment method [variant](https://docs.adyen.com/development-resources/paymentmethodvariant#management-api).
  - `verificationStatus` 'valid' | 'pending' | 'invalid' | 'rejected' — Payment method status. Possible values: * **valid** * **pending** * **invalid** * **rejected**
  - `vipps` VippsInfo
    - `logo` string, required — Vipps logo. Format: Base64-encoded string.
    - `subscriptionCancelUrl` string — Vipps subscription cancel url (required in case of [recurring payments](https://docs.adyen.com/online-payments/tokenization))
  - `visa` GenericPmWithTdiInfo
    - `transactionDescription` TransactionDescriptionInfo
      - `doingBusinessAsName` string — The text to be shown on the shopper's bank statement. We recommend sending a maximum of 22 characters, otherwise banks might truncate the string. Allowed characters: **a-z**, **A-Z**, **0-9**, spaces, and special characters **. , ' _ - ? + * /**.
      - `type` 'append' | 'dynamic' | 'fixed' — The type of transaction description you want to use: - **fixed**: The transaction description set in this request is used for all payments with this payment method. - **append**: The transaction description set in this request is used as a base for all payments with this payment method. The [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is appended to this base description. Note that if the combined length exceeds 22 characters, banks may truncate the string. - **dynamic**: Only the [transaction description set in the request to process the payment](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-shopperStatement) is used for payments with this payment method.
  - `wechatpay` WeChatPayInfo
    - `contactPersonName` string, required — The name of the contact person from merchant support.
    - `email` string, required — The email address of merchant support.
  - `wechatpay_pos` WeChatPayPosInfo
    - `contactPersonName` string, required — The name of the contact person from merchant support.
    - `email` string, required — The email address of merchant support.

## Other responses

- `204` — No Content - the request has been successfully processed, but there is no additional content.
- `400` — Bad Request - a problem reading or understanding the request.
- `401` — Unauthorized - authentication required.
- `403` — Forbidden - insufficient permissions to process the request.
- `422` — Unprocessable Entity - a request validation error.
- `429`
- `500` — Internal Server Error - the server could not process the request.

## Changes

- **2024-06-05** (v1) `531d7ba14c5a` — 2 warning
  - removed the request property `bcmc/transactionDescription`
  - removed the optional property `bcmc/transactionDescription` from the response with the `200` status
- **2024-05-29** (v1) `9e0aa673bfb3` — 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** (v1) `3c7931ff4ebd` — 1 info
  - added the optional property `amex` to the response with the `200` status

[Change history](https://skmtc.dev/adyen/apis/management-api/changes/merchants/:merchantId/paymentMethodSettings/:paymentMethodId/patch.md)

---

[API](https://skmtc.dev/adyen/apis/management-api.md) · [All operations](https://skmtc.dev/adyen/apis/management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adyen/management-api/revisions/e405ccb47edb/schema)
