{"title":"Fund transfer","category":"Classic Platforms","creationDate":1776961628,"content":"<div class=\"sc-notice info\"><div>\n<p>This page is for classic Adyen for Platforms integrations. If you are just starting your implementation, refer to our <a href=\"\/pt\/adyen-for-platforms-model\">new integration guide<\/a> instead.<\/p>\n<\/div><\/div>\n<p>Depending on your use cases, there might be scenarios that require you to move funds between accounts in your platform. Some examples are if you want to send a bonus, or when it is necessary to transfer funds from one account holder's account to another.<\/p>\n<p>You can transfer funds between accounts using:<\/p>\n<ul>\n<li>An <a href=\"#transfer-funds\">API request<\/a>.<\/li>\n<li>Your <a href=\"#transfer-funds-customer-area\">Customer Area<\/a>.<\/li>\n<\/ul>\n<p>After the funds have been transferred, you can also fully or partially <a href=\"#refund-the-fund-transfer\">refund a funds transfer<\/a> using an API request.<\/p>\n<h2>Requirements<\/h2>\n<p>Before you can transfer funds or refund a fund transfer, you must:<\/p>\n<ol>\n<li>\n<p>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> to enable fund transfers and define your transfer codes. These codes specify the reason for the transfer and must be defined for your platform in compliance with local regulations.<\/p>\n<\/li>\n<li>\n<p>Set up <a href=\"\/pt\/classic-platforms\/configure-notifications\">notification webhooks<\/a> for event types  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Notification\/latest\/post\/TRANSFER_FUNDS\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">TRANSFER_FUNDS<\/a> and  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Notification\/latest\/post\/REFUND_FUNDS_TRANSFER\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">REFUND_FUNDS_TRANSFER<\/a>. Fund transfers and refund fund transfers are processed asynchronously, so you must rely on webhooks to know the outcome of your requests.<\/p>\n<\/li>\n<\/ol>\n<h2 id=\"transfer-funds\">Transfer funds through the API<\/h2>\n<p>You can use the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Fund\/latest\/post\/transferFunds\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/transferFunds<\/a> endpoint  to programmatically initiate a fund transfer. In your POST request, specify:<\/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\/#\/Fund\/latest\/post\/transferFunds__reqParam_sourceAccountCode\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">sourceAccountCode<\/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 code of the account from which the funds are to be debited. The status of the account's <a href=\"\/pt\/classic-platforms\/verification-process#account-holder-statuses\">account holder<\/a> be <span translate=\"no\"><strong>Active<\/strong><\/span> and payouts must be allowed.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><a href=\"https:\/\/docs.adyen.com\/api-explorer\/#\/Fund\/latest\/post\/transferFunds__reqParam_destinationAccountCode\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">destinationAccountCode<\/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 code of the account to which the funds are to be credited. The status of the account's <a href=\"\/pt\/classic-platforms\/verification-process#account-holder-statuses\">account holder<\/a> must be <span translate=\"no\"><strong>Active<\/strong><\/span> and processing must be allowed.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Fund\/latest\/post\/transferFunds#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;\">The <code>currency<\/code> and <code>value<\/code> of the fund transfer.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><a href=\"https:\/\/docs.adyen.com\/api-explorer\/#\/Fund\/latest\/post\/transferFunds__reqParam_transferCode\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">transferCode<\/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 reason for the transfer, preconfigured on Adyen's side. If you haven't defined this yet, 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>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Fund\/latest\/post\/transferFunds#request-merchantReference\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">merchantReference<\/a><\/td>\n<td style=\"text-align: center;\"><\/td>\n<td style=\"text-align: left;\">A string that you provide so you can link multiple transactions.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Transfer funds request'\" :id=\"''\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/cal-test.adyen.com\\\/cal\\\/services\\\/Fund\\\/v6\\\/transferFunds \\\\\\n-H 'x-api-key: ADYEN_API_KEY' \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-d '{\\n   \\&quot;sourceAccountCode\\&quot;:\\&quot;100000000\\&quot;,\\n   \\&quot;destinationAccountCode\\&quot;:\\&quot;190324759\\&quot;,\\n   \\&quot;amount\\&quot;:{\\n      \\&quot;currency\\&quot;:\\&quot;EUR\\&quot;,\\n      \\&quot;value\\&quot;:2000\\n   },\\n   \\&quot;transferCode\\&quot;:\\&quot;CREDIT_DISCOUNT\\&quot;,\\n   \\&quot;merchantReference\\&quot;:\\&quot;MyTransferReference-6718A\\&quot;\\n}'&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<p>Requests for fund transfers are processed asynchronously so in the response, we only inform you that we received your request. You'll get the result from the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Notification\/latest\/post\/TRANSFER_FUNDS\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">TRANSFER_FUNDS<\/a> webhook.<\/p>\n<p>The response returns a <code>pspReference<\/code>. You'll need the <code>pspReference<\/code> in case you have to <a href=\"#refund-the-fund-transfer\">refund the funds transfer<\/a>.<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Response'\" :id=\"'transferfunds-response'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n   \\\"pspReference\\\":\\\"9914828517650017\\\",\\n   \\\"resultCode\\\":\\\"Received\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<p>Successful fund transfers are reported with a <span translate=\"no\"><strong>FundTransfer<\/strong><\/span> journal entry in your <a href=\"\/pt\/reporting\/marketpay-payments-accounting-report\">Marketplace Payment Accounting Report<\/a>.<\/p>\n<h2 id=\"transfer-funds-customer-area\">Transfer funds through Customer Area<\/h2>\n<p>You can use the Customer Area to manually transfer funds. To do this you must have the <strong>Perform and manage Fund Transfers from the customer area<\/strong> role for your Customer Area user. If you do not have the role, contact your Admin user.<\/p>\n<p>To transfer funds through Customer Area:<\/p>\n<ol>\n<li>Log in to your Customer Area and switch to your merchant account.<\/li>\n<li>Go to <strong>Platform<\/strong> &gt; <strong>Sub-merchant<\/strong>.<\/li>\n<li>Select the source account holder, then select the <strong>Accounts<\/strong> tab. The source account holder must have an active status and have payouts allowed.<\/li>\n<li>Select the more actions menu (<i class=\"adl-icon-options\" role=\"img\" aria-label=\"options icon\"><\/i>) then select <strong>Transfer to another account<\/strong>.<\/li>\n<li>\n<p>In the <strong>New transfer<\/strong> page, specify:<\/p>\n<ul>\n<li>The source account. The source account must have a positive balance.<\/li>\n<li>The destination accounts. The account's account holder must have an active status and have processing allowed.<\/li>\n<li>The amount to be transferred.<\/li>\n<\/ul>\n<p>Then select the transfer code from the drop-down list. These codes are configured on Adyen's side. If you haven't defined this yet, 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<\/li>\n<li>Select <strong>Transfer<\/strong> to initiate the fund transfer.<\/li>\n<\/ol>\n<p>You can check the status of the transfer in the <strong>Transactions<\/strong> tab. You can also get the result from the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Notification\/latest\/post\/TRANSFER_FUNDS\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">TRANSFER_FUNDS<\/a> webhook.<\/p>\n<p>Successful fund transfers are reported with a <span translate=\"no\"><strong>FundTransfer<\/strong><\/span> journal entry in your <a href=\"\/pt\/reporting\/marketpay-payments-accounting-report\">Marketplace Payment Accounting Report<\/a>.<\/p>\n<h2 id=\"refund-the-fund-transfer\">Refund the funds transfer<\/h2>\n<p>If you need to revert a previous funds transfer, you can refund the transfer for the full amount or a partial amount. You can revert a fund transfer regardless of the <a href=\"\/pt\/classic-platforms\/verification-process#account-holder-statuses\">account holder status<\/a>. This allows you to reverse a fund transfer from an account even if that account is no longer <span translate=\"no\"><strong>Active<\/strong><\/span>.<\/p>\n<p>To completely or partially refund a funds transfer, make a POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Fund\/latest\/post\/refundFundsTransfer\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/refundFundsTransfer<\/a> request, specifying:<\/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\/Fund\/latest\/post\/refundFundsTransfer#request-originalReference\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">originalReference<\/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 <code>pspReference<\/code> that you received in the response to the original funds transfer.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Fund\/latest\/post\/refundFundsTransfer#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;\">The <code>currency<\/code> and <code>value<\/code> of the funds transfer that you are refunding. This can be the full original amount or part of the original amount.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Fund\/latest\/post\/refundFundsTransfer#request-merchantReference\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">merchantReference<\/a><\/td>\n<td style=\"text-align: center;\"><\/td>\n<td style=\"text-align: left;\">A string that you provide so you can link multiple transactions.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Refund funds transfer request'\" :id=\"''\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/cal-test.adyen.com\\\/cal\\\/services\\\/Fund\\\/v6\\\/refundFundsTransfer \\\\\\n-H 'x-api-key: ADYEN_API_KEY' \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-d '{\\n   \\&quot;originalReference\\&quot;: \\&quot;9914828517650017\\&quot;,\\n   \\&quot;amount\\&quot;: {\\n     \\&quot;currency\\&quot;: \\&quot;EUR\\&quot;,\\n     \\&quot;value\\&quot;: 2000\\n   },\\n  \\&quot;merchantReference\\&quot;: \\&quot;MyTransferReference-6718A\\&quot;\\n}'&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<p>Requests for refunding fund transfers are processed asynchronously so in the response, we only inform you that we received your request. You'll get the result from the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Notification\/latest\/post\/REFUND_FUNDS_TRANSFER\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">REFUND_FUNDS_TRANSFER<\/a> webhook.<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Response'\" :id=\"'refundfundstransfer-response'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n   \\\"pspReference\\\": \\\"8815789044698840\\\",\\n   \\\"resultCode\\\": \\\"Received\\\",\\n   \\\"merchantReference\\\": \\\"YOUR_MERCHANT_REFERENCE\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<p>Successfully refunded fund transfers are reported with a <span translate=\"no\"><strong>FundTransferReversed<\/strong><\/span> journal entry in your <a href=\"\/pt\/reporting\/marketpay-payments-accounting-report\">Marketplace Payment Accounting Report<\/a>.<\/p>\n<h2>See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/classic-platforms\/reconciliation-use-cases\/build-transactional-ledger\"\n                        target=\"_self\"\n                        >\n                    Reconcile fund transfers\n                <\/a><\/li><li><a href=\"\/classic-platforms\/notifications\"\n                        target=\"_self\"\n                        >\n                    Notification webhooks\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/classic-platforms\/fund-transfer","articleFields":{"description":"Transfer funds between accounts using Customer Area or the API.","search_category":"Classic Platforms","id":"25142910","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"26-05-2020 12:23","parameters":{"directoryPath":"\/classic-platforms"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/classic-platforms\/fund-transfer","title":"Fund transfer","content":"\nThis page is for classic Adyen for Platforms integrations. If you are just starting your implementation, refer to our new integration guide instead.\n\nDepending on your use cases, there might be scenarios that require you to move funds between accounts in your platform. Some examples are if you want to send a bonus, or when it is necessary to transfer funds from one account holder's account to another.\nYou can transfer funds between accounts using:\n\nAn API request.\nYour Customer Area.\n\nAfter the funds have been transferred, you can also fully or partially refund a funds transfer using an API request.\nRequirements\nBefore you can transfer funds or refund a fund transfer, you must:\n\n\nContact our Support Team to enable fund transfers and define your transfer codes. These codes specify the reason for the transfer and must be defined for your platform in compliance with local regulations.\n\n\nSet up notification webhooks for event types  TRANSFER_FUNDS and  REFUND_FUNDS_TRANSFER. Fund transfers and refund fund transfers are processed asynchronously, so you must rely on webhooks to know the outcome of your requests.\n\n\nTransfer funds through the API\nYou can use the  \/transferFunds endpoint  to programmatically initiate a fund transfer. In your POST request, specify:\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\nsourceAccountCode\n\nThe code of the account from which the funds are to be debited. The status of the account's account holder be Active and payouts must be allowed.\n\n\ndestinationAccountCode\n\nThe code of the account to which the funds are to be credited. The status of the account's account holder must be Active and processing must be allowed.\n\n\n amount\n\nThe currency and value of the fund transfer.\n\n\ntransferCode\n\nThe reason for the transfer, preconfigured on Adyen's side. If you haven't defined this yet, contact our Support Team.\n\n\n merchantReference\n\nA string that you provide so you can link multiple transactions.\n\n\n\n\n    \n\nRequests for fund transfers are processed asynchronously so in the response, we only inform you that we received your request. You'll get the result from the  TRANSFER_FUNDS webhook.\nThe response returns a pspReference. You'll need the pspReference in case you have to refund the funds transfer.\n\n    \n\nSuccessful fund transfers are reported with a FundTransfer journal entry in your Marketplace Payment Accounting Report.\nTransfer funds through Customer Area\nYou can use the Customer Area to manually transfer funds. To do this you must have the Perform and manage Fund Transfers from the customer area role for your Customer Area user. If you do not have the role, contact your Admin user.\nTo transfer funds through Customer Area:\n\nLog in to your Customer Area and switch to your merchant account.\nGo to Platform &gt; Sub-merchant.\nSelect the source account holder, then select the Accounts tab. The source account holder must have an active status and have payouts allowed.\nSelect the more actions menu () then select Transfer to another account.\n\nIn the New transfer page, specify:\n\nThe source account. The source account must have a positive balance.\nThe destination accounts. The account's account holder must have an active status and have processing allowed.\nThe amount to be transferred.\n\nThen select the transfer code from the drop-down list. These codes are configured on Adyen's side. If you haven't defined this yet, contact our Support Team.\n\nSelect Transfer to initiate the fund transfer.\n\nYou can check the status of the transfer in the Transactions tab. You can also get the result from the  TRANSFER_FUNDS webhook.\nSuccessful fund transfers are reported with a FundTransfer journal entry in your Marketplace Payment Accounting Report.\nRefund the funds transfer\nIf you need to revert a previous funds transfer, you can refund the transfer for the full amount or a partial amount. You can revert a fund transfer regardless of the account holder status. This allows you to reverse a fund transfer from an account even if that account is no longer Active.\nTo completely or partially refund a funds transfer, make a POST  \/refundFundsTransfer request, specifying:\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\n originalReference\n\nThe pspReference that you received in the response to the original funds transfer.\n\n\n amount\n\nThe currency and value of the funds transfer that you are refunding. This can be the full original amount or part of the original amount.\n\n\n merchantReference\n\nA string that you provide so you can link multiple transactions.\n\n\n\n\n    \n\nRequests for refunding fund transfers are processed asynchronously so in the response, we only inform you that we received your request. You'll get the result from the  REFUND_FUNDS_TRANSFER webhook.\n\n    \n\nSuccessfully refunded fund transfers are reported with a FundTransferReversed journal entry in your Marketplace Payment Accounting Report.\nSee also\n\n\n                    Reconcile fund transfers\n                \n                    Notification webhooks\n                \n","type":"page","locale":"pt","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Classic integration","lvl2":"Fund transfer"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/classic-platforms","lvl2":"\/pt\/classic-platforms\/fund-transfer"},"levels":3,"category":"Classic Platforms","category_color":"green","tags":["transfer"]}}