{"title":"Transfer funds internally","category":"default","creationDate":1776961628,"content":"<p>An <strong>internal direct debit<\/strong> moves funds between balance accounts within your balance platform. For example, to collect monthly or subscription fees from your users without triggering strong customer authentication (SCA) or payment fees, you can initiate an internal debit, where your liable balance account sends a debit request to your user's balance account. As a balance platform, you can also initiate internal direct debits between the balance accounts of two different users.<\/p>\n<h2>Before you begin<\/h2>\n<ul>\n<li>Make sure that your server can <a href=\"\/pt\/development-resources\/webhooks\">receive and accept webhooks<\/a>, and that you subscribed to the <strong>Transfer webhooks<\/strong> in your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>.<\/li>\n<li>Ask 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 transfers for the balance account that debits funds.<\/li>\n<li>Make sure that your account holders have the following <a href=\"\/pt\/business-accounts\/verification-overview\/capabilities\">capabilities<\/a>:\n<ul>\n<li>The account holder of the balance account that initiates the direct debit must have the <strong>sendToBalanceAccount<\/strong> capability.<\/li>\n<li>The account holder of the balance account that received the request must have the <strong>receiveFromBalanceAccount<\/strong> capability.<\/li>\n<\/ul><\/li>\n<\/ul>\n<h2>Initiate an internal direct debit<\/h2>\n<p>To initiate an internal direct debit, make a POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers\/latest\/post\/transfers\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/transfers<\/a> request.<\/p>\n<p>In the body of the request, include the following fields:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter<\/th>\n<th style=\"text-align: center;\">Required<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers\/latest\/post\/transfers#request-amount\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">amount<\/a><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">An object containing the currency and value of the transfer.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers\/latest\/post\/transfers#request-balanceAccountId\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balanceAccountId<\/a><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">The unique identifier of the source balance account: the balance account that initiates the direct debit.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers\/latest\/post\/transfers#request-counterparty-balanceAccountId\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">counterparty.balanceAccountId<\/a><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">The unique identifier of the target balance account: the balance account that receives the debit request.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers\/latest\/post\/transfers#request-category\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">category<\/a><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">Set to <strong>internal<\/strong>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers\/latest\/post\/transfers#request-type\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">type<\/a><\/td>\n<td style=\"text-align: center;\"><\/td>\n<td style=\"text-align: left;\">Set to <strong>internalDirectDebit<\/strong> to debit the funds from the counterparty balance account.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers\/latest\/post\/transfers#request-description\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">description<\/a><\/td>\n<td style=\"text-align: center;\"><\/td>\n<td style=\"text-align: left;\">Your description of the transfer. You can use this to identify the transfer in the webhooks that you receive.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers\/latest\/post\/transfers#request-reference\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">reference<\/a><\/td>\n<td style=\"text-align: center;\"><\/td>\n<td style=\"text-align: left;\">Your unique reference for the transfer. You can use this to identify the transfer in the webhooks that you receive.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers\/latest\/post\/transfers#request-referenceForBeneficiary\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">referenceForBeneficiary<\/a><\/td>\n<td style=\"text-align: center;\"><\/td>\n<td style=\"text-align: left;\">Text to inform the recipient about the push or pull transfer. This reference is also included in all webhooks. Supported characters: a-z, A-Z, 0-9.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>The following example shows how to pull <strong>USD&nbsp;25<\/strong> from your user's balance account to your liable balance account.<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Initiate internal direct debit'\" :id=\"'internalDirectDebit-request'\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;curl&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/balanceplatform-api-test.adyen.com\\\/btl\\\/v4\\\/transfers \\\\\\n-H 'x-api-key: ADYEN_BALANCE_PLATFORM_API_KEY' \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-X POST \\\\\\n-d '{\\n   \\&quot;amount\\&quot;: {\\n      \\&quot;currency\\&quot;: \\&quot;USD\\&quot;,\\n      \\&quot;value\\&quot;: 2500\\n   },\\n   \\&quot;balanceAccountId\\&quot;: \\&quot;BA00000000000000000LIABLE\\&quot;,\\n   \\&quot;counterparty\\&quot;: {\\n      \\&quot;balanceAccountId\\&quot;: \\&quot;BA00000000000000000000001\\&quot;\\n   },\\n   \\&quot;category\\&quot; : \\&quot;internal\\&quot;,\\n   \\&quot;type\\&quot;: \\&quot;internalDirectDebit\\&quot;,\\n   \\&quot;referenceForBeneficiary\\&quot;: \\&quot;Your-reference-sent-to-the-counterparty\\&quot;,\\n   \\&quot;description\\&quot;: \\&quot;YOUR_DESCRIPTION_OF_THE_TRANSFER\\&quot;,\\n   \\&quot;reference\\&quot;: \\&quot;YOUR_UNIQUE_REFERENCE_FOR_THE_TRANSFER\\&quot;\\n}'&quot;},{&quot;language&quot;:&quot;java&quot;,&quot;tabTitle&quot;:&quot;Java&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Java API Library v33.0.0\\nimport com.adyen.Client;\\nimport com.adyen.enums.Environment;\\nimport com.adyen.model.transfers.*;\\nimport java.time.OffsetDateTime;\\nimport java.util.*;\\nimport com.adyen.model.RequestOptions;\\nimport com.adyen.service.transfers.*;\\n\\nClient client = new Client(\\&quot;ADYEN_BALANCE_PLATFORM_API_KEY\\&quot;, Environment.TEST);\\n\\n\\\/\\\/ Create the request object(s)\\nAmount amount = new Amount()\\n  .currency(\\&quot;USD\\&quot;)\\n  .value(2500L);\\n\\nCounterpartyInfoV3 counterpartyInfoV3 = new CounterpartyInfoV3()\\n  .balanceAccountId(\\&quot;BA00000000000000000000001\\&quot;);\\n\\nTransferInfo transferInfo = new TransferInfo()\\n  .balanceAccountId(\\&quot;BA00000000000000000LIABLE\\&quot;)\\n  .reference(\\&quot;YOUR_UNIQUE_REFERENCE_FOR_THE_TRANSFER\\&quot;)\\n  .amount(amount)\\n  .referenceForBeneficiary(\\&quot;Your-reference-sent-to-the-counterparty\\&quot;)\\n  .counterparty(counterpartyInfoV3)\\n  .description(\\&quot;YOUR_DESCRIPTION_OF_THE_TRANSFER\\&quot;)\\n  .category(TransferInfo.CategoryEnum.INTERNAL)\\n  .type(TransferInfo.TypeEnum.INTERNALDIRECTDEBIT);\\n\\n\\\/\\\/ Send the request\\nTransfersApi service = new TransfersApi(client);\\nTransfer response = service.transferFunds(transferInfo, new RequestOptions().idempotencyKey(\\&quot;UUID\\&quot;));&quot;},{&quot;language&quot;:&quot;php&quot;,&quot;tabTitle&quot;:&quot;PHP&quot;,&quot;content&quot;:&quot;&lt;?php\\n\\\/\\\/ Adyen PHP API Library v24.0.0\\nuse Adyen\\\\Client;\\nuse Adyen\\\\Environment;\\nuse Adyen\\\\Model\\\\Transfers\\\\Amount;\\nuse Adyen\\\\Model\\\\Transfers\\\\CounterpartyInfoV3;\\nuse Adyen\\\\Model\\\\Transfers\\\\TransferInfo;\\nuse Adyen\\\\Service\\\\Transfers\\\\TransfersApi;\\n\\n$client = new Client();\\n$client-&gt;setXApiKey(\\&quot;ADYEN_BALANCE_PLATFORM_API_KEY\\&quot;);\\n$client-&gt;setEnvironment(Environment::TEST);\\n\\n\\n\\\/\\\/ Create the request object(s)\\n$amount = new Amount();\\n$amount\\n  -&gt;setCurrency(\\&quot;USD\\&quot;)\\n  -&gt;setValue(2500);\\n\\n$counterpartyInfoV3 = new CounterpartyInfoV3();\\n$counterpartyInfoV3\\n  -&gt;setBalanceAccountId(\\&quot;BA00000000000000000000001\\&quot;);\\n\\n$transferInfo = new TransferInfo();\\n$transferInfo\\n  -&gt;setBalanceAccountId(\\&quot;BA00000000000000000LIABLE\\&quot;)\\n  -&gt;setReference(\\&quot;YOUR_UNIQUE_REFERENCE_FOR_THE_TRANSFER\\&quot;)\\n  -&gt;setAmount($amount)\\n  -&gt;setReferenceForBeneficiary(\\&quot;Your-reference-sent-to-the-counterparty\\&quot;)\\n  -&gt;setCounterparty($counterpartyInfoV3)\\n  -&gt;setDescription(\\&quot;YOUR_DESCRIPTION_OF_THE_TRANSFER\\&quot;)\\n  -&gt;setCategory(\\&quot;internal\\&quot;)\\n  -&gt;setType(\\&quot;internalDirectDebit\\&quot;);\\n\\n$requestOptions['idempotencyKey'] = 'UUID';\\n\\n\\\/\\\/ Send the request\\n$service = new TransfersApi($client);\\n$response = $service-&gt;transferFunds($transferInfo, $requestOptions);&quot;},{&quot;language&quot;:&quot;cs&quot;,&quot;tabTitle&quot;:&quot;C#&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen .net API Library v28.0.0\\nusing Adyen;\\nusing Environment = Adyen.Model.Environment;\\nusing Adyen.Model;\\nusing Adyen.Model.Transfers;\\nusing Adyen.Service.Transfers;\\n\\nvar config = new Config()\\n{\\n    XApiKey = \\&quot;ADYEN_BALANCE_PLATFORM_API_KEY\\&quot;,\\n    Environment = Environment.Test\\n};\\nvar client = new Client(config);\\n\\n\\\/\\\/ Create the request object(s)\\nAmount amount = new Amount\\n{\\n  Currency = \\&quot;USD\\&quot;,\\n  Value = 2500\\n};\\n\\nCounterpartyInfoV3 counterpartyInfoV3 = new CounterpartyInfoV3\\n{\\n  BalanceAccountId = \\&quot;BA00000000000000000000001\\&quot;\\n};\\n\\nTransferInfo transferInfo = new TransferInfo\\n{\\n  BalanceAccountId = \\&quot;BA00000000000000000LIABLE\\&quot;,\\n  Reference = \\&quot;YOUR_UNIQUE_REFERENCE_FOR_THE_TRANSFER\\&quot;,\\n  Amount = amount,\\n  ReferenceForBeneficiary = \\&quot;Your-reference-sent-to-the-counterparty\\&quot;,\\n  Counterparty = counterpartyInfoV3,\\n  Description = \\&quot;YOUR_DESCRIPTION_OF_THE_TRANSFER\\&quot;,\\n  Category = TransferInfo.CategoryEnum.Internal,\\n  Type = TransferInfo.TypeEnum.InternalDirectDebit\\n};\\n\\n\\\/\\\/ Send the request\\nvar service = new TransfersService(client);\\nvar response = service.TransferFunds(transferInfo, requestOptions: new RequestOptions { IdempotencyKey = \\&quot;UUID\\&quot;});&quot;},{&quot;language&quot;:&quot;js&quot;,&quot;tabTitle&quot;:&quot;NodeJS (JavaScript)&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Node API Library v23.3.0\\nconst { Client, TransfersAPI } = require('@adyen\\\/api-library');\\n\\nconst client = new Client({ apiKey: \\&quot;ADYEN_BALANCE_PLATFORM_API_KEY\\&quot;, environment: \\&quot;TEST\\&quot; });\\n\\n\\\/\\\/ Create the request object(s)\\nconst transferInfo = {\\n  amount: {\\n    currency: \\&quot;USD\\&quot;,\\n    value: 2500\\n  },\\n  balanceAccountId: \\&quot;BA00000000000000000LIABLE\\&quot;,\\n  counterparty: {\\n    balanceAccountId: \\&quot;BA00000000000000000000001\\&quot;\\n  },\\n  category: \\&quot;internal\\&quot;,\\n  type: \\&quot;internalDirectDebit\\&quot;,\\n  referenceForBeneficiary: \\&quot;Your-reference-sent-to-the-counterparty\\&quot;,\\n  description: \\&quot;YOUR_DESCRIPTION_OF_THE_TRANSFER\\&quot;,\\n  reference: \\&quot;YOUR_UNIQUE_REFERENCE_FOR_THE_TRANSFER\\&quot;\\n}\\n\\n\\\/\\\/ Send the request\\nconst transfersAPI = new TransfersAPI(client);\\nconst response = transfersAPI.TransfersApi.transferFunds(transferInfo, { idempotencyKey: \\&quot;UUID\\&quot; });&quot;},{&quot;language&quot;:&quot;go&quot;,&quot;tabTitle&quot;:&quot;Go&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Go API Library v17.0.0\\nimport (\\n  \\&quot;context\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v17\\\/src\\\/common\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v17\\\/src\\\/adyen\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v17\\\/src\\\/transfers\\&quot;\\n)\\nclient := adyen.NewClient(&amp;common.Config{\\n  ApiKey:      \\&quot;ADYEN_BALANCE_PLATFORM_API_KEY\\&quot;,\\n  Environment: common.TestEnv,\\n})\\n\\n\\\/\\\/ Create the request object(s)\\namount := transfers.Amount{\\n  Currency: \\&quot;USD\\&quot;,\\n  Value: 2500,\\n}\\n\\ncounterpartyInfoV3 := transfers.CounterpartyInfoV3{\\n  BalanceAccountId: common.PtrString(\\&quot;BA00000000000000000000001\\&quot;),\\n}\\n\\ntransferInfo := transfers.TransferInfo{\\n  BalanceAccountId: common.PtrString(\\&quot;BA00000000000000000LIABLE\\&quot;),\\n  Reference: common.PtrString(\\&quot;YOUR_UNIQUE_REFERENCE_FOR_THE_TRANSFER\\&quot;),\\n  Amount: amount,\\n  ReferenceForBeneficiary: common.PtrString(\\&quot;Your-reference-sent-to-the-counterparty\\&quot;),\\n  Counterparty: counterpartyInfoV3,\\n  Description: common.PtrString(\\&quot;YOUR_DESCRIPTION_OF_THE_TRANSFER\\&quot;),\\n  Category: \\&quot;internal\\&quot;,\\n  Type: common.PtrString(\\&quot;internalDirectDebit\\&quot;),\\n}\\n\\n\\\/\\\/ Send the request\\nservice := client.Transfers()\\nreq := service.TransfersApi.TransferFundsInput().IdempotencyKey(\\&quot;UUID\\&quot;).TransferInfo(transferInfo)\\nres, httpRes, err := service.TransfersApi.TransferFunds(context.Background(), req)&quot;},{&quot;language&quot;:&quot;py&quot;,&quot;tabTitle&quot;:&quot;Python&quot;,&quot;content&quot;:&quot;# Adyen Python API Library v13.3.0\\nimport Adyen\\n\\nadyen = Adyen.Adyen()\\nadyen.client.xapikey = \\&quot;ADYEN_BALANCE_PLATFORM_API_KEY\\&quot;\\nadyen.client.platform = \\&quot;test\\&quot; # The environment to use library in.\\n\\n# Create the request object(s)\\njson_request = {\\n  \\&quot;amount\\&quot;: {\\n    \\&quot;currency\\&quot;: \\&quot;USD\\&quot;,\\n    \\&quot;value\\&quot;: 2500\\n  },\\n  \\&quot;balanceAccountId\\&quot;: \\&quot;BA00000000000000000LIABLE\\&quot;,\\n  \\&quot;counterparty\\&quot;: {\\n    \\&quot;balanceAccountId\\&quot;: \\&quot;BA00000000000000000000001\\&quot;\\n  },\\n  \\&quot;category\\&quot;: \\&quot;internal\\&quot;,\\n  \\&quot;type\\&quot;: \\&quot;internalDirectDebit\\&quot;,\\n  \\&quot;referenceForBeneficiary\\&quot;: \\&quot;Your-reference-sent-to-the-counterparty\\&quot;,\\n  \\&quot;description\\&quot;: \\&quot;YOUR_DESCRIPTION_OF_THE_TRANSFER\\&quot;,\\n  \\&quot;reference\\&quot;: \\&quot;YOUR_UNIQUE_REFERENCE_FOR_THE_TRANSFER\\&quot;\\n}\\n\\n# Send the request\\nresult = adyen.transfers.transfers_api.transfer_funds(request=json_request, idempotency_key=\\&quot;UUID\\&quot;)&quot;},{&quot;language&quot;:&quot;rb&quot;,&quot;tabTitle&quot;:&quot;Ruby&quot;,&quot;content&quot;:&quot;# Adyen Ruby API Library v10.1.1\\nrequire \\&quot;adyen-ruby-api-library\\&quot;\\n\\nadyen = Adyen::Client.new\\nadyen.api_key = 'ADYEN_BALANCE_PLATFORM_API_KEY'\\nadyen.env = :test # Set to \\&quot;live\\&quot; for live environment\\n\\n# Create the request object(s)\\nrequest_body = {\\n  :amount =&gt; {\\n    :currency =&gt; 'USD',\\n    :value =&gt; 2500\\n  },\\n  :balanceAccountId =&gt; 'BA00000000000000000LIABLE',\\n  :counterparty =&gt; {\\n    :balanceAccountId =&gt; 'BA00000000000000000000001'\\n  },\\n  :category =&gt; 'internal',\\n  :type =&gt; 'internalDirectDebit',\\n  :referenceForBeneficiary =&gt; 'Your-reference-sent-to-the-counterparty',\\n  :description =&gt; 'YOUR_DESCRIPTION_OF_THE_TRANSFER',\\n  :reference =&gt; 'YOUR_UNIQUE_REFERENCE_FOR_THE_TRANSFER'\\n}\\n\\n# Send the request\\nresult = adyen.transfers.transfers_api.transfer_funds(request_body, headers: { 'Idempotency-Key' =&gt; 'UUID' })&quot;},{&quot;language&quot;:&quot;ts&quot;,&quot;tabTitle&quot;:&quot;NodeJS (TypeScript)&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Node API Library v23.3.0\\nimport { Client, TransfersAPI, Types } from \\&quot;@adyen\\\/api-library\\&quot;;\\n\\nconst client = new Client({ apiKey: \\&quot;ADYEN_BALANCE_PLATFORM_API_KEY\\&quot;, environment: \\&quot;TEST\\&quot; });\\n\\n\\\/\\\/ Create the request object(s)\\nconst amount: Types.transfers.Amount = {\\n  currency: \\&quot;USD\\&quot;,\\n  value: 2500\\n};\\n\\nconst counterpartyInfoV3: Types.transfers.CounterpartyInfoV3 = {\\n  balanceAccountId: \\&quot;BA00000000000000000000001\\&quot;\\n};\\n\\nconst transferInfo: Types.transfers.TransferInfo = {\\n  balanceAccountId: \\&quot;BA00000000000000000LIABLE\\&quot;,\\n  reference: \\&quot;YOUR_UNIQUE_REFERENCE_FOR_THE_TRANSFER\\&quot;,\\n  amount: amount,\\n  referenceForBeneficiary: \\&quot;Your-reference-sent-to-the-counterparty\\&quot;,\\n  counterparty: counterpartyInfoV3,\\n  description: \\&quot;YOUR_DESCRIPTION_OF_THE_TRANSFER\\&quot;,\\n  category: Types.transfers.TransferInfo.CategoryEnum.Internal,\\n  type: Types.transfers.TransferInfo.TypeEnum.InternalDirectDebit\\n};\\n\\n\\\/\\\/ Send the request\\nconst transfersAPI = new TransfersAPI(client);\\nconst response = transfersAPI.TransfersApi.transferFunds(transferInfo, { idempotencyKey: \\&quot;UUID\\&quot; });&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<p>In the response, note the following:<\/p>\n<ul>\n<li><code>id<\/code>: the unique ID of the transfer.<\/li>\n<li><code>status<\/code>: the result of the transfer.<\/li>\n<li><code>reason<\/code>: an explanation of the status. Check this field if the status is not <strong>authorised<\/strong>.<br \/>\nFor example, the reason for a <strong>refused<\/strong> status can be <strong>notEnoughBalance<\/strong>.<\/li>\n<\/ul>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Internal direct debit initiated'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n  \\\"creationDate\\\": \\\"2024-08-08T13:52:08+02:00\\\",\\n  \\\"id\\\": \\\"48NJIB9TWQJ6L7U7\\\",\\n  \\\"accountHolder\\\": {\\n    \\\"description\\\": \\\"Your description for your liable account holder\\\",\\n    \\\"id\\\": \\\"AH00000000000000000LIABLE\\\",\\n    \\\"reference\\\": \\\"Your reference for your liable account holder\\\"\\n  },\\n  \\\"amount\\\": {\\n    \\\"currency\\\": \\\"USD\\\",\\n    \\\"value\\\": 2500\\n  },\\n  \\\"balanceAccount\\\": {\\n    \\\"description\\\": \\\"Your description for your liable balance account\\\",\\n    \\\"id\\\": \\\"BA00000000000000000LIABLE\\\",\\n    \\\"reference\\\": \\\"Your reference for your liable balance account\\\"\\n  },\\n  \\\"category\\\" : \\\"internal\\\",\\n  \\\"categoryData\\\": {\\n    \\\"type\\\": \\\"internalDirectDebit\\\"\\n  },\\n  \\\"counterparty\\\": {\\n    \\\"balanceAccountId\\\": \\\"BA00000000000000000000001\\\"\\n  },\\n  \\\"description\\\": \\\"YOUR_DESCRIPTION_OF_THE_TRANSFER\\\",\\n  \\\"direction\\\": \\\"outgoing\\\",\\n  \\\"reason\\\": \\\"approved\\\",\\n  \\\"reference\\\": \\\"YOUR_UNIQUE_REFERENCE_FOR_THE_TRANSFER\\\",\\n  \\\"referenceForBeneficiary\\\": \\\"Your-reference-sent-to-the-counterparty\\\",\\n  \\\"status\\\": \\\"authorised\\\",\\n  \\\"type\\\": \\\"internalDirectDebit\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<h2 id=\"get-status-updates\">Get status updates<\/h2>\n<p>For every internal transfer request, Adyen sends multiple webhooks to your server: a series of webhooks for the balance account where the transfer is an outgoing request, and a series of webhooks for the balance account where the transfer is an incoming request.<\/p>\n<p>Using these webhooks, you can track the status of the transfer: <strong>received<\/strong>, then <strong>authorised<\/strong>, and finally <strong>booked<\/strong>. The webhooks also inform you if the transfer failed.<\/p>\n<p>You can also <a href=\"\/pt\/business-accounts\/view-transfers-details\">view the transfer details in your Customer Area<\/a>. Each transfer of funds between balance accounts appears in the Customer Area as two transfer entries: one for the balance account that is credited, and one for the balance account that is debited.<\/p>\n<p>When you initiate an internal direct debit is triggered between balance accounts in your balance platform, Adyen sends two kinds of webhooks:<\/p>\n<ul>\n<li> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfer-webhooks\/latest\/post\/balancePlatform.transfer.created\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balancePlatform.transfer.created<\/a>, that informs your server that funds will be transferred between the balance accounts.<\/li>\n<li> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfer-webhooks\/latest\/post\/balancePlatform.transfer.updated\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balancePlatform.transfer.updated<\/a>, that informs your server of changes in the status of the fund transfer.<\/li>\n<\/ul>\n<p>For each event you receive two sets of webhooks:<\/p>\n<ul>\n<li>Webhooks for the source balance account, where you initiate the direct debit an outgoing request.<\/li>\n<li>Webhooks for the target balance account, that received the direct debit as an incoming request.<\/li>\n<\/ul>\n<p>You can identify transfer webhooks triggered by internal direct debit requests by the following values:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<th style=\"text-align: left;\">Value<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfer-webhooks\/latest\/post\/balancePlatform.transfer.created#request-data-category\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">category<\/a><\/td>\n<td style=\"text-align: left;\">The category of the transfer.<\/td>\n<td style=\"text-align: left;\"><strong>internal<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfer-webhooks\/latest\/post\/balancePlatform.transfer.created#request-data-direction\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">direction<\/a><\/td>\n<td style=\"text-align: left;\">The direction of the transfer request.<\/td>\n<td style=\"text-align: left;\"><strong>outgoing<\/strong> for the source balance account <br> <strong>incoming<\/strong> for the target balance account<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfer-webhooks\/latest\/post\/balancePlatform.transfer.created#request-data-type\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">type<\/a><\/td>\n<td style=\"text-align: left;\">The type of internal transfer.<\/td>\n<td style=\"text-align: left;\"><strong>internalDirectDebit<\/strong><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>For an internal direct debit, you receive webhooks for the following events:<\/p>\n<ul>\n<li>The transfer is <a href=\"#internal-direct-debit-initiated\">initiated<\/a>.<\/li>\n<li>The transfer is <a href=\"#internal-direct-debit-authorized\">authorized<\/a>. This indicates that the funds are reserved.<\/li>\n<li>The transfer is <a href=\"#internal-direct-debit-booked\">booked<\/a>.<\/li>\n<\/ul>\n<p>Expand the sections below to see the webhooks you would receive for the <a href=\"#initiate-an-internal-direct-debit\">example direct debit request above<\/a>.<\/p>\n<div class=\"accordion-shortcode adl-accordion adl-accordion--max-height-transition\" data-expand=\"true\" data-ignore=\"anchorjs-link\">\n    \n    <div class=\"adl-accordion__item\" style=\"border: none !important;\">\n        <div tabindex=\"0\" role=\"item\" aria-expanded=\"false\" class=\"adl-accordion__header\">\n            <i class=\"adl-accordion__toggle adl-icon-chevron-down\"><\/i>\n            <div class=\"adl-accordion__title-wrapper\" data-accordion=\"#1-internal-direct-debit-initiated\">\n                                    <h4 class=\"adl-accordion__title\">1. Internal direct debit initiated<\/h4>\n                            <\/div>\n        <\/div>\n        <div role=\"region\" class=\"adl-accordion__content\">\n            \n<p>When you initiate an internal direct debit, we send you a  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfer-webhooks\/latest\/post\/balancePlatform.transfer.created\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balancePlatform.transfer.created<\/a> webhook with <code>status<\/code> <strong>received<\/strong>, to inform your server that funds will be transferred between balance accounts in your balance platform.<\/p>\n\n<div id=\"tabQkfia\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Source balance account&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;For the source balance account, the webhook indicates that funds will be credited to that account:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;code&gt;direction&lt;\\\/code&gt;: &lt;strong&gt;outgoing&lt;\\\/strong&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;balances.received&lt;\\\/code&gt;: a positive amount&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Outgoing transfer request received&#039;\\&quot; :id=\\&quot;&#039;received-debit-outgoing&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n   \\\\\\&quot;data\\\\\\&quot;: {\\\\n      \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;4VXNYX62NIZEZH8S\\\\\\&quot;,\\\\n      \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;internalDirectDebit\\\\\\&quot;,\\\\n      \\\\\\&quot;accountHolder\\\\\\&quot;: {\\\\n         \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;Your description of your liable account holder\\\\\\&quot;,\\\\n         \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;AH00000000000000000LIABLE\\\\\\&quot;,\\\\n         \\\\\\&quot;reference\\\\\\&quot;: \\\\\\&quot;Your reference your liable account holder\\\\\\&quot;\\\\n      },\\\\n      \\\\\\&quot;amount\\\\\\&quot;: {\\\\n         \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;USD\\\\\\&quot;,\\\\n         \\\\\\&quot;value\\\\\\&quot;: 2500\\\\n      },\\\\n      \\\\\\&quot;balanceAccount\\\\\\&quot;: {\\\\n         \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;Your description of your liable balance account\\\\\\&quot;,\\\\n         \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;BA00000000000000000LIABLE\\\\\\&quot;\\\\n      },\\\\n      \\\\\\&quot;balances\\\\\\&quot;: [\\\\n         {\\\\n            \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;USD\\\\\\&quot;,\\\\n            \\\\\\&quot;received\\\\\\&quot;: 2500\\\\n         }\\\\n      ],\\\\n      \\\\\\&quot;balancePlatform\\\\\\&quot;: \\\\\\&quot;YOUR_BALANCE_PLATFORM\\\\\\&quot;,\\\\n      \\\\\\&quot;category\\\\\\&quot;: \\\\\\&quot;internal\\\\\\&quot;,\\\\n      \\\\\\&quot;counterparty\\\\\\&quot;: {\\\\n        \\\\\\&quot;balanceAccountId\\\\\\&quot;: \\\\\\&quot;BA00000000000000000000001\\\\\\&quot;\\\\n      },\\\\n      \\\\\\&quot;creationDate\\\\\\&quot;: \\\\\\&quot;2024-08-28T13:30:05+02:00\\\\\\&quot;,\\\\n      \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;Your description of the transfer\\\\\\&quot;,\\\\n      \\\\\\&quot;direction\\\\\\&quot;: \\\\\\&quot;outgoing\\\\\\&quot;,\\\\n      \\\\\\&quot;events\\\\\\&quot;: [\\\\n         {\\\\n            \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;MOCJ00000000000000000000000001\\\\\\&quot;,\\\\n            \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;accounting\\\\\\&quot;,\\\\n            \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;received\\\\\\&quot;,\\\\n            \\\\\\&quot;mutations\\\\\\&quot;: [\\\\n               {\\\\n                  \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;USD\\\\\\&quot;,\\\\n                  \\\\\\&quot;received\\\\\\&quot;: 2500\\\\n               }\\\\n            ],\\\\n            \\\\\\&quot;bookingDate\\\\\\&quot;: \\\\\\&quot;2024-08-28T13:30:18+02:00\\\\\\&quot;\\\\n         }\\\\n      ],\\\\n      \\\\\\&quot;reason\\\\\\&quot;: \\\\\\&quot;approved\\\\\\&quot;,\\\\n      \\\\\\&quot;reference\\\\\\&quot;: \\\\\\&quot;Your reference for the transfer\\\\\\&quot;,\\\\n      \\\\\\&quot;referenceForBeneficiary\\\\\\&quot;: \\\\\\&quot;Your-reference-for-the-recipient-of-the-transfer-request\\\\\\&quot;,\\\\n      \\\\\\&quot;sequenceNumber\\\\\\&quot;: 1,\\\\n      \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;received\\\\\\&quot;\\\\n   },\\\\n   \\\\\\&quot;environment\\\\\\&quot;: \\\\\\&quot;test\\\\\\&quot;,\\\\n   \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;balancePlatform.transfer.created\\\\\\&quot;\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:&quot;received-debit-source&quot;,&quot;oldTabId&quot;:&quot;received-debit-source_1&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Target balance account&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;For the target balance account, the webhook indicates that funds will be debited from that account:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;code&gt;direction&lt;\\\/code&gt;: &lt;strong&gt;incoming&lt;\\\/strong&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;balances.received&lt;\\\/code&gt;: a negative amount&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Incoming transfer request received&#039;\\&quot; :id=\\&quot;&#039;received-debit-incoming&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n   \\\\\\&quot;data\\\\\\&quot;: {\\\\n      \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;3K6U5F62NIZJSIVI\\\\\\&quot;,\\\\n      \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;internalDirectDebit\\\\\\&quot;,\\\\n      \\\\\\&quot;accountHolder\\\\\\&quot;: {\\\\n         \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;Your description for the account holder of the target balance account\\\\\\&quot;,\\\\n         \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;AH00000000000000000000002\\\\\\&quot;,\\\\n         \\\\\\&quot;reference\\\\\\&quot;: \\\\\\&quot;Your reference for the account holder\\\\\\&quot;\\\\n      },\\\\n      \\\\\\&quot;amount\\\\\\&quot;: {\\\\n         \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;USD\\\\\\&quot;,\\\\n         \\\\\\&quot;value\\\\\\&quot;: 2500\\\\n      },\\\\n      \\\\\\&quot;balanceAccount\\\\\\&quot;: {\\\\n         \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;Your description for the target balance account\\\\\\&quot;,\\\\n         \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;BA00000000000000000000001\\\\\\&quot;\\\\n      },\\\\n      \\\\\\&quot;balances\\\\\\&quot;: [\\\\n         {\\\\n            \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;USD\\\\\\&quot;,\\\\n            \\\\\\&quot;received\\\\\\&quot;: -2500\\\\n         }\\\\n      ],\\\\n      \\\\\\&quot;balancePlatform\\\\\\&quot;: \\\\\\&quot;YOUR_BALANCE_PLATFORM\\\\\\&quot;,\\\\n      \\\\\\&quot;category\\\\\\&quot;: \\\\\\&quot;internal\\\\\\&quot;,\\\\n      \\\\\\&quot;counterparty\\\\\\&quot;: {\\\\n        \\\\\\&quot;balanceAccountId\\\\\\&quot;: \\\\\\&quot;BA00000000000000000LIABLE\\\\\\&quot;\\\\n      },\\\\n      \\\\\\&quot;creationDate\\\\\\&quot;: \\\\\\&quot;2024-08-28T13:30:05+02:00\\\\\\&quot;,\\\\n      \\\\\\&quot;direction\\\\\\&quot;: \\\\\\&quot;incoming\\\\\\&quot;,\\\\n      \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;Your description of the transfer\\\\\\&quot;,\\\\n      \\\\\\&quot;events\\\\\\&quot;: [\\\\n         {\\\\n            \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;KESG00000000000000000000000001\\\\\\&quot;,\\\\n            \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;accounting\\\\\\&quot;,\\\\n            \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;received\\\\\\&quot;,\\\\n            \\\\\\&quot;mutations\\\\\\&quot;: [\\\\n               {\\\\n                  \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;USD\\\\\\&quot;,\\\\n                  \\\\\\&quot;received\\\\\\&quot;: -2500\\\\n               }\\\\n            ],\\\\n            \\\\\\&quot;bookingDate\\\\\\&quot;: \\\\\\&quot;2024-08-28T13:30:18+02:00\\\\\\&quot;\\\\n         }\\\\n      ],\\\\n      \\\\\\&quot;reason\\\\\\&quot;: \\\\\\&quot;approved\\\\\\&quot;,\\\\n      \\\\\\&quot;reference\\\\\\&quot;: \\\\\\&quot;Your reference for the transfer\\\\\\&quot;,\\\\n      \\\\\\&quot;referenceForBeneficiary\\\\\\&quot;: \\\\\\&quot;Your-reference-for-the-recipient-of-the-transfer-request\\\\\\&quot;,\\\\n      \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;received\\\\\\&quot;,\\\\n      \\\\\\&quot;sequenceNumber\\\\\\&quot;: 1\\\\n   },\\\\n   \\\\\\&quot;environment\\\\\\&quot;: \\\\\\&quot;test\\\\\\&quot;,\\\\n   \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;balancePlatform.transfer.created\\\\\\&quot;\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:&quot;received-debit-target&quot;,&quot;oldTabId&quot;:&quot;received-debit-target_2&quot;,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n\n        <\/div>\n    <\/div>\n<\/div>\n\n<div class=\"accordion-shortcode adl-accordion adl-accordion--max-height-transition\" data-expand=\"true\" data-ignore=\"anchorjs-link\">\n    \n    <div class=\"adl-accordion__item\" style=\"border: none !important;\">\n        <div tabindex=\"0\" role=\"item\" aria-expanded=\"false\" class=\"adl-accordion__header\">\n            <i class=\"adl-accordion__toggle adl-icon-chevron-down\"><\/i>\n            <div class=\"adl-accordion__title-wrapper\" data-accordion=\"#2-internal-direct-debit-authorized\">\n                                    <h4 class=\"adl-accordion__title\">2. Internal direct debit authorized<\/h4>\n                            <\/div>\n        <\/div>\n        <div role=\"region\" class=\"adl-accordion__content\">\n            \n<p>When the scheduled or on-demand internal pull transfer is authorized, Adyen sends  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfer-webhooks\/latest\/post\/balancePlatform.transfer.updated\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balancePlatform.transfer.updated<\/a> webhooks with <code>status<\/code> <strong>authorised<\/strong>, to inform your server that the funds have been reserved on the source and target balance accounts.<\/p>\n\n<div id=\"tabHfW53\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Source balance account&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;For the source balance account, the webhook indicates that the transfer amount has been reserved to be credited:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;code&gt;direction&lt;\\\/code&gt;: &lt;strong&gt;outgoing&lt;\\\/strong&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;balances.reserved&lt;\\\/code&gt;: a positive amount&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Outgoing transfer authorized&#039;\\&quot; :id=\\&quot;&#039;authorised-debit-outgoing&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n   \\\\\\&quot;data\\\\\\&quot;: {\\\\n      \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;4VXNYX62NIZEZH8S\\\\\\&quot;,\\\\n      \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;internalDirectDebit\\\\\\&quot;,\\\\n      \\\\\\&quot;accountHolder\\\\\\&quot;: {\\\\n         \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;Your description for your liable account holder\\\\\\&quot;,\\\\n         \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;AH00000000000000000LIABLE\\\\\\&quot;,\\\\n         \\\\\\&quot;reference\\\\\\&quot;: \\\\\\&quot;Your reference for the account holder\\\\\\&quot;\\\\n      },\\\\n      \\\\\\&quot;amount\\\\\\&quot;: {\\\\n         \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;USD\\\\\\&quot;,\\\\n         \\\\\\&quot;value\\\\\\&quot;: 2500\\\\n      },\\\\n      \\\\\\&quot;balanceAccount\\\\\\&quot;: {\\\\n         \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;Your description for your liable balance account\\\\\\&quot;,\\\\n         \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;BA00000000000000000LIABLE\\\\\\&quot;\\\\n      },\\\\n      \\\\\\&quot;balancePlatform\\\\\\&quot;: \\\\\\&quot;YOUR_BALANCE_PLATFORM\\\\\\&quot;,\\\\n      \\\\\\&quot;balances\\\\\\&quot;: [\\\\n         {\\\\n            \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;USD\\\\\\&quot;,\\\\n            \\\\\\&quot;received\\\\\\&quot;: 0,\\\\n            \\\\\\&quot;reserved\\\\\\&quot;: 2500\\\\n         }\\\\n      ],\\\\n      \\\\\\&quot;category\\\\\\&quot;: \\\\\\&quot;internal\\\\\\&quot;,\\\\n      \\\\\\&quot;counterparty\\\\\\&quot;: {\\\\n        \\\\\\&quot;balanceAccountId\\\\\\&quot;: \\\\\\&quot;BA00000000000000000000001\\\\\\&quot;\\\\n      },\\\\n      \\\\\\&quot;creationDate\\\\\\&quot;: \\\\\\&quot;2024-08-28T13:30:05+02:00\\\\\\&quot;,\\\\n      \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;Your description of the transfer\\\\\\&quot;,\\\\n      \\\\\\&quot;direction\\\\\\&quot;: \\\\\\&quot;outgoing\\\\\\&quot;,\\\\n      \\\\\\&quot;events\\\\\\&quot;: [\\\\n         {\\\\n            \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;MOCJ00000000000000000000000001\\\\\\&quot;,\\\\n            \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;accounting\\\\\\&quot;,\\\\n            \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;received\\\\\\&quot;,\\\\n            \\\\\\&quot;mutations\\\\\\&quot;: [\\\\n               {\\\\n                  \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;USD\\\\\\&quot;,\\\\n                  \\\\\\&quot;received\\\\\\&quot;: 2500\\\\n               }\\\\n            ],\\\\n            \\\\\\&quot;bookingDate\\\\\\&quot;: \\\\\\&quot;2024-08-28T13:30:18+02:00\\\\\\&quot;\\\\n         },\\\\n         {\\\\n            \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;MOCJ00000000000000000000000002\\\\\\&quot;,\\\\n            \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;accounting\\\\\\&quot;,\\\\n            \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;authorised\\\\\\&quot;,\\\\n            \\\\\\&quot;mutations\\\\\\&quot;: [\\\\n               {\\\\n                  \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;USD\\\\\\&quot;,\\\\n                  \\\\\\&quot;received\\\\\\&quot;: -2500,\\\\n                  \\\\\\&quot;reserved\\\\\\&quot;: 2500,\\\\n               }\\\\n            ],\\\\n            \\\\\\&quot;bookingDate\\\\\\&quot;: \\\\\\&quot;2024-08-28T13:30:18+02:00\\\\\\&quot;\\\\n         }\\\\n      ],\\\\n      \\\\\\&quot;reason\\\\\\&quot;: \\\\\\&quot;approved\\\\\\&quot;,\\\\n      \\\\\\&quot;reference\\\\\\&quot;: \\\\\\&quot;Your reference for the transfer\\\\\\&quot;,\\\\n      \\\\\\&quot;referenceForBeneficiary\\\\\\&quot;: \\\\\\&quot;Your-reference-for-the-recipient-of-the-transfer-request\\\\\\&quot;,\\\\n      \\\\\\&quot;sequenceNumber\\\\\\&quot;: 2,\\\\n      \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;authorised\\\\\\&quot;\\\\n   },\\\\n   \\\\\\&quot;environment\\\\\\&quot;: \\\\\\&quot;test\\\\\\&quot;,\\\\n   \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;balancePlatform.transfer.updated\\\\\\&quot;\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:&quot;authorised-debit-source&quot;,&quot;oldTabId&quot;:&quot;authorised-debit-source_1&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Target balance account&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;For the target balance account, the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/transfer-webhooks\\\/latest\\\/post\\\/balancePlatform.transfer.updated\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;balancePlatform.transfer.updated&lt;\\\/a&gt; webhook indicates that the transfer amount has been reserved to be debited:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;code&gt;direction&lt;\\\/code&gt;: &lt;strong&gt;incoming&lt;\\\/strong&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;balances.reserved&lt;\\\/code&gt;: a negative amount&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Incoming transfer authorized&#039;\\&quot; :id=\\&quot;&#039;authorised-debit-incoming&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n   \\\\\\&quot;data\\\\\\&quot;: {\\\\n      \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;3K6U5F62NIZJSIVI\\\\\\&quot;,\\\\n      \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;internalDirectDebit\\\\\\&quot;,\\\\n      \\\\\\&quot;accountHolder\\\\\\&quot;: {\\\\n         \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;Your description for the account holder of the target balance account\\\\\\&quot;,\\\\n         \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;AH00000000000000000000002\\\\\\&quot;,\\\\n         \\\\\\&quot;reference\\\\\\&quot;: \\\\\\&quot;Your reference for the account holder\\\\\\&quot;\\\\n      },\\\\n      \\\\\\&quot;amount\\\\\\&quot;: {\\\\n         \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;USD\\\\\\&quot;,\\\\n         \\\\\\&quot;value\\\\\\&quot;: 2500\\\\n      },\\\\n      \\\\\\&quot;balanceAccount\\\\\\&quot;: {\\\\n         \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;Your description for the target balance account\\\\\\&quot;,\\\\n         \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;BA00000000000000000000001\\\\\\&quot;\\\\n      },\\\\n      \\\\\\&quot;balanceAccountId\\\\\\&quot;: \\\\\\&quot;BA00000000000000000000001\\\\\\&quot;,\\\\n      \\\\\\&quot;balancePlatform\\\\\\&quot;: \\\\\\&quot;YOUR_BALANCE_PLATFORM\\\\\\&quot;,\\\\n      \\\\\\&quot;balances\\\\\\&quot;: [\\\\n         {\\\\n            \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;USD\\\\\\&quot;,\\\\n            \\\\\\&quot;received\\\\\\&quot;: 0,\\\\n            \\\\\\&quot;reserved\\\\\\&quot;: -2500\\\\n         }\\\\n      ],\\\\n      \\\\\\&quot;category\\\\\\&quot;: \\\\\\&quot;internal\\\\\\&quot;,\\\\n      \\\\\\&quot;counterparty\\\\\\&quot;: {\\\\n        \\\\\\&quot;balanceAccountId\\\\\\&quot;: \\\\\\&quot;BA00000000000000000LIABLE\\\\\\&quot;\\\\n      },\\\\n      \\\\\\&quot;creationDate\\\\\\&quot;: \\\\\\&quot;2024-08-28T13:30:05+02:00\\\\\\&quot;,\\\\n      \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;Your description of the transfer\\\\\\&quot;,\\\\n      \\\\\\&quot;direction\\\\\\&quot;: \\\\\\&quot;incoming\\\\\\&quot;,\\\\n      \\\\\\&quot;events\\\\\\&quot;: [\\\\n         {\\\\n            \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;KESG00000000000000000000000001\\\\\\&quot;,\\\\n            \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;accounting\\\\\\&quot;,\\\\n            \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;received\\\\\\&quot;,\\\\n            \\\\\\&quot;mutations\\\\\\&quot;: [\\\\n               {\\\\n                  \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;USD\\\\\\&quot;,\\\\n                  \\\\\\&quot;received\\\\\\&quot;: -2500\\\\n               }\\\\n            ],\\\\n            \\\\\\&quot;bookingDate\\\\\\&quot;: \\\\\\&quot;2024-08-28T13:30:18+02:00\\\\\\&quot;\\\\n         },\\\\n         {\\\\n            \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;KESG00000000000000000000000002\\\\\\&quot;,\\\\n            \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;accounting\\\\\\&quot;,\\\\n            \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;authorised\\\\\\&quot;,\\\\n            \\\\\\&quot;mutations\\\\\\&quot;: [\\\\n               {\\\\n                  \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;USD\\\\\\&quot;,\\\\n                  \\\\\\&quot;received\\\\\\&quot;: 2500,\\\\n                  \\\\\\&quot;reserved\\\\\\&quot;: -2500\\\\n               }\\\\n            ],\\\\n            \\\\\\&quot;bookingDate\\\\\\&quot;: \\\\\\&quot;2024-08-28T13:30:18+02:00\\\\\\&quot;\\\\n         }\\\\n      ],\\\\n      \\\\\\&quot;reason\\\\\\&quot;: \\\\\\&quot;approved\\\\\\&quot;,\\\\n      \\\\\\&quot;reference\\\\\\&quot;: \\\\\\&quot;Your reference for the transfer\\\\\\&quot;,\\\\n      \\\\\\&quot;referenceForBeneficiary\\\\\\&quot;: \\\\\\&quot;Your-reference-for-the-recipient-of-the-transfer-request\\\\\\&quot;,\\\\n      \\\\\\&quot;sequenceNumber\\\\\\&quot;: 2,\\\\n      \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;authorised\\\\\\&quot;\\\\n   },\\\\n   \\\\\\&quot;environment\\\\\\&quot;: \\\\\\&quot;test\\\\\\&quot;,\\\\n   \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;balancePlatform.transfer.updated\\\\\\&quot;\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:&quot;authorised-debit-target&quot;,&quot;oldTabId&quot;:&quot;authorised-debit-target_2&quot;,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n\n        <\/div>\n    <\/div>\n<\/div>\n\n<div class=\"accordion-shortcode adl-accordion adl-accordion--max-height-transition\" data-expand=\"true\" data-ignore=\"anchorjs-link\">\n    \n    <div class=\"adl-accordion__item\" style=\"border: none !important;\">\n        <div tabindex=\"0\" role=\"item\" aria-expanded=\"false\" class=\"adl-accordion__header\">\n            <i class=\"adl-accordion__toggle adl-icon-chevron-down\"><\/i>\n            <div class=\"adl-accordion__title-wrapper\" data-accordion=\"#3-internal-direct-debit-booked\">\n                                    <h4 class=\"adl-accordion__title\">3. Internal direct debit booked<\/h4>\n                            <\/div>\n        <\/div>\n        <div role=\"region\" class=\"adl-accordion__content\">\n            \n<p>When the scheduled or on-demand internal pull transfer is booked, Adyen sends  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfer-webhooks\/latest\/post\/balancePlatform.transfer.updated\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balancePlatform.transfer.updated<\/a> webhooks with <code>status<\/code> <strong>booked<\/strong>, to inform your server that the funds have been pulled from the target balance account to the source balance account.<\/p>\n\n<div id=\"tabuczqb\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Source balance account&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;For the source balance account, the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/transfer-webhooks\\\/latest\\\/post\\\/balancePlatform.transfer.updated\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;balancePlatform.transfer.updated&lt;\\\/a&gt; webhook indicates that the transfer amount has been credited:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;code&gt;direction&lt;\\\/code&gt;: &lt;strong&gt;outgoing&lt;\\\/strong&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;balances.balance&lt;\\\/code&gt;: a positive amount&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Outgoing transfer booked&#039;\\&quot; :id=\\&quot;&#039;booked-debit-outgoing&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n   \\\\\\&quot;data\\\\\\&quot;: {\\\\n      \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;4VXNYX62NIZEZH8S\\\\\\&quot;,\\\\n      \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;internalDirectDebit\\\\\\&quot;,\\\\n      \\\\\\&quot;accountHolder\\\\\\&quot;: {\\\\n         \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;Your description for your liable account holder\\\\\\&quot;,\\\\n         \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;AH00000000000000000LIABLE\\\\\\&quot;,\\\\n         \\\\\\&quot;reference\\\\\\&quot;: \\\\\\&quot;Your reference for your liable account holder\\\\\\&quot;\\\\n      },\\\\n      \\\\\\&quot;amount\\\\\\&quot;: {\\\\n         \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;USD\\\\\\&quot;,\\\\n         \\\\\\&quot;value\\\\\\&quot;: 2500\\\\n      },\\\\n      \\\\\\&quot;balanceAccount\\\\\\&quot;: {\\\\n         \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;Your description for your liable balance account\\\\\\&quot;,\\\\n         \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;BA00000000000000000LIABLE\\\\\\&quot;\\\\n      },\\\\n      \\\\\\&quot;balancePlatform\\\\\\&quot;: \\\\\\&quot;YOUR_BALANCE_PLATFORM\\\\\\&quot;,\\\\n      \\\\\\&quot;balances\\\\\\&quot;: [\\\\n         {\\\\n            \\\\\\&quot;balance\\\\\\&quot;: 2500,\\\\n            \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;USD\\\\\\&quot;,\\\\n            \\\\\\&quot;received\\\\\\&quot;: 0,\\\\n            \\\\\\&quot;reserved\\\\\\&quot;: 0\\\\n         }\\\\n      ],\\\\n      \\\\\\&quot;category\\\\\\&quot;: \\\\\\&quot;internal\\\\\\&quot;,\\\\n      \\\\\\&quot;counterparty\\\\\\&quot;: {\\\\n         \\\\\\&quot;balanceAccountId\\\\\\&quot;: \\\\\\&quot;BA00000000000000000000001\\\\\\&quot;\\\\n      },\\\\n      \\\\\\&quot;creationDate\\\\\\&quot;: \\\\\\&quot;2024-08-28T13:30:05+02:00\\\\\\&quot;,\\\\n      \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;Your description of the transfer\\\\\\&quot;,\\\\n      \\\\\\&quot;direction\\\\\\&quot;: \\\\\\&quot;outgoing\\\\\\&quot;,\\\\n      \\\\\\&quot;events\\\\\\&quot;: [\\\\n         {\\\\n            \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;MOCJ00000000000000000000000001\\\\\\&quot;,\\\\n            \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;accounting\\\\\\&quot;,\\\\n            \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;received\\\\\\&quot;,\\\\n            \\\\\\&quot;mutations\\\\\\&quot;: [\\\\n               {\\\\n                  \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;USD\\\\\\&quot;,\\\\n                  \\\\\\&quot;received\\\\\\&quot;: 2500\\\\n               }\\\\n            ],\\\\n            \\\\\\&quot;bookingDate\\\\\\&quot;: \\\\\\&quot;2024-08-28T13:30:18+02:00\\\\\\&quot;\\\\n         },\\\\n         {\\\\n            \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;MOCJ00000000000000000000000002\\\\\\&quot;,\\\\n            \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;accounting\\\\\\&quot;,\\\\n            \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;authorised\\\\\\&quot;,\\\\n            \\\\\\&quot;mutations\\\\\\&quot;: [\\\\n               {\\\\n                  \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;USD\\\\\\&quot;,\\\\n                  \\\\\\&quot;received\\\\\\&quot;: -2500,\\\\n                  \\\\\\&quot;reserved\\\\\\&quot;: 2500,\\\\n               }\\\\n            ],\\\\n            \\\\\\&quot;bookingDate\\\\\\&quot;: \\\\\\&quot;2024-08-28T13:30:18+02:00\\\\\\&quot;\\\\n         },\\\\n         {\\\\n            \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;MOCJ00000000000000000000000003\\\\\\&quot;,\\\\n            \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;accounting\\\\\\&quot;,\\\\n            \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;booked\\\\\\&quot;,\\\\n            \\\\\\&quot;mutations\\\\\\&quot;: [\\\\n               {\\\\n                  \\\\\\&quot;balance\\\\\\&quot;: 2500,\\\\n                  \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;USD\\\\\\&quot;,\\\\n                  \\\\\\&quot;received\\\\\\&quot;: 0,\\\\n                  \\\\\\&quot;reserved\\\\\\&quot;: -2500,\\\\n               }\\\\n            ],\\\\n            \\\\\\&quot;bookingDate\\\\\\&quot;: \\\\\\&quot;2024-08-28T13:30:18+02:00\\\\\\&quot;,\\\\n            \\\\\\&quot;transactionId\\\\\\&quot;: \\\\\\&quot;EVJN4294X224223D5KKNV5MBWJ53HFUSD\\\\\\&quot;\\\\n         }\\\\n      ],\\\\n      \\\\\\&quot;reason\\\\\\&quot;: \\\\\\&quot;approved\\\\\\&quot;,\\\\n      \\\\\\&quot;reference\\\\\\&quot;: \\\\\\&quot;Your reference for the transfer\\\\\\&quot;,\\\\n      \\\\\\&quot;referenceForBeneficiary\\\\\\&quot;: \\\\\\&quot;Your-reference-for-the-recipient-of-the-transfer-request\\\\\\&quot;,\\\\n      \\\\\\&quot;sequenceNumber\\\\\\&quot;: 3,\\\\n      \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;booked\\\\\\&quot;,\\\\n   },\\\\n   \\\\\\&quot;environment\\\\\\&quot;: \\\\\\&quot;test\\\\\\&quot;,\\\\n   \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;balancePlatform.transfer.updated\\\\\\&quot;\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:&quot;booked-debit-source&quot;,&quot;oldTabId&quot;:&quot;booked-debit-source_1&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Target balance account&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;For the target balance account, the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/transfer-webhooks\\\/latest\\\/post\\\/balancePlatform.transfer.updated\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;balancePlatform.transfer.updated&lt;\\\/a&gt; webhook indicates that the transfer amount has been debited:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;code&gt;direction&lt;\\\/code&gt;: &lt;strong&gt;incoming&lt;\\\/strong&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;balances.balance&lt;\\\/code&gt;: a negative amount&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Incoming transfer booked&#039;\\&quot; :id=\\&quot;&#039;booked-debit-incoming&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n   \\\\\\&quot;data\\\\\\&quot;: {\\\\n      \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;3K6U5F62NIZJSIVI\\\\\\&quot;,\\\\n      \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;internalDirectDebit\\\\\\&quot;,\\\\n      \\\\\\&quot;accountHolder\\\\\\&quot;: {\\\\n         \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;Your description for the account holder of the target balance account\\\\\\&quot;,\\\\n         \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;AH00000000000000000000002\\\\\\&quot;,\\\\n         \\\\\\&quot;reference\\\\\\&quot;: \\\\\\&quot;Your reference for the account holder\\\\\\&quot;\\\\n      },\\\\n      \\\\\\&quot;amount\\\\\\&quot;: {\\\\n         \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;USD\\\\\\&quot;,\\\\n         \\\\\\&quot;value\\\\\\&quot;: 2500\\\\n      },\\\\n      \\\\\\&quot;balanceAccount\\\\\\&quot;: {\\\\n         \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;Your description for the target balance account\\\\\\&quot;,\\\\n         \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;BA00000000000000000000001\\\\\\&quot;\\\\n      },\\\\n      \\\\\\&quot;balancePlatform\\\\\\&quot;: \\\\\\&quot;YOUR_BALANCE_PLATFORM\\\\\\&quot;,\\\\n      \\\\\\&quot;balances\\\\\\&quot;: [\\\\n         {\\\\n            \\\\\\&quot;balance\\\\\\&quot;: -2500,\\\\n            \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;USD\\\\\\&quot;,\\\\n            \\\\\\&quot;received\\\\\\&quot;: 0,\\\\n            \\\\\\&quot;reserved\\\\\\&quot;: 0\\\\n         }\\\\n      ],\\\\n      \\\\\\&quot;category\\\\\\&quot;: \\\\\\&quot;internal\\\\\\&quot;,\\\\n      \\\\\\&quot;counterparty\\\\\\&quot;: {\\\\n         \\\\\\&quot;balanceAccountId\\\\\\&quot;: \\\\\\&quot;BA00000000000000000LIABLE\\\\\\&quot;\\\\n      },\\\\n      \\\\\\&quot;creationDate\\\\\\&quot;: \\\\\\&quot;2024-08-28T13:30:05+02:00\\\\\\&quot;,\\\\n      \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;Your description of the transfer\\\\\\&quot;,\\\\n      \\\\\\&quot;direction\\\\\\&quot;: \\\\\\&quot;incoming\\\\\\&quot;,\\\\n      \\\\\\&quot;events\\\\\\&quot;: [\\\\n         {\\\\n            \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;KESG00000000000000000000000001\\\\\\&quot;,\\\\n            \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;accounting\\\\\\&quot;,\\\\n            \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;received\\\\\\&quot;,\\\\n            \\\\\\&quot;mutations\\\\\\&quot;: [\\\\n               {\\\\n                  \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;USD\\\\\\&quot;,\\\\n                  \\\\\\&quot;received\\\\\\&quot;: -2500\\\\n               }\\\\n            ],\\\\n            \\\\\\&quot;bookingDate\\\\\\&quot;: \\\\\\&quot;2024-08-28T13:30:18+02:00\\\\\\&quot;\\\\n         },\\\\n         {\\\\n            \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;KESG00000000000000000000000002\\\\\\&quot;,\\\\n            \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;accounting\\\\\\&quot;,\\\\n            \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;authorised\\\\\\&quot;,\\\\n            \\\\\\&quot;mutations\\\\\\&quot;: [\\\\n               {\\\\n                  \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;USD\\\\\\&quot;,\\\\n                  \\\\\\&quot;received\\\\\\&quot;: 2500,\\\\n                  \\\\\\&quot;reserved\\\\\\&quot;: -2500\\\\n               }\\\\n            ],\\\\n            \\\\\\&quot;bookingDate\\\\\\&quot;: \\\\\\&quot;2024-08-28T13:30:18+02:00\\\\\\&quot;\\\\n         },\\\\n         {\\\\n            \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;KESG00000000000000000000000003\\\\\\&quot;,\\\\n            \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;accounting\\\\\\&quot;,\\\\n            \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;booked\\\\\\&quot;,\\\\n            \\\\\\&quot;mutations\\\\\\&quot;: [\\\\n               {\\\\n                  \\\\\\&quot;balance\\\\\\&quot;: -2500,\\\\n                  \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;USD\\\\\\&quot;,\\\\n                  \\\\\\&quot;received\\\\\\&quot;: 0,\\\\n                  \\\\\\&quot;reserved\\\\\\&quot;: 2500\\\\n               }\\\\n            ],\\\\n            \\\\\\&quot;valueDate\\\\\\&quot;: \\\\\\&quot;2024-08-28T13:30:18+02:00\\\\\\&quot;,\\\\n            \\\\\\&quot;bookingDate\\\\\\&quot;: \\\\\\&quot;2024-08-28T13:30:18+02:00\\\\\\&quot;,\\\\n            \\\\\\&quot;transactionId\\\\\\&quot;: \\\\\\&quot;EVJN42CL8224223D5KKNTXP54453VSUSD\\\\\\&quot;\\\\n         }\\\\n      ],\\\\n      \\\\\\&quot;reason\\\\\\&quot;: \\\\\\&quot;approved\\\\\\&quot;,\\\\n      \\\\\\&quot;reference\\\\\\&quot;: \\\\\\&quot;Your reference for the transfer\\\\\\&quot;,\\\\n      \\\\\\&quot;referenceForBeneficiary\\\\\\&quot;: \\\\\\&quot;Your-reference-for-the-recipient-of-the-transfer-request\\\\\\&quot;\\\\n      \\\\\\&quot;sequenceNumber\\\\\\&quot;: 3,\\\\n      \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;booked\\\\\\&quot;\\\\n   },\\\\n   \\\\\\&quot;environment\\\\\\&quot;: \\\\\\&quot;test\\\\\\&quot;,\\\\n   \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;balancePlatform.transfer.updated\\\\\\&quot;\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:&quot;booked-debit-target&quot;,&quot;oldTabId&quot;:&quot;booked-debit-target_2&quot;,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n\n        <\/div>\n    <\/div>\n<\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/business-accounts\/transfer-funds-internally","articleFields":{"description":"Initiate internal direct debits between your users' balance accounts.","cache_enable":false,"parameters":{"directoryPath":"\/business-accounts","model":"balance platform"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/business-accounts\/transfer-funds-internally","title":"Transfer funds internally","content":"An internal direct debit moves funds between balance accounts within your balance platform. For example, to collect monthly or subscription fees from your users without triggering strong customer authentication (SCA) or payment fees, you can initiate an internal debit, where your liable balance account sends a debit request to your user's balance account. As a balance platform, you can also initiate internal direct debits between the balance accounts of two different users.\nBefore you begin\n\nMake sure that your server can receive and accept webhooks, and that you subscribed to the Transfer webhooks in your Customer Area.\nAsk our Support Team to enable transfers for the balance account that debits funds.\nMake sure that your account holders have the following capabilities:\n\nThe account holder of the balance account that initiates the direct debit must have the sendToBalanceAccount capability.\nThe account holder of the balance account that received the request must have the receiveFromBalanceAccount capability.\n\n\nInitiate an internal direct debit\nTo initiate an internal direct debit, make a POST  \/transfers request.\nIn the body of the request, include the following fields:\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\n amount\n\nAn object containing the currency and value of the transfer.\n\n\n balanceAccountId\n\nThe unique identifier of the source balance account: the balance account that initiates the direct debit.\n\n\n counterparty.balanceAccountId\n\nThe unique identifier of the target balance account: the balance account that receives the debit request.\n\n\n category\n\nSet to internal.\n\n\n type\n\nSet to internalDirectDebit to debit the funds from the counterparty balance account.\n\n\n description\n\nYour description of the transfer. You can use this to identify the transfer in the webhooks that you receive.\n\n\n reference\n\nYour unique reference for the transfer. You can use this to identify the transfer in the webhooks that you receive.\n\n\n referenceForBeneficiary\n\nText to inform the recipient about the push or pull transfer. This reference is also included in all webhooks. Supported characters: a-z, A-Z, 0-9.\n\n\n\nThe following example shows how to pull USD&nbsp;25 from your user's balance account to your liable balance account.\n\n    \n\nIn the response, note the following:\n\nid: the unique ID of the transfer.\nstatus: the result of the transfer.\nreason: an explanation of the status. Check this field if the status is not authorised.\nFor example, the reason for a refused status can be notEnoughBalance.\n\n\n    \n\nGet status updates\nFor every internal transfer request, Adyen sends multiple webhooks to your server: a series of webhooks for the balance account where the transfer is an outgoing request, and a series of webhooks for the balance account where the transfer is an incoming request.\nUsing these webhooks, you can track the status of the transfer: received, then authorised, and finally booked. The webhooks also inform you if the transfer failed.\nYou can also view the transfer details in your Customer Area. Each transfer of funds between balance accounts appears in the Customer Area as two transfer entries: one for the balance account that is credited, and one for the balance account that is debited.\nWhen you initiate an internal direct debit is triggered between balance accounts in your balance platform, Adyen sends two kinds of webhooks:\n\n balancePlatform.transfer.created, that informs your server that funds will be transferred between the balance accounts.\n balancePlatform.transfer.updated, that informs your server of changes in the status of the fund transfer.\n\nFor each event you receive two sets of webhooks:\n\nWebhooks for the source balance account, where you initiate the direct debit an outgoing request.\nWebhooks for the target balance account, that received the direct debit as an incoming request.\n\nYou can identify transfer webhooks triggered by internal direct debit requests by the following values:\n\n\n\nParameter\nDescription\nValue\n\n\n\n\n category\nThe category of the transfer.\ninternal\n\n\n direction\nThe direction of the transfer request.\noutgoing for the source balance account  incoming for the target balance account\n\n\n type\nThe type of internal transfer.\ninternalDirectDebit\n\n\n\nFor an internal direct debit, you receive webhooks for the following events:\n\nThe transfer is initiated.\nThe transfer is authorized. This indicates that the funds are reserved.\nThe transfer is booked.\n\nExpand the sections below to see the webhooks you would receive for the example direct debit request above.\n\n    \n    \n        \n            \n            \n                                    1. Internal direct debit initiated\n                            \n        \n        \n            \nWhen you initiate an internal direct debit, we send you a  balancePlatform.transfer.created webhook with status received, to inform your server that funds will be transferred between balance accounts in your balance platform.\n\n\n    \n        \n        \n    \n\n\n\n        \n    \n\n\n\n    \n    \n        \n            \n            \n                                    2. Internal direct debit authorized\n                            \n        \n        \n            \nWhen the scheduled or on-demand internal pull transfer is authorized, Adyen sends  balancePlatform.transfer.updated webhooks with status authorised, to inform your server that the funds have been reserved on the source and target balance accounts.\n\n\n    \n        \n        \n    \n\n\n\n        \n    \n\n\n\n    \n    \n        \n            \n            \n                                    3. Internal direct debit booked\n                            \n        \n        \n            \nWhen the scheduled or on-demand internal pull transfer is booked, Adyen sends  balancePlatform.transfer.updated webhooks with status booked, to inform your server that the funds have been pulled from the target balance account to the source balance account.\n\n\n    \n        \n        \n    \n\n\n\n        \n    \n\n","type":"page","locale":"pt","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Business accounts","lvl2":"Transfer funds internally"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/business-accounts","lvl2":"\/pt\/business-accounts\/transfer-funds-internally"},"levels":3,"category":"","category_color":"","tags":["Transfer","funds","internally"]}}
