{"title":"External bank transfer","category":"default","creationDate":1776961628,"content":"<p>You can fund balance accounts by initiating a bank transfer from an external bank account to a <a href=\"#funding-account-details\">funding account that Adyen provides<\/a>. This is a push-based funding method: you initiate the transfer from your bank, and Adyen receives and processes it. For pull-based funding, where Adyen initiates the transfer from your bank account, see <a href=\"\/pt\/issuing\/add-manage-funds\/top-ups\">Top up accounts<\/a>. If you are acquiring payments with Adyen, you can also fund balance accounts through <a href=\"\/pt\/issuing\/add-manage-funds\/split-payments\">split payments<\/a>.<\/p>\n<p>After Adyen books the transfer, the funds are available on the account holder's primary balance account and can be used with their issued card.<\/p>\n<h2>Requirements<\/h2>\n<p>Before you begin, take into account the following requirements, limitations, and preparations.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Requirement<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><strong>Integration type<\/strong><\/td>\n<td style=\"text-align: left;\">This feature is supported for <a href=\"\/pt\/issuing\">Adyen Issuing<\/a> integrations.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong><a href=\"\/pt\/development-resources\/webhooks\">Webhooks<\/a><\/strong><\/td>\n<td style=\"text-align: left;\">Subscribe to the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfer-webhooks\/latest\/overview\" class=\" external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Transfer webhooks<\/a> to get updates on fund transfer events.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong><a href=\"\/pt\/issuing\/verification-overview\/capabilities\">Capabilities<\/a><\/strong><\/td>\n<td style=\"text-align: left;\">The <strong>receiveFromTransferInstrument<\/strong> capability must be <a href=\"\/pt\/issuing\/manage-account-holders#request-capability\">requested<\/a>, enabled, and allowed for the account holder.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>How it works<\/h2>\n<p>The following is an overview of the bank transfer funding process:<\/p>\n<ol>\n<li>Adyen configures your balance platform and provides you with the details of a <a href=\"#funding-account-details\">funding bank account<\/a>, such as an IBAN or routing and account number.<\/li>\n<li>You <a href=\"#prepare-for-bank-transfer-funding\">prepare for bank transfer funding<\/a> by onboarding the external bank account as a transfer instrument (a verified external bank account linked to the account holder's main legal entity) and completing all verification requirements.<\/li>\n<li>You <a href=\"#send-a-bank-transfer\">send a bank transfer<\/a> from the onboarded external bank account to the funding account.<\/li>\n<li>Adyen matches the incoming transfer to the onboarded transfer instrument and books the funds to the account holder's primary balance account.<\/li>\n<li>You receive <a href=\"#confirm-fund-availability\">webhooks<\/a> informing you that the funds have been booked and are available on the balance account.<\/li>\n<\/ol>\n<h2>Funding account details<\/h2>\n<p>When Adyen configures your balance platform for bank transfer funding, Adyen generates a funding bank account for your platform. Your Adyen contact provides you with the details of this funding account, such as the IBAN or routing and account number. You use this funding account as the destination for all bank transfers.<\/p>\n<p>If you need a signed letter confirming that the funding account is administered by Adyen and designated for your card program, contact 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>.<\/p>\n<h2>Prepare for bank transfer funding<\/h2>\n<p>Before an account holder can receive funds through a bank transfer, complete the following steps.<\/p>\n<ol>\n<li>\n<p>Confirm that the account holder's primary balance account is the one linked to the card you want to fund. Adyen books incoming transfers to the primary balance account, so it must match the balance account of the card you intend to fund.<\/p>\n<p>The primary balance account is, by default, the first balance account created for the account holder. You can check or change this in your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a> under <strong>Accounts &amp; balances &gt; Account holders &gt; Balance accounts<\/strong>, or by using the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/balanceplatform\/latest\/patch\/accountHolders\/(id)\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/accountHolders\/{id}<\/a> endpoint.<\/p>\n<p>To fund non-primary balance accounts, first fund the primary balance account, and then <a href=\"\/pt\/issuing\/add-manage-funds\/funds-transfers\">transfer funds internally<\/a>.<\/p>\n<\/li>\n<li>\n<p>Onboard the external bank account used to send the transfer as a <code>transferInstrument<\/code>. This is the bank account that the account holder uses to send the transfer. You can onboard the bank account through <a href=\"\/pt\/issuing\/onboard-users\/customize-hosted-onboarding\">Hosted Onboarding<\/a> or the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/overview\" class=\" external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Legal Entity Management API<\/a>. To prevent delays, make sure the transfer instrument is verified before you send any funds. You can check the verification status in your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a> under <strong>Accounts &amp; balances &gt; Account holders &gt; Account holder details &gt; KYC timeline<\/strong>.<\/p>\n<\/li>\n<li>\n<p><a href=\"\/pt\/issuing\/manage-account-holders#request-capability\">Request the <strong>receiveFromTransferInstrument<\/strong> capability<\/a> for the account holder. This capability allows the account holder to receive funds from the onboarded bank account. Requesting it triggers upfront <a href=\"\/pt\/issuing\/verification-overview\">verification<\/a>.<\/p>\n<\/li>\n<li>\n<p>Make sure that all verification requirements are met. All documents for the account holder, the legal entity, and the transfer instrument must be submitted and approved. You can check the verification status in your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a> under <strong>Accounts &amp; balances &gt; Account holders &gt; Account holder details &gt; KYC timeline<\/strong>.<\/p>\n<\/li>\n<\/ol>\n<p>After all verification is complete and the <strong>receiveFromTransferInstrument<\/strong> capability shows as <strong>allowed<\/strong>, you can start making bank transfers to fund the account holder's balance account.<\/p>\n<h2>Funding timeline<\/h2>\n<p>After you send a bank transfer, funds are typically available on the balance account within the same day to a few business days, processing times can vary depending on the region, currency, and payment network used by your bank.<\/p>\n<p>Factors that can affect the processing time include:<\/p>\n<ul>\n<li>The payment network your bank uses to process the transfer.<\/li>\n<li>Cutoff times at your bank and any intermediary banks.<\/li>\n<li>Weekend and holiday schedules.<\/li>\n<li>Whether your transfer is routed through intermediary or correspondent banks.<\/li>\n<\/ul>\n<p>To know when the funds are available, keep track of <a href=\"#confirm-fund-availability\">webhooks<\/a>. The <code>balancePlatform.transfer.updated<\/code> webhook with <code>status<\/code>: <strong>booked<\/strong> confirms that the funds have arrived and are ready for use.<\/p>\n<p>For details about the available payment networks and expected processing times for your region, reach out to your Adyen contact.<\/p>\n<h2>Send a bank transfer<\/h2>\n<p>After you complete all <a href=\"#prepare-for-bank-transfer-funding\">preparation steps<\/a> and have your <a href=\"#funding-account-details\">funding account details<\/a>:<\/p>\n<ol>\n<li>\n<p>From your bank account, which you onboarded as a transfer instrument, send a bank transfer to your funding account.<\/p>\n<p>The transfer must originate from the onboarded bank account. Adyen cannot match funds sent from an unregistered bank account.<\/p>\n<\/li>\n<li>\n<p>To know if the funds have arrived, keep track of <a href=\"#confirm-fund-availability\">transfer webhook messages<\/a>. You can also check the balance in your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a> under <strong>Accounts &amp; balances &gt; Balance accounts<\/strong>.<\/p>\n<\/li>\n<\/ol>\n<div class=\"notices green\">\n<p>Do not send a transfer before the account holder has completed onboarding and verification. The <strong>receiveFromTransferInstrument<\/strong> capability must show as <strong>allowed<\/strong>. Transfers sent before this is complete can result in funding delays.<\/p>\n<\/div>\n<h2>Confirm fund availability<\/h2>\n<p>After you send a bank transfer, Adyen sends <a href=\"\/pt\/issuing\/webhook-types\/fund-transfers-webhooks\">webhook messages<\/a> to inform you of each stage of the transfer. You can use these webhooks to determine when funds are available on the balance account.<\/p>\n<p>You can identify the webhooks for incoming bank transfers by the following values:<\/p>\n<ul>\n<li><code>category<\/code>: <strong>bank<\/strong><\/li>\n<li><code>type<\/code>: <strong>bankTransfer<\/strong><\/li>\n<li><code>direction<\/code>: <strong>incoming<\/strong><\/li>\n<\/ul>\n<h3>Transfer lifecycle<\/h3>\n<p>Adyen sends the following webhooks for each incoming bank transfer:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Webhook<\/th>\n<th style=\"text-align: left;\">Status<\/th>\n<th style=\"text-align: left;\">What it means<\/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\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balancePlatform.transfer.created<\/a><\/td>\n<td style=\"text-align: left;\"><strong>received<\/strong><\/td>\n<td style=\"text-align: left;\">The incoming bank transfer has been received.<\/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.updated\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balancePlatform.transfer.updated<\/a><\/td>\n<td style=\"text-align: left;\"><strong>authorised<\/strong><\/td>\n<td style=\"text-align: left;\">The transfer has been authorised.<\/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.updated\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balancePlatform.transfer.updated<\/a><\/td>\n<td style=\"text-align: left;\"><strong>booked<\/strong><\/td>\n<td style=\"text-align: left;\">Funds have been added to the account holder's primary balance account. <strong>The funds are now available for use.<\/strong><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>The <code>balancePlatform.transfer.updated<\/code> webhook with <code>status<\/code>: <strong>booked<\/strong> confirms that funds are available on the balance account.<\/p>\n<h3>Check the balance<\/h3>\n<p>You can also check if funds have arrived:<\/p>\n<ul>\n<li>In your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a> under <strong>Accounts &amp; balances &gt; Balance accounts<\/strong>.<\/li>\n<li>By making 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 and checking the <code>balance<\/code> field.<\/li>\n<\/ul>\n<p>If funds have not arrived within the expected processing time, make sure that all <a href=\"#prepare-for-bank-transfer-funding\">preparation steps<\/a> are complete and that the <strong>receiveFromTransferInstrument<\/strong> capability is <strong>allowed<\/strong>.<\/p>\n<h2>See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/issuing\/add-manage-funds\/funds-transfers\"\n                        target=\"_self\"\n                        >\n                    Internal funds transfer\n                <\/a><\/li><li><a href=\"\/issuing\/add-manage-funds\/split-payments\"\n                        target=\"_self\"\n                        >\n                    Split payments\n                <\/a><\/li><li><a href=\"\/issuing\/webhook-types\/fund-transfers-webhooks\"\n                        target=\"_self\"\n                        >\n                    Webhooks for fund transfer events\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/issuing\/add-manage-funds\/external-bank-transfer","articleFields":{"description":"Fund balance accounts by sending a bank transfer from an external bank account.","feedback_component":true,"parameters":{"directoryPath":"\/issuing","integrationType":"issuing"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/issuing\/add-manage-funds\/external-bank-transfer","title":"External bank transfer","content":"You can fund balance accounts by initiating a bank transfer from an external bank account to a funding account that Adyen provides. This is a push-based funding method: you initiate the transfer from your bank, and Adyen receives and processes it. For pull-based funding, where Adyen initiates the transfer from your bank account, see Top up accounts. If you are acquiring payments with Adyen, you can also fund balance accounts through split payments.\nAfter Adyen books the transfer, the funds are available on the account holder's primary balance account and can be used with their issued card.\nRequirements\nBefore you begin, take into account the following requirements, limitations, and preparations.\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nThis feature is supported for Adyen Issuing integrations.\n\n\nWebhooks\nSubscribe to the  Transfer webhooks to get updates on fund transfer events.\n\n\nCapabilities\nThe receiveFromTransferInstrument capability must be requested, enabled, and allowed for the account holder.\n\n\n\nHow it works\nThe following is an overview of the bank transfer funding process:\n\nAdyen configures your balance platform and provides you with the details of a funding bank account, such as an IBAN or routing and account number.\nYou prepare for bank transfer funding by onboarding the external bank account as a transfer instrument (a verified external bank account linked to the account holder's main legal entity) and completing all verification requirements.\nYou send a bank transfer from the onboarded external bank account to the funding account.\nAdyen matches the incoming transfer to the onboarded transfer instrument and books the funds to the account holder's primary balance account.\nYou receive webhooks informing you that the funds have been booked and are available on the balance account.\n\nFunding account details\nWhen Adyen configures your balance platform for bank transfer funding, Adyen generates a funding bank account for your platform. Your Adyen contact provides you with the details of this funding account, such as the IBAN or routing and account number. You use this funding account as the destination for all bank transfers.\nIf you need a signed letter confirming that the funding account is administered by Adyen and designated for your card program, contact our Support Team.\nPrepare for bank transfer funding\nBefore an account holder can receive funds through a bank transfer, complete the following steps.\n\n\nConfirm that the account holder's primary balance account is the one linked to the card you want to fund. Adyen books incoming transfers to the primary balance account, so it must match the balance account of the card you intend to fund.\nThe primary balance account is, by default, the first balance account created for the account holder. You can check or change this in your Customer Area under Accounts &amp; balances &gt; Account holders &gt; Balance accounts, or by using the  \/accountHolders\/{id} endpoint.\nTo fund non-primary balance accounts, first fund the primary balance account, and then transfer funds internally.\n\n\nOnboard the external bank account used to send the transfer as a transferInstrument. This is the bank account that the account holder uses to send the transfer. You can onboard the bank account through Hosted Onboarding or the  Legal Entity Management API. To prevent delays, make sure the transfer instrument is verified before you send any funds. You can check the verification status in your Customer Area under Accounts &amp; balances &gt; Account holders &gt; Account holder details &gt; KYC timeline.\n\n\nRequest the receiveFromTransferInstrument capability for the account holder. This capability allows the account holder to receive funds from the onboarded bank account. Requesting it triggers upfront verification.\n\n\nMake sure that all verification requirements are met. All documents for the account holder, the legal entity, and the transfer instrument must be submitted and approved. You can check the verification status in your Customer Area under Accounts &amp; balances &gt; Account holders &gt; Account holder details &gt; KYC timeline.\n\n\nAfter all verification is complete and the receiveFromTransferInstrument capability shows as allowed, you can start making bank transfers to fund the account holder's balance account.\nFunding timeline\nAfter you send a bank transfer, funds are typically available on the balance account within the same day to a few business days, processing times can vary depending on the region, currency, and payment network used by your bank.\nFactors that can affect the processing time include:\n\nThe payment network your bank uses to process the transfer.\nCutoff times at your bank and any intermediary banks.\nWeekend and holiday schedules.\nWhether your transfer is routed through intermediary or correspondent banks.\n\nTo know when the funds are available, keep track of webhooks. The balancePlatform.transfer.updated webhook with status: booked confirms that the funds have arrived and are ready for use.\nFor details about the available payment networks and expected processing times for your region, reach out to your Adyen contact.\nSend a bank transfer\nAfter you complete all preparation steps and have your funding account details:\n\n\nFrom your bank account, which you onboarded as a transfer instrument, send a bank transfer to your funding account.\nThe transfer must originate from the onboarded bank account. Adyen cannot match funds sent from an unregistered bank account.\n\n\nTo know if the funds have arrived, keep track of transfer webhook messages. You can also check the balance in your Customer Area under Accounts &amp; balances &gt; Balance accounts.\n\n\n\nDo not send a transfer before the account holder has completed onboarding and verification. The receiveFromTransferInstrument capability must show as allowed. Transfers sent before this is complete can result in funding delays.\n\nConfirm fund availability\nAfter you send a bank transfer, Adyen sends webhook messages to inform you of each stage of the transfer. You can use these webhooks to determine when funds are available on the balance account.\nYou can identify the webhooks for incoming bank transfers by the following values:\n\ncategory: bank\ntype: bankTransfer\ndirection: incoming\n\nTransfer lifecycle\nAdyen sends the following webhooks for each incoming bank transfer:\n\n\n\nWebhook\nStatus\nWhat it means\n\n\n\n\n balancePlatform.transfer.created\nreceived\nThe incoming bank transfer has been received.\n\n\n balancePlatform.transfer.updated\nauthorised\nThe transfer has been authorised.\n\n\n balancePlatform.transfer.updated\nbooked\nFunds have been added to the account holder's primary balance account. The funds are now available for use.\n\n\n\nThe balancePlatform.transfer.updated webhook with status: booked confirms that funds are available on the balance account.\nCheck the balance\nYou can also check if funds have arrived:\n\nIn your Customer Area under Accounts &amp; balances &gt; Balance accounts.\nBy making a GET  \/balanceAccounts\/{id} request and checking the balance field.\n\nIf funds have not arrived within the expected processing time, make sure that all preparation steps are complete and that the receiveFromTransferInstrument capability is allowed.\nSee also\n\n\n                    Internal funds transfer\n                \n                    Split payments\n                \n                    Webhooks for fund transfer events\n                \n","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Adyen Issuing","lvl2":"Add and manage funds","lvl3":"External bank transfer"},"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\/external-bank-transfer"},"levels":4,"category":"Issuing","category_color":"green","tags":["External","transfer"]}}
