Adyen Management API — Merchants

naftiko: 1.0.0-alpha2
info:
  label: Adyen Management API — Merchants
  description: 'Adyen Management API — Merchants. 67 operations. Lead operation: Adyen Get a List of Merchant Accounts. Self-contained
    Naftiko capability covering one Adyen business surface.'
  tags:
  - Adyen
  - Merchants
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    ADYEN_API_KEY: ADYEN_API_KEY
capability:
  consumes:
  - type: http
    namespace: management-merchants
    baseUri: https://management-test.adyen.com/v3
    description: Adyen Management API — Merchants business capability. Self-contained, no shared references.
    resources:
    - name: merchants
      path: /merchants
      operations:
      - name: getmerchants
        method: GET
        description: Adyen Get a List of Merchant Accounts
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: pageNumber
          in: query
          type: integer
          description: The number of the page to fetch.
        - name: pageSize
          in: query
          type: integer
          description: The number of items to have on a page, maximum 100. The default is 10 items on a page.
      - name: postmerchants
        method: POST
        description: Adyen Create a Merchant Account
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: merchants-merchantId
      path: /merchants/{merchantId}
      operations:
      - name: getmerchantsmerchantid
        method: GET
        description: Adyen Get a Merchant Account
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
    - name: merchants-merchantId-activate
      path: /merchants/{merchantId}/activate
      operations:
      - name: postmerchantsmerchantidactivate
        method: POST
        description: Adyen Request to Activate a Merchant Account
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
    - name: merchants-merchantId-apiCredentials
      path: /merchants/{merchantId}/apiCredentials
      operations:
      - name: getmerchantsmerchantidapicredentials
        method: GET
        description: Adyen Get a List of API Credentials
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: pageNumber
          in: query
          type: integer
          description: The number of the page to fetch.
        - name: pageSize
          in: query
          type: integer
          description: The number of items to have on a page, maximum 100. The default is 10 items on a page.
      - name: postmerchantsmerchantidapicredentials
        method: POST
        description: Adyen Create an API Credential
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: merchants-merchantId-apiCredentials-apiCredentialId
      path: /merchants/{merchantId}/apiCredentials/{apiCredentialId}
      operations:
      - name: getmerchantsmerchantidapicredentialsapicredentialid
        method: GET
        description: Adyen Get an API Credential
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: apiCredentialId
          in: path
          type: string
          description: Unique identifier of the API credential.
          required: true
      - name: patchmerchantsmerchantidapicredentialsapicredentialid
        method: PATCH
        description: Adyen Update an API Credential
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: apiCredentialId
          in: path
          type: string
          description: Unique identifier of the API credential.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins
      path: /merchants/{merchantId}/apiCredentials/{apiCredentialId}/allowedOrigins
      operations:
      - name: getmerchantsmerchantidapicredentialsapicredentialidallowedorigins
        method: GET
        description: Adyen Get a List of Allowed Origins
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: apiCredentialId
          in: path
          type: string
          description: Unique identifier of the API credential.
          required: true
      - name: postmerchantsmerchantidapicredentialsapicredentialidallowedorigins
        method: POST
        description: Adyen Create an Allowed Origin
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: apiCredentialId
          in: path
          type: string
          description: Unique identifier of the API credential.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: merchants-merchantId-apiCredentials-apiCredentialId-allowedOrigins-originId
      path: /merchants/{merchantId}/apiCredentials/{apiCredentialId}/allowedOrigins/{originId}
      operations:
      - name: deletemerchantsmerchantidapicredentialsapicredentialidallowedoriginsoriginid
        method: DELETE
        description: Adyen Delete an Allowed Origin
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: apiCredentialId
          in: path
          type: string
          description: Unique identifier of the API credential.
          required: true
        - name: originId
          in: path
          type: string
          description: Unique identifier of the allowed origin.
          required: true
      - name: getmerchantsmerchantidapicredentialsapicredentialidallowedoriginsoriginid
        method: GET
        description: Adyen Get an Allowed Origin
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: apiCredentialId
          in: path
          type: string
          description: Unique identifier of the API credential.
          required: true
        - name: originId
          in: path
          type: string
          description: Unique identifier of the allowed origin.
          required: true
    - name: merchants-merchantId-apiCredentials-apiCredentialId-generateApiKey
      path: /merchants/{merchantId}/apiCredentials/{apiCredentialId}/generateApiKey
      operations:
      - name: postmerchantsmerchantidapicredentialsapicredentialidgenerateapikey
        method: POST
        description: Adyen Generate New API Key
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: apiCredentialId
          in: path
          type: string
          description: Unique identifier of the API credential.
          required: true
    - name: merchants-merchantId-apiCredentials-apiCredentialId-generateClientKey
      path: /merchants/{merchantId}/apiCredentials/{apiCredentialId}/generateClientKey
      operations:
      - name: postmerchantsmerchantidapicredentialsapicredentialidgenerateclientkey
        method: POST
        description: Adyen Generate New Client Key
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: apiCredentialId
          in: path
          type: string
          description: Unique identifier of the API credential.
          required: true
    - name: merchants-merchantId-billingEntities
      path: /merchants/{merchantId}/billingEntities
      operations:
      - name: getmerchantsmerchantidbillingentities
        method: GET
        description: Adyen Get a List of Billing Entities
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: name
          in: query
          type: string
          description: The name of the billing entity.
    - name: merchants-merchantId-paymentMethodSettings
      path: /merchants/{merchantId}/paymentMethodSettings
      operations:
      - name: getmerchantsmerchantidpaymentmethodsettings
        method: GET
        description: Adyen Get All Payment Methods
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: storeId
          in: query
          type: string
          description: The unique identifier of the store for which to return the payment methods.
        - name: businessLineId
          in: query
          type: string
          description: The unique identifier of the Business Line for which to return the payment methods.
        - name: pageSize
          in: query
          type: integer
          description: The number of items to have on a page, maximum 100. The default is 10 items on a page.
        - name: pageNumber
          in: query
          type: integer
          description: The number of the page to fetch.
      - name: postmerchantsmerchantidpaymentmethodsettings
        method: POST
        description: Adyen Request a Payment Method
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: merchants-merchantId-paymentMethodSettings-paymentMethodId
      path: /merchants/{merchantId}/paymentMethodSettings/{paymentMethodId}
      operations:
      - name: getmerchantsmerchantidpaymentmethodsettingspaymentmethodid
        method: GET
        description: Adyen Get Payment Method Details
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: paymentMethodId
          in: path
          type: string
          description: The unique identifier of the payment method.
          required: true
      - name: patchmerchantsmerchantidpaymentmethodsettingspaymentmethodid
        method: PATCH
        description: Adyen Update a Payment Method
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: paymentMethodId
          in: path
          type: string
          description: The unique identifier of the payment method.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: merchants-merchantId-paymentMethodSettings-paymentMethodId-addApplePayDomains
      path: /merchants/{merchantId}/paymentMethodSettings/{paymentMethodId}/addApplePayDomains
      operations:
      - name: postmerchantsmerchantidpaymentmethodsettingspaymentmethodidaddapplepaydomains
        method: POST
        description: Adyen Add an Apple Pay Domain
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: paymentMethodId
          in: path
          type: string
          description: The unique identifier of the payment method.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: merchants-merchantId-paymentMethodSettings-paymentMethodId-getApplePayDomains
      path: /merchants/{merchantId}/paymentMethodSettings/{paymentMethodId}/getApplePayDomains
      operations:
      - name: getmerchantsmerchantidpaymentmethodsettingspaymentmethodidgetapplepaydomains
        method: GET
        description: Adyen Get Apple Pay Domains
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: paymentMethodId
          in: path
          type: string
          description: The unique identifier of the payment method.
          required: true
    - name: merchants-merchantId-payoutSettings
      path: /merchants/{merchantId}/payoutSettings
      operations:
      - name: getmerchantsmerchantidpayoutsettings
        method: GET
        description: Adyen Get a List of Payout Settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
      - name: postmerchantsmerchantidpayoutsettings
        method: POST
        description: Adyen Add a Payout Setting
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: merchants-merchantId-payoutSettings-payoutSettingsId
      path: /merchants/{merchantId}/payoutSettings/{payoutSettingsId}
      operations:
      - name: deletemerchantsmerchantidpayoutsettingspayoutsettingsid
        method: DELETE
        description: Adyen Delete a Payout Setting
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: payoutSettingsId
          in: path
          type: string
          description: The unique identifier of the payout setting.
          required: true
      - name: getmerchantsmerchantidpayoutsettingspayoutsettingsid
        method: GET
        description: Adyen Get a Payout Setting
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: payoutSettingsId
          in: path
          type: string
          description: The unique identifier of the payout setting.
          required: true
      - name: patchmerchantsmerchantidpayoutsettingspayoutsettingsid
        method: PATCH
        description: Adyen Update a Payout Setting
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: payoutSettingsId
          in: path
          type: string
          description: The unique identifier of the payout setting.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: merchants-merchantId-shippingLocations
      path: /merchants/{merchantId}/shippingLocations
      operations:
      - name: getmerchantsmerchantidshippinglocations
        method: GET
        description: Adyen Get a List of Shipping Locations
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: name
          in: query
          type: string
          description: The name of the shipping location.
        - name: offset
          in: query
          type: integer
          description: The number of locations to skip.
        - name: limit
          in: query
          type: integer
          description: The number of locations to return.
      - name: postmerchantsmerchantidshippinglocations
        method: POST
        description: Adyen Create a Shipping Location
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: merchants-merchantId-splitConfigurations
      path: /merchants/{merchantId}/splitConfigurations
      operations:
      - name: getmerchantsmerchantidsplitconfigurations
        method: GET
        description: Adyen Get a List of Split Configurations
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
      - name: postmerchantsmerchantidsplitconfigurations
        method: POST
        description: Adyen Create a Split Configuration
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: merchants-merchantId-splitConfigurations-splitConfigurationId
      path: /merchants/{merchantId}/splitConfigurations/{splitConfigurationId}
      operations:
      - name: deletemerchantsmerchantidsplitconfigurationssplitconfigurationid
        method: DELETE
        description: Adyen Delete a Split Configuration
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: splitConfigurationId
          in: path
          type: string
          description: The unique identifier of the split configuration.
          required: true
      - name: getmerchantsmerchantidsplitconfigurationssplitconfigurationid
        method: GET
        description: Adyen Get a Split Configuration
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: splitConfigurationId
          in: path
          type: string
          description: The unique identifier of the split configuration.
          required: true
      - name: patchmerchantsmerchantidsplitconfigurationssplitconfigurationid
        method: PATCH
        description: Adyen Update Split Configuration Description
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: splitConfigurationId
          in: path
          type: string
          description: The unique identifier of the split configuration.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: postmerchantsmerchantidsplitconfigurationssplitconfigurationid
        method: POST
        description: Adyen Create a Rule
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: splitConfigurationId
          in: path
          type: string
          description: The unique identifier of the split configuration.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId
      path: /merchants/{merchantId}/splitConfigurations/{splitConfigurationId}/rules/{ruleId}
      operations:
      - name: deletemerchantsmerchantidsplitconfigurationssplitconfigurationidrulesruleid
        method: DELETE
        description: Adyen Delete a Split Configuration Rule
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: splitConfigurationId
          in: path
          type: string
          description: The unique identifier of the split configuration.
          required: true
        - name: ruleId
          in: path
          type: string
          required: true
      - name: patchmerchantsmerchantidsplitconfigurationssplitconfigurationidrulesruleid
        method: PATCH
        description: Adyen Update Split Conditions
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: splitConfigurationId
          in: path
          type: string
          description: The identifier of the split configuration.
          required: true
        - name: ruleId
          in: path
          type: string
          description: The unique identifier of the split configuration rule.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: merchants-merchantId-splitConfigurations-splitConfigurationId-rules-ruleId-split
      path: /merchants/{merchantId}/splitConfigurations/{splitConfigurationId}/rules/{ruleId}/splitLogic/{splitLogicId}
      operations:
      - name: patchmerchantsmerchantidsplitconfigurationssplitconfigurationidrulesruleidsplitlogicsplitlogicid
        method: PATCH
        description: Adyen Update the Split Logic
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: splitConfigurationId
          in: path
          type: string
          description: The unique identifier of the split configuration.
          required: true
        - name: ruleId
          in: path
          type: string
          description: The unique identifier of the split configuration rule.
          required: true
        - name: splitLogicId
          in: path
          type: string
          description: The unique identifier of the split configuration split.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: merchants-merchantId-stores
      path: /merchants/{merchantId}/stores
      operations:
      - name: getmerchantsmerchantidstores
        method: GET
        description: Adyen Get a List of Stores
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: pageNumber
          in: query
          type: integer
          description: The number of the page to fetch.
        - name: pageSize
          in: query
          type: integer
          description: The number of items to have on a page, maximum 100. The default is 10 items on a page.
        - name: reference
          in: query
          type: string
          description: The reference of the store.
      - name: postmerchantsmerchantidstores
        method: POST
        description: Adyen Create a Store
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: merchants-merchantId-stores-reference-terminalLogos
      path: /merchants/{merchantId}/stores/{reference}/terminalLogos
      operations:
      - name: getmerchantsmerchantidstoresreferenceterminallogos
        method: GET
        description: Adyen Get the Terminal Logo
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: reference
          in: path
          type: string
          description: The reference that identifies the store.
          required: true
        - name: model
          in: query
          type: string
          description: 'The terminal model. Possible values: E355, VX675WIFIBT, VX680, VX690, VX700, VX820, M400, MX925, P400Plus,
            UX300, UX410, V200cPlus, V240mPlus, V400cPlus, V400m,'
          required: true
      - name: patchmerchantsmerchantidstoresreferenceterminallogos
        method: PATCH
        description: Adyen Update the Terminal Logo
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          description: The unique identifier of the merchant account.
          required: true
        - name: reference
          in: path
          type: string
          description: The reference that identifies the store.
          required: true
        - name: model
          in: query
          type: string
          description: 'The terminal model. Possible values: E355, VX675WIFIBT, VX680, VX690, VX700, VX820, M400, MX925, P400Plus,
            UX300, UX410, V200cPlus, V240mPlus, V400cPlus, V400m,'
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: merchants-merchantId-stores-reference-terminalSettings
      path: /merchants/{merchantId}/stores/{reference}/terminalSettings
      operations:
      - name: getmerchantsmerchantidstoresreferenceterminalsettings
        method: GET
        description: Adyen Get Terminal Settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type:

# --- truncated at 32 KB (112 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/adyen/refs/heads/main/capabilities/management-merchants.yaml