v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-131362831.1 MB

Split configuration - merchant level

Update the split logic

Changes the split logic specified in the path.

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

Management API - SplitConfiguration read and write

patch/merchants/{merchantId}/splitConfigurations/{splitConfigurationId}/rules/{ruleId}/splitLogic/{splitLogicId}

Path parameters

merchantIdstring required

The unique identifier of the merchant account.

splitConfigurationIdstring required

The unique identifier of the split configuration.

ruleIdstring required

The unique identifier of the split configuration rule.

splitLogicIdstring required

The unique identifier of the split configuration split.

Request body

acquiringFees'deductFromLiableAccount' | 'deductFromOneBalanceAccount'

Deducts the acquiring fees (the aggregated amount of interchange and scheme fee) from the specified balance account.

Possible values: deductFromLiableAccount, deductFromOneBalanceAccount.

adyenCommission'deductFromLiableAccount' | 'deductFromOneBalanceAccount'

Deducts the transaction fee due to Adyen under blended rates 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 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

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: The transaction fee due to Adyen under blended rates.
adyenMarkup: The transaction fee due to Adyen under Interchange ++ pricing.
schemeFee: The fee paid to the card scheme for using their network.
interchange: The fee paid to the issuer for each payment transaction made with the card network.
adyenFees: The aggregated amount of Adyen's commission and markup.
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.

splitLogicIdstring

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.

Response

OK - the request has succeeded.

descriptionstring required

Your description for the split configuration.

splitConfigurationIdstring

Unique identifier of the split configuration.