{"title":"How Adyen applies split instructions","category":"default","creationDate":1794484637,"content":"<div class=\"notices green\">\n<p>This logic defined on this page is in pilot phase and is not available for all platforms.<\/p>\n<\/div>\n<p>When you split transactions, you can provide the split instructions in several ways. For example, you can send instructions in a specific request, or link split configuration profiles to your users' stores. For refunds and chargebacks, you can also define a default logic for your balance platform.<\/p>\n<p>If you set up instructions in more than one way, then a transaction can have more than one set of instructions that applies to it. To determine which instruction takes precedence, Adyen uses a specific logic. This logic depends on the transaction's type. The following sections explain how Adyen applies split instructions for authorizations, captures, refunds, and chargebacks.<\/p>\n<h2>Authorizations<\/h2>\n<p>You can provide split instructions for an authorization in two ways: in the <code>splits<\/code> array of your <a href=\"\/platforms\/online-payments\/split-transactions\/split-payments-at-authorization\">authorization<\/a> request, or through a <a href=\"\/platforms\/automatic-split-configuration\">split configuration profile<\/a> linked to the store.<\/p>\n<p>At authorization, Adyen applies split instructions in the following order:<\/p>\n<ol>\n<li>Split instructions in the payment request.<\/li>\n<li>Split instructions in the split configuration profile, if the payment request does not include split instructions.<\/li>\n<\/ol>\n<h2>Captures<\/h2>\n<p>You can provide split instructions for a capture in two ways: in the <code>splits<\/code> array of your <a href=\"\/platforms\/online-payments\/split-transactions\/split-payments-at-capture\">capture<\/a> or <a href=\"\/platforms\/online-payments\/split-transactions\/split-payments-at-authorization\">authorization<\/a> request, or through a <a href=\"\/platforms\/automatic-split-configuration\">split configuration profile<\/a> linked to the store.<\/p>\n<p>At capture, Adyen applies split instructions in the following order:<\/p>\n<ol>\n<li>Split instructions in the capture request.<\/li>\n<li>Split instructions in the original authorisation request, if the capture request does not include split instructions.<\/li>\n<li>Split instructions in the split configuration profile, if neither request includes split instructions.<\/li>\n<\/ol>\n<h2>Refunds<\/h2>\n<p>You can provide split instructions for a refund in three ways:<\/p>\n<ul>\n<li>In the <code>splits<\/code> array of your <a href=\"\/platforms\/online-payments\/split-transactions\/split-refunds\">refund<\/a> request.<\/li>\n<li>Through a <a href=\"\/platforms\/automatic-split-configuration\">split configuration profile<\/a> linked to the store.<\/li>\n<li>As a default refund logic configured for your balance platform. Reach out to our <a href=\"https:\/\/ca-test.adyen.com\/ca\/ca\/contactUs\/support.shtml?form=other\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Support Team<\/a> to enable this.<\/li>\n<\/ul>\n<p>Adyen applies split instructions for a refund in the following order:<\/p>\n<ol>\n<li>You make a request to initiate a refund.<\/li>\n<li>Adyen checks if your refund request includes split instructions.\n<ul>\n<li>If yes, we split the refund amount according to the instructions in the request. The refund is processed, and the flow ends.<\/li>\n<li>If no, continue to step 3.<\/li>\n<\/ul><\/li>\n<li>Adyen checks if the refund request meets the conditions of a split configuration rule that has defined split refund instructions.\n<ul>\n<li>If yes, we split the refund amount according to the instructions in the <a href=\"\/platforms\/automatic-split-configuration#select-profile-based-on-booking-date\">profile that was active on the refund's booking date<\/a>. The refund is processed, and the flow ends.<\/li>\n<li>If no, continue to step 4.<\/li>\n<\/ul><\/li>\n<li>Adyen checks if a default refund logic is configured for your balance platform.\n<ul>\n<li>If yes, we split the refund amount according to the default refund logic. The refund is processed, and the flow ends.\n<ul>\n<li>If no, continue to step 5.<\/li>\n<\/ul><\/li>\n<\/ul><\/li>\n<li>If the refund covers the full amount of one full capture, including an overcapture, and the capture includes split data, we use the capture's split ratio. In all other cases, such as for refunds of partial captures, we book the full refund amount to your platform's liable balance account.<\/li>\n<\/ol>\n<p>The following diagram visualizes the logic explained above:<\/p>\n<p><a rel=\"lightbox\" href=\"\/media\/7f2e3a62063eb9c851222c1224e566927c9986038c0376c6e97392c316ad1c36.svg\" src=\"\">\n  <img alt=\"Diagram of how Adyen selects split instructions for a refund\" src=\"\/media\/7f2e3a62063eb9c851222c1224e566927c9986038c0376c6e97392c316ad1c36.svg\" \/>\n<\/a><\/p>\n<h2>Chargebacks<\/h2>\n<p>You can provide split instructions for a chargeback in three ways:<\/p>\n<ul>\n<li>As <a href=\"\/platforms\/online-payments\/split-transactions\/split-chargebacks#configure-the-chargeback-logic-for-a-payment\">chargeback logic<\/a> in a <code>platformChargebackLogic<\/code> object in your payment or capture request<\/li>\n<li>Through a <a href=\"\/platforms\/automatic-split-configuration\">split configuration profile<\/a> linked to the store.<\/li>\n<li>As a default chargeback logic configured for your balance platform. Reach out to our <a href=\"https:\/\/ca-test.adyen.com\/ca\/ca\/contactUs\/support.shtml?form=other\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Support Team<\/a> to enable this.<\/li>\n<\/ul>\n<p>Adyen applies split instructions for a chargeback in the following order:<\/p>\n<ol>\n<li>Your customer initiates a chargeback.<\/li>\n<li>Adyen checks if your capture request includes <a href=\"\/platforms\/online-payments\/split-transactions\/split-chargebacks#configure-the-chargeback-logic-for-a-payment\">chargeback logic<\/a>.\n<ul>\n<li>If yes, we split the chargeback amount according to the chargeback logic in the capture request. The chargeback is processed, and the flow ends.\n<ul>\n<li>If no, continue to step 3.<\/li>\n<\/ul><\/li>\n<\/ul><\/li>\n<li>Adyen checks if your original payment request includes <a href=\"\/platforms\/online-payments\/split-transactions\/split-chargebacks#configure-the-chargeback-logic-for-a-payment\">chargeback logic<\/a>.\n<ul>\n<li>If yes, we split the chargeback amount according to the chargeback logic in the payment request. The chargeback is processed, and the flow ends.<\/li>\n<li>If no, continue to step 4.<\/li>\n<\/ul><\/li>\n<li>Adyen checks if the chargeback meets the conditions of a split configuration rule that has defined split chargeback instructions.\n<ul>\n<li>If yes, we split the chargeback amount according to the instructions in the <a href=\"\/platforms\/automatic-split-configuration#select-profile-based-on-booking-date\">profile that was active on the chargeback's booking date<\/a>. The chargeback is processed, and the flow ends.<\/li>\n<li>If no, continue to step 5.<\/li>\n<\/ul><\/li>\n<li>Adyen checks if a default chargeback logic is configured for your balance platform.\n<ul>\n<li>If yes, we split the chargeback amount according to the default chargeback logic. The chargeback is processed, and the flow ends.<\/li>\n<li>If no, continue to step 6.<\/li>\n<\/ul><\/li>\n<li>Adyen books the full chargeback amount to your platform's liable balance account.<\/li>\n<\/ol>\n<p>The following diagram visualizes the logic explained above:<\/p>\n<p><a rel=\"lightbox\" href=\"\/media\/16ee7f1af90f275f911b9f914194688c25590a698031170fe356a0df9127147e.svg\" src=\"\">\n  <img alt=\"Diagram of how Adyen selects split instructions for a chargeback\" src=\"\/media\/16ee7f1af90f275f911b9f914194688c25590a698031170fe356a0df9127147e.svg\" \/>\n<\/a><\/p>\n<h2>See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/platforms\/automatic-split-configuration\"\n                        target=\"_self\"\n                        >\n                    Split payments automatically\n                <\/a><\/li><li><a href=\"\/platforms\/online-payments\/split-transactions\"\n                        target=\"_self\"\n                        >\n                    Split specific online transactions\n                <\/a><\/li><li><a href=\"\/platforms\/in-person-payments\/split-transactions\"\n                        target=\"_self\"\n                        >\n                    Split specific in-person transactions\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/platforms\/how-adyen-applies-split-instructions","articleFields":{"description":"Learn how Adyen determines which split instructions to apply for payments, captures, refunds, and chargebacks.","feedback_component":true,"parameters":{"directoryPath":"\/platforms","model":"platform"}},"algolia":{"url":"https:\/\/docs.adyen.com\/platforms\/how-adyen-applies-split-instructions","title":"How Adyen applies split instructions","content":"\nThis logic defined on this page is in pilot phase and is not available for all platforms.\n\nWhen you split transactions, you can provide the split instructions in several ways. For example, you can send instructions in a specific request, or link split configuration profiles to your users' stores. For refunds and chargebacks, you can also define a default logic for your balance platform.\nIf you set up instructions in more than one way, then a transaction can have more than one set of instructions that applies to it. To determine which instruction takes precedence, Adyen uses a specific logic. This logic depends on the transaction's type. The following sections explain how Adyen applies split instructions for authorizations, captures, refunds, and chargebacks.\nAuthorizations\nYou can provide split instructions for an authorization in two ways: in the splits array of your authorization request, or through a split configuration profile linked to the store.\nAt authorization, Adyen applies split instructions in the following order:\n\nSplit instructions in the payment request.\nSplit instructions in the split configuration profile, if the payment request does not include split instructions.\n\nCaptures\nYou can provide split instructions for a capture in two ways: in the splits array of your capture or authorization request, or through a split configuration profile linked to the store.\nAt capture, Adyen applies split instructions in the following order:\n\nSplit instructions in the capture request.\nSplit instructions in the original authorisation request, if the capture request does not include split instructions.\nSplit instructions in the split configuration profile, if neither request includes split instructions.\n\nRefunds\nYou can provide split instructions for a refund in three ways:\n\nIn the splits array of your refund request.\nThrough a split configuration profile linked to the store.\nAs a default refund logic configured for your balance platform. Reach out to our Support Team to enable this.\n\nAdyen applies split instructions for a refund in the following order:\n\nYou make a request to initiate a refund.\nAdyen checks if your refund request includes split instructions.\n\nIf yes, we split the refund amount according to the instructions in the request. The refund is processed, and the flow ends.\nIf no, continue to step 3.\n\nAdyen checks if the refund request meets the conditions of a split configuration rule that has defined split refund instructions.\n\nIf yes, we split the refund amount according to the instructions in the profile that was active on the refund's booking date. The refund is processed, and the flow ends.\nIf no, continue to step 4.\n\nAdyen checks if a default refund logic is configured for your balance platform.\n\nIf yes, we split the refund amount according to the default refund logic. The refund is processed, and the flow ends.\n\nIf no, continue to step 5.\n\n\nIf the refund covers the full amount of one full capture, including an overcapture, and the capture includes split data, we use the capture's split ratio. In all other cases, such as for refunds of partial captures, we book the full refund amount to your platform's liable balance account.\n\nThe following diagram visualizes the logic explained above:\n\n  \n\nChargebacks\nYou can provide split instructions for a chargeback in three ways:\n\nAs chargeback logic in a platformChargebackLogic object in your payment or capture request\nThrough a split configuration profile linked to the store.\nAs a default chargeback logic configured for your balance platform. Reach out to our Support Team to enable this.\n\nAdyen applies split instructions for a chargeback in the following order:\n\nYour customer initiates a chargeback.\nAdyen checks if your capture request includes chargeback logic.\n\nIf yes, we split the chargeback amount according to the chargeback logic in the capture request. The chargeback is processed, and the flow ends.\n\nIf no, continue to step 3.\n\n\nAdyen checks if your original payment request includes chargeback logic.\n\nIf yes, we split the chargeback amount according to the chargeback logic in the payment request. The chargeback is processed, and the flow ends.\nIf no, continue to step 4.\n\nAdyen checks if the chargeback meets the conditions of a split configuration rule that has defined split chargeback instructions.\n\nIf yes, we split the chargeback amount according to the instructions in the profile that was active on the chargeback's booking date. The chargeback is processed, and the flow ends.\nIf no, continue to step 5.\n\nAdyen checks if a default chargeback logic is configured for your balance platform.\n\nIf yes, we split the chargeback amount according to the default chargeback logic. The chargeback is processed, and the flow ends.\nIf no, continue to step 6.\n\nAdyen books the full chargeback amount to your platform's liable balance account.\n\nThe following diagram visualizes the logic explained above:\n\n  \n\nSee also\n\n\n                    Split payments automatically\n                \n                    Split specific online transactions\n                \n                    Split specific in-person transactions\n                \n","type":"page","locale":"en","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Platforms","lvl2":"How Adyen applies split instructions"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/platforms","lvl2":"\/platforms\/how-adyen-applies-split-instructions"},"levels":3,"category":"Platforms","category_color":"green","tags":["Adyen","applies","split","instructions"]},"articleFiles":{"chargeback-split-instructions.svg":"<img alt=\"\" src=\"https:\/\/docs.adyen.com\/media\/16ee7f1af90f275f911b9f914194688c25590a698031170fe356a0df9127147e.svg\" \/>","refund-split-instructions.svg":"<img alt=\"\" src=\"https:\/\/docs.adyen.com\/media\/7f2e3a62063eb9c851222c1224e566927c9986038c0376c6e97392c316ad1c36.svg\" \/>"}}