Sign in

v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-131362831.1 MB
Payment methods - merchant level

Update a payment method

Updates payment method details for the merchant account and the payment method identified in the path. Depending the payment method type, you may need to send an additional object required for the payment method.

To make this request, your API credential must have the following role:

  • Management API—Payment methods read and write
patch/merchants/{merchantId}/paymentMethodSettings/{paymentMethodId}

Path parameters

merchantIdstring required

The unique identifier of the merchant account.

paymentMethodIdstring required

The unique identifier of the payment method.

Request body

countriesstring[]

The list of countries where a payment method is available. By default, all countries supported by the payment method.

currenciesstring[]

The list of currencies that a payment method supports. By default, all currencies supported by the payment method.

customRoutingFlagsstring[]

Custom routing flags for acquirer routing.

enabledboolean

Indicates whether the payment method is enabled (true) or disabled (false).

storeIdsstring[]

The list of stores for this payment method

Response

OK - the request has succeeded.

allowedboolean

Indicates whether receiving payments is allowed. This value is set to true by Adyen after screening your merchant account.

businessLineIdstring

The unique identifier of the business line. Required if you are a platform model.

countriesstring[]

The list of countries where a payment method is available. By default, all countries supported by the payment method.

currenciesstring[]

The list of currencies that a payment method supports. By default, all currencies supported by the payment method.

customRoutingFlagsstring[]

The list of custom routing flags to route payment to the intended acquirer.

enabledboolean

Indicates whether the payment method is enabled (true) or disabled (false).

idstring required

The identifier of the resource.

referencestring

Your reference for the payment method. Supported characters a-z, A-Z, 0-9.

shopperInteractionstring

The sales channel.

storeIdstring

The ID of the store, if any.

typestring

Payment method variant.

verificationStatus'valid' | 'pending' | 'invalid' | 'rejected'

Payment method status. Possible values:

  • valid
  • pending
  • invalid
  • rejected