{"title":"Funds transfers","category":"default","creationDate":1571779920,"content":"<p>Your Adyen-issued cards are always linked to a balance account that holds its funds. You can use the funds from the balance account to make business-related payments with the linked cards.<\/p>\n<p>To make sure that the balance account has enough funds to cover your business-related payments, you can make transfers to top up the account. You can do one of the following:<\/p>\n<ul>\n<li><a href=\"#transfer-from-your-transfer-instrument\">Transfer funds from your verified external bank account (transfer instrument)<\/a><\/li>\n<li><a href=\"#transfer-funds-internally\">Transfer funds internally<\/a><\/li>\n<\/ul>\n<h2 id=\"transfer-instrument\">Transfer from your transfer instrument<\/h2>\n<p>To transfer funds to your balance account from your verified external bank account (transfer instrument):<\/p>\n<ol>\n<li>Make sure you have created a <a href=\"\/pt\/issuing\/onboard-users\/onboarding-steps?onboarding_type=custom&amp;location=nl&amp;legal_entity=organization#create-transfer-instrument\">transfer instrument<\/a> for your balance account.<\/li>\n<li>Make a bank transfer of the required amount from your transfer instrument to Adyen's bank account. For details about Adyen's bank account, reach out to your Adyen contact.<\/li>\n<\/ol>\n<p>After Adyen receives the funds from your bank transfer, we settle these funds to the linked balance account.<\/p>\n<p>For detailed guidance on the full bank transfer funding process, including preparation steps and webhooks, see <a href=\"\/pt\/issuing\/add-manage-funds\/bank-transfer-funding\">Transfer funds from an external bank account<\/a>.<\/p>\n<h2>Transfer funds internally<\/h2>\n<p>You can transfer funds internally between balance accounts, as long as the balance accounts belong to the same balance platform. The funds can be pushed or pulled from one balance account to the other:<\/p>\n<ul>\n<li>When you <strong>push<\/strong> funds to the target balance account, that account is credited.<\/li>\n<li>When you <strong>pull<\/strong> funds from the target balance account, that account is debited.<\/li>\n<\/ul>\n<h3>Funding from your liable balance account<\/h3>\n<p>Your liable balance account is the main balance account that belongs to your company. You can transfer funds internally from your liable balance account to your other balance accounts, to ensure that they have enough funds to make business-related payments. To do this, you must first deposit funds into your liable balance account using an <a href=\"\/pt\/issuing\/add-manage-funds\/external-bank-transfer\">external bank transfer<\/a>. Then, you must make a push transfer from your liable balance account to the balance account to which you want to add funds.<\/p>\n<h3>Make an internal funds transfer<\/h3>\n<p>Before you can transfer funds internally, reach out to your Adyen contact to:<\/p>\n<ul>\n<li>Add a role for your <a href=\"\/pt\/issuing\/integration-checklist#verify-your-test-credentials\">API credential<\/a>, which you will use for the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers\/latest\/overview\" class=\" external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Transfers API<\/a>.<\/li>\n<li>Enable transfers for the source balance account.<\/li>\n<\/ul>\n<p>You can now make an internal transfer by following these steps:<\/p>\n<ol>\n<li>\n<p>To move funds between balance accounts, 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. In the body of the request, specify 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 transfer 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-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 transfer.<br> The funds are credited to this 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-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-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 push <strong>EUR&nbsp;100.00<\/strong> from your liable balance account to your user's balance account.<\/p>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Push funds to another balance account'\" :id=\"'internal-transfer'\" :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;EUR\\&quot;,\\n      \\&quot;value\\&quot;: 10000\\n   },\\n   \\&quot;balanceAccountId\\&quot;: \\&quot;BA00000000000000000000001\\&quot;,\\n   \\&quot;counterparty\\&quot;: {\\n      \\&quot;balanceAccountId\\&quot;: \\&quot;BA00000000000000000000002\\&quot;\\n   },\\n   \\&quot;category\\&quot; : \\&quot;internal\\&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;EUR\\&quot;)\\n  .value(10000L);\\n\\nCounterpartyInfoV3 counterpartyInfoV3 = new CounterpartyInfoV3()\\n  .balanceAccountId(\\&quot;BA00000000000000000000002\\&quot;);\\n\\nTransferInfo transferInfo = new TransferInfo()\\n  .balanceAccountId(\\&quot;BA00000000000000000000001\\&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\\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;EUR\\&quot;)\\n  -&gt;setValue(10000);\\n\\n$counterpartyInfoV3 = new CounterpartyInfoV3();\\n$counterpartyInfoV3\\n  -&gt;setBalanceAccountId(\\&quot;BA00000000000000000000002\\&quot;);\\n\\n$transferInfo = new TransferInfo();\\n$transferInfo\\n  -&gt;setBalanceAccountId(\\&quot;BA00000000000000000000001\\&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\\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;EUR\\&quot;,\\n  Value = 10000\\n};\\n\\nCounterpartyInfoV3 counterpartyInfoV3 = new CounterpartyInfoV3\\n{\\n  BalanceAccountId = \\&quot;BA00000000000000000000002\\&quot;\\n};\\n\\nTransferInfo transferInfo = new TransferInfo\\n{\\n  BalanceAccountId = \\&quot;BA00000000000000000000001\\&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};\\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;EUR\\&quot;,\\n    value: 10000\\n  },\\n  balanceAccountId: \\&quot;BA00000000000000000000001\\&quot;,\\n  counterparty: {\\n    balanceAccountId: \\&quot;BA00000000000000000000002\\&quot;\\n  },\\n  category: \\&quot;internal\\&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;EUR\\&quot;,\\n  Value: 10000,\\n}\\n\\ncounterpartyInfoV3 := transfers.CounterpartyInfoV3{\\n  BalanceAccountId: common.PtrString(\\&quot;BA00000000000000000000002\\&quot;),\\n}\\n\\ntransferInfo := transfers.TransferInfo{\\n  BalanceAccountId: common.PtrString(\\&quot;BA00000000000000000000001\\&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}\\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;EUR\\&quot;,\\n    \\&quot;value\\&quot;: 10000\\n  },\\n  \\&quot;balanceAccountId\\&quot;: \\&quot;BA00000000000000000000001\\&quot;,\\n  \\&quot;counterparty\\&quot;: {\\n    \\&quot;balanceAccountId\\&quot;: \\&quot;BA00000000000000000000002\\&quot;\\n  },\\n  \\&quot;category\\&quot;: \\&quot;internal\\&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; 'EUR',\\n    :value =&gt; 10000\\n  },\\n  :balanceAccountId =&gt; 'BA00000000000000000000001',\\n  :counterparty =&gt; {\\n    :balanceAccountId =&gt; 'BA00000000000000000000002'\\n  },\\n  :category =&gt; 'internal',\\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;EUR\\&quot;,\\n  value: 10000\\n};\\n\\nconst counterpartyInfoV3: Types.transfers.CounterpartyInfoV3 = {\\n  balanceAccountId: \\&quot;BA00000000000000000000002\\&quot;\\n};\\n\\nconst transferInfo: Types.transfers.TransferInfo = {\\n  balanceAccountId: \\&quot;BA00000000000000000000001\\&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};\\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<\/li>\n<li>\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=\"'Response'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n  \\\"creationDate\\\": \\\"2023-08-08T13:52:08+02:00\\\",\\n  \\\"id\\\": \\\"48NJIB9TWQJ6L7U7\\\",\\n  \\\"accountHolder\\\": {\\n    \\\"description\\\": \\\"Your account holder description\\\",\\n    \\\"id\\\": \\\"AH00000000000000000000001\\\",\\n    \\\"reference\\\": \\\"Your account holder reference\\\"\\n  },\\n  \\\"amount\\\": {\\n    \\\"currency\\\": \\\"EUR\\\",\\n    \\\"value\\\": 10000\\n  },\\n  \\\"balanceAccount\\\": {\\n    \\\"description\\\": \\\"Your balance account description\\\",\\n    \\\"id\\\": \\\"BA00000000000000000000001\\\",\\n    \\\"reference\\\": \\\"Your balance account reference\\\"\\n  },\\n  \\\"category\\\" : \\\"internal\\\",\\n  \\\"categoryData\\\": {\\n    \\\"type\\\": \\\"internal\\\"\\n  },\\n  \\\"counterparty\\\": {\\n    \\\"balanceAccountId\\\": \\\"BA00000000000000000000002\\\"\\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\\\": \\\"internalTransfer\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<li>\n<p>To know if the transfer has been completed, keep track of <a href=\"\/pt\/issuing\/webhook-types\/fund-transfers-webhooks\">webhooks<\/a>. You can also make a GET  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/balanceplatform\/latest\/get\/balanceAccounts\/(id)\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/balanceAccounts\/{id}<\/a> request.<\/p>\n<\/li>\n<\/ol>","url":"https:\/\/docs.adyen.com\/pt\/issuing\/add-manage-funds\/funds-transfers","articleFields":{"Menu":"Funds transfers","description":"Transfer funds internally to balance accounts.","last_edit_on":"11-09-2020 17:20","parameters":{"directoryPath":"\/issuing","integrationType":"issuing"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/issuing\/add-manage-funds\/funds-transfers","title":"Funds transfers","content":"Your Adyen-issued cards are always linked to a balance account that holds its funds. You can use the funds from the balance account to make business-related payments with the linked cards.\nTo make sure that the balance account has enough funds to cover your business-related payments, you can make transfers to top up the account. You can do one of the following:\n\nTransfer funds from your verified external bank account (transfer instrument)\nTransfer funds internally\n\nTransfer from your transfer instrument\nTo transfer funds to your balance account from your verified external bank account (transfer instrument):\n\nMake sure you have created a transfer instrument for your balance account.\nMake a bank transfer of the required amount from your transfer instrument to Adyen's bank account. For details about Adyen's bank account, reach out to your Adyen contact.\n\nAfter Adyen receives the funds from your bank transfer, we settle these funds to the linked balance account.\nFor detailed guidance on the full bank transfer funding process, including preparation steps and webhooks, see Transfer funds from an external bank account.\nTransfer funds internally\nYou can transfer funds internally between balance accounts, as long as the balance accounts belong to the same balance platform. The funds can be pushed or pulled from one balance account to the other:\n\nWhen you push funds to the target balance account, that account is credited.\nWhen you pull funds from the target balance account, that account is debited.\n\nFunding from your liable balance account\nYour liable balance account is the main balance account that belongs to your company. You can transfer funds internally from your liable balance account to your other balance accounts, to ensure that they have enough funds to make business-related payments. To do this, you must first deposit funds into your liable balance account using an external bank transfer. Then, you must make a push transfer from your liable balance account to the balance account to which you want to add funds.\nMake an internal funds transfer\nBefore you can transfer funds internally, reach out to your Adyen contact to:\n\nAdd a role for your API credential, which you will use for the  Transfers API.\nEnable transfers for the source balance account.\n\nYou can now make an internal transfer by following these steps:\n\n\nTo move funds between balance accounts, make a POST  \/transfers request. In the body of the request, specify 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 transfer request.\n\n\n counterparty.balanceAccountId\n\nThe unique identifier of the target balance account: the balance account that receives the transfer. The funds are credited to this balance account.\n\n\n category\n\nSet to internal.\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 push EUR&nbsp;100.00 from your liable balance account to your user's balance account.\n\n\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\n\n\nTo know if the transfer has been completed, keep track of webhooks. You can also make a GET  \/balanceAccounts\/{id} request.\n\n","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Adyen Issuing","lvl2":"Add and manage funds","lvl3":"Funds transfers"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/issuing","lvl2":"https:\/\/docs.adyen.com\/pt\/issuing\/add-manage-funds","lvl3":"\/pt\/issuing\/add-manage-funds\/funds-transfers"},"levels":4,"category":"Issuing","category_color":"green","tags":["Funds","transfers"]}}
