---
title: "Update the split conditions"
method: PATCH
path: "/merchants/{merchantId}/splitConfigurations/{splitConfigurationId}/rules/{ruleId}"
tags: ["Split configuration - merchant level"]
---

# Update the split conditions

`PATCH /merchants/{merchantId}/splitConfigurations/{splitConfigurationId}/rules/{ruleId}`

Changes the [split conditions of the rule](https://docs.adyen.com/platforms/automatic-split-configuration/manage-split-configurations/api/#update-condition) specified 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 - SplitConfiguration read and write

## Path parameters

- `merchantId` string, required
- `splitConfigurationId` string, required
- `ruleId` string, required

## Request body

- UpdateSplitConfigurationRuleRequest
  - `currency` string, required — The currency condition that defines whether the split logic applies. Its value must be a three-character [ISO currency code](https://en.wikipedia.org/wiki/ISO_4217).
  - `fundingSource` string, required — The funding source of the payment method. Possible values: * **credit** * **debit** * **prepaid** * **deferred_debit** * **charged** * **ANY**
  - `paymentMethod` string, required — The payment method condition that defines whether the split logic applies. Possible values: * [Payment method variant](https://docs.adyen.com/development-resources/paymentmethodvariant): Apply the split logic for a specific payment method. * **ANY**: Apply the split logic for all available payment methods.
  - `shopperInteraction` string, required — The sales channel condition that defines whether the split logic applies. Possible values: * **Ecommerce**: Online transactions where the cardholder is present. * **ContAuth**: Card on file and/or subscription transactions, where the cardholder is known to the merchant (returning customer). * **Moto**: Mail-order and telephone-order transactions where the customer is in contact with the merchant via email or telephone. * **POS**: Point-of-sale transactions where the customer is physically present to make a payment using a secure payment terminal. * **ANY**: All sales channels.

## Response `200`

OK - the request has succeeded.

- SplitConfiguration
  - `description` string, required — Your description for the split configuration.
  - `rules` SplitConfigurationRule[], required — Array of rules that define the split configuration behavior.
    - `cardRegion` 'international' | 'intraEEA' | 'intraRegional' | 'interRegional' | 'domestic' | 'ANY' — The card region condition that determines whether the [split logic](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/(merchantId)/splitConfigurations#request-rules-splitLogic) applies to the transaction. > This condition is in pilot phase, and not yet available for all platforms. Possible values: * **domestic**: The card issuer and the store where the transaction is processed are registered in the same country. * **international**: The card issuer and the store where the transaction is processed are registered in different countries or regions. Includes all **interRegional** and **intraRegional** transactions. * **interRegional**: The card issuer and the store where the transaction is processed are registered in different regions. * **intraRegional**: The card issuer and the store where the transaction is processed are registered in different countries, but in the same region. * **intraEEA**: The card issuer and the store where the transaction is processed are registered in different countries, but in the European Economic Area (EEA). * **ANY**: Applies to all transactions, regardless of the processing and issuing country/region.
    - `currency` string, required — The currency condition that defines whether the split logic applies. Its value must be a three-character [ISO currency code](https://en.wikipedia.org/wiki/ISO_4217).
    - `fundingSource` 'charged' | 'credit' | 'debit' | 'deferred_debit' | 'prepaid' | 'ANY', required — The funding source of the payment method. Possible values: * **credit** * **debit** * **prepaid** * **deferred_debit** * **charged** * **ANY**
    - `paymentMethod` string, required — The payment method condition that defines whether the split logic applies. Possible values: * [Payment method variant](https://docs.adyen.com/development-resources/paymentmethodvariant): Apply the split logic for a specific payment method. * **ANY**: Apply the split logic for all available payment methods.
    - `ruleId` string — The unique identifier of the split configuration rule.
    - `shopperInteraction` 'Ecommerce' | 'ContAuth' | 'Moto' | 'POS' | 'ANY', required — The sales channel condition that defines whether the split logic applies. Possible values: * **Ecommerce**: Online transactions where the cardholder is present. * **ContAuth**: Card on file and/or subscription transactions, where the cardholder is known to the merchant (returning customer). * **Moto**: Mail-order and telephone-order transactions where the customer is in contact with the merchant via email or telephone. * **POS**: Point-of-sale transactions where the customer is physically present to make a payment using a secure payment terminal. * **ANY**: All sales channels.
    - `splitLogic` SplitConfigurationLogic, required
      - `acquiringFees` 'deductFromLiableAccount' | 'deductFromOneBalanceAccount' — Deducts the acquiring fees (the aggregated amount of interchange and scheme fee) from the specified balance account. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.
      - `additionalCommission` AdditionalCommission
        - `balanceAccountId` string — Unique identifier of the balance account to which the additional commission is booked.
        - `fixedAmount` integer — A fixed commission fee, in minor units.
        - `variablePercentage` integer — A variable commission fee, in basis points.
      - `adyenCommission` 'deductFromLiableAccount' | 'deductFromOneBalanceAccount' — Deducts the transaction fee due to Adyen under [blended rates](https://www.adyen.com/knowledge-hub/guides/payments-training-guide/get-the-best-from-your-card-processing) from the specified balance account. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.
      - `adyenFees` 'deductFromLiableAccount' | 'deductFromOneBalanceAccount' — Deducts the fees due to Adyen (markup or commission) from the specified balance account. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.
      - `adyenMarkup` 'deductFromLiableAccount' | 'deductFromOneBalanceAccount' — Deducts the transaction fee due to Adyen under [Interchange ++ pricing](https://www.adyen.com/what-is-interchange) from the specified balance account. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.
      - `chargeback` 'deductFromLiableAccount' | 'deductFromOneBalanceAccount' | 'deductAccordingToSplitRatio' — Specifies how and from which balance account(s) to deduct the chargeback amount. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**, **deductAccordingToSplitRatio**.
      - `chargebackCostAllocation` 'deductFromLiableAccount' | 'deductFromOneBalanceAccount' — Deducts the chargeback costs from the specified balance account. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**
      - `commission` Commission, required
        - `fixedAmount` integer — A fixed commission fee, in minor units.
        - `variablePercentage` integer — A variable commission fee, in basis points.
      - `dcc` SplitDcc
        - `accountHolderPercentage` integer
      - `interchange` 'deductFromLiableAccount' | 'deductFromOneBalanceAccount' — Deducts the interchange fee from specified balance account. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.
      - `paymentFee` 'deductFromLiableAccount' | 'deductFromOneBalanceAccount' — Deducts all transaction fees incurred by the payment from the specified balance account. The transaction fees include the acquiring fees (interchange and scheme fee), and the fees due to Adyen (markup or commission). You can book any and all these fees to different balance account by specifying other transaction fee parameters in your split configuration profile: - [`adyenCommission`](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/(merchantId)/splitConfigurations#request-rules-splitLogic-adyenCommission): The transaction fee due to Adyen under [blended rates](https://www.adyen.com/knowledge-hub/interchange-fees-explained#interchange-vs-blended). - [`adyenMarkup`](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/(merchantId)/splitConfigurations#request-rules-splitLogic-adyenMarkup): The transaction fee due to Adyen under [Interchange ++ pricing](https://www.adyen.com/knowledge-hub/interchange-fees-explained#interchange-vs-blended). - [`schemeFee`](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/(merchantId)/splitConfigurations#request-rules-splitLogic-schemeFee): The fee paid to the card scheme for using their network. - [`interchange`](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/(merchantId)/splitConfigurations#request-rules-splitLogic-interchange): The fee paid to the issuer for each payment transaction made with the card network. - [`adyenFees`](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/(merchantId)/splitConfigurations#request-rules-splitLogic-adyenFees): The aggregated amount of Adyen's commission and markup. - [`acquiringFees`](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/(merchantId)/splitConfigurations#request-rules-splitLogic-acquiringFees): The aggregated amount of the interchange and scheme fees. If you don't include at least one transaction fee type in the `splitLogic` object, Adyen updates the payment request with the `paymentFee` parameter, booking all transaction fees to your platform's liable balance account. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.
      - `refund` 'deductFromLiableAccount' | 'deductFromOneBalanceAccount' | 'deductAccordingToSplitRatio' — Specifies how and from which balance account(s) to deduct the refund amount. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**, **deductAccordingToSplitRatio**
      - `refundCostAllocation` 'deductFromLiableAccount' | 'deductFromOneBalanceAccount' — Deducts the refund costs from the specified balance account. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**
      - `remainder` 'addToLiableAccount' | 'addToOneBalanceAccount' — Books the amount left over after currency conversion to the specified balance account. Possible values: **addToLiableAccount**, **addToOneBalanceAccount**.
      - `schemeFee` 'deductFromLiableAccount' | 'deductFromOneBalanceAccount' — Deducts the scheme fee from the specified balance account. Possible values: **deductFromLiableAccount**, **deductFromOneBalanceAccount**.
      - `splitLogicId` string — Unique identifier of the collection of split instructions that are applied when the rule conditions are met.
      - `surcharge` 'addToLiableAccount' | 'addToOneBalanceAccount' — Books the surcharge amount to the specified balance account. Possible values: **addToLiableAccount**, **addToOneBalanceAccount**
      - `tip` 'addToLiableAccount' | 'addToOneBalanceAccount' — Books the tips (gratuity) to the specified balance account. Possible values: **addToLiableAccount**, **addToOneBalanceAccount**.
  - `splitConfigurationId` string — Unique identifier of the split configuration.

## 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.
- `500` — Internal Server Error - the server could not process the request.

---

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