Adyen Split Payments
Get started with Adyen Split Payments via Hyperswitch
Adyen's Split Payments functionality allows businesses to divide a single transaction into multiple payouts, ensuring funds are accurately distributed across various accounts. This feature is supported through their Platform solutions and implemented via Hyperswitch. Hyperswitch facilitates splitting payments during authorization and refund processing, ensuring smooth fund distribution at all transaction stages
Split Adyen payments via Hyperswitch
In the payment create request, include the Adyen split rule as provided below.
"split_payments": {
"adyen_split_payment": {
"store": "4935y84385736",
"split_items": [{
"split_type": "BalanceAccount",
"amount": 900,
"account": "*********",
"reference":"7823648726",
"description": "adyen split test"
},
{
"split_type": "Commission",
"amount": 100,
"account": "************",
"reference":"7823648726",
"description": "adyen split test"
}]
}
}
Field Specifications
store
(Optional): Required only for Adyen Platform implementations, not needed for Adyen Marketplace.
split_items
: Array of split rules where the sum of all amount
values must equal the total payment amount.
Split Item Fields
split_type
: Defines the payment portion allocation. Supported values:
BalanceAccount
: Direct allocation to specified account (requiresaccount
field)Commission
: Platform commission (requiresamount
field)Vat
: Value-added tax allocationTopUp
: Balance account funding (requiresaccount
, not available with Platform)Fee types (
AcquiringFees
,PaymentFee
,AdyenFees
, etc.): Calculated automatically
amount
: Split amount in minor units. Required for Commission
, Vat
, and TopUp
types; optional for fee types as they're calculated by Adyen.
account
: Target account identifier. Required for BalanceAccount
and TopUp
types.
reference
: Unique identifier for tracking.
description
: Optional description for reporting.
Validation Rules
Hyperswitch enforces several validation rules:
Split amounts must sum to total payment amount
BalanceAccount
andTopUp
types requireaccount
fieldCommission
,Vat
, andTopUp
types requireamount
fieldTopUp
splits are incompatible with Platform store configuration
Payments Response
"split_payments": {
"AdyenSplitPayment": {
"store": "4935y84385736",
"split_items": [
{
"amount": 900,
"split_type": "BalanceAccount",
"account": "*****************",
"reference": "7823648726",
"description": "adyen split test"
},
{
"amount": 100,
"split_type": "Commission",
"account": "**************",
"reference": "7823648726",
"description": "adyen split test"
}
]
}
},
Split Adyen refunds via Hyperswitch
In the refund create request, include the following according to your split rule
"split_refund": {
"adyen_split_refund": {
"store": "4935y84385736",
"split_items": [{
"split_type": "BalanceAccount",
"amount": 900,
"account": "*********",
"reference":"7823648726",
"description": "adyen split test"
},
{
"split_type": "Commission",
"amount": 100,
"account": "************",
"reference":"7823648726",
"description": "adyen split test"
}]
}
}
The request structure includes fields:
store
: Optional store identifier for Adyen Platformsplit_items
: Array of split items with the same structure as payment splitssplit_type
: The type of split (BalanceAccount, Commission, etc.)amount
: Split amount in minor unitsaccount
: Target account identifierreference
: Unique identifier for trackingdescription
: Optional description
Refund Response
"split_refund": {
"adyen_split_refund": {
"store": "4935y84385736",
"split_items": [
{
"amount": 900,
"split_type": "BalanceAccount",
"account": "*****************",
"reference": "7823648726",
"description": "adyen split test"
},
{
"amount": 100,
"split_type": "Commission",
"account": "**************",
"reference": "7823648726",
"description": "adyen split test"
}
]
}
}
Last updated
Was this helpful?