{"title":"Payout notifications","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>After a payout is initiated, Adyen sends an  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Notification\/latest\/post\/ACCOUNT_HOLDER_PAYOUT\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">ACCOUNT_HOLDER_PAYOUT<\/a> notification for each status update of the payout. The notification may contain any of the following <code>status.statusCode<\/code>:<\/p>\n<ul>\n<li><a href=\"#payout-initiated\">\n  <span translate=\"no\">\n    <strong>Initiated<\/strong>\n  <\/span>\n<\/a><\/li>\n<li><a href=\"#payout-confirmed\">\n  <span translate=\"no\">\n    <strong>Confirmed<\/strong>\n  <\/span>\n<\/a><\/li>\n<li><a href=\"#payout-failed\">\n  <span translate=\"no\">\n    <strong>Failed<\/strong>\n  <\/span>\n<\/a><\/li>\n<\/ul>\n<h2 id=\"payout-initiated\">Payout initiated<\/h2>\n<p>Receiving the notification with <code>status.statusCode<\/code> <span translate=\"no\"><strong>Initiated<\/strong><\/span> means that the payout has been scheduled to be sent to the account holder's bank. In this case, you can inform your account holder to expect the funds at the indicated <code>estimatedArrivalDate<\/code>.<\/p>\n<h2 id=\"payout-confirmed\">Payout confirmed<\/h2>\n<p><em>Available in <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Notification\/latest\/post\/ACCOUNT_HOLDER_PAYOUT#request-content-status-statusCode\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Notification v5 or later<\/a>.<\/em><\/p>\n<p>Receiving the notification with <code>status.statusCode<\/code> <span translate=\"no\"><strong>Confirmed<\/strong><\/span> means that the funds have left Adyen and are on their way to the account holder's bank.<\/p>\n<p>You can inform your account holder to expect the funds within a few business days.<\/p>\n<p>From the <span translate=\"no\"><strong>Confirmed<\/strong><\/span> notification you can gather the following details:<\/p>\n<ul>\n<li><code>payoutReference<\/code>: The unique payout id.<\/li>\n<li><code>payoutAccountNumber<\/code>: The account number of the bank from which the payout is initiated.<\/li>\n<li><code>payoutBranchCode<\/code>: The branch code of the bank from which the payout is initiated.<\/li>\n<li><code>payoutAccountCountry<\/code>: The country code of the bank from which the payout is initiated.<\/li>\n<li><code>payoutBankName<\/code>: The name of the bank the payout is made from.<br \/>\nThese details can help your account holder find the payout.<\/li>\n<\/ul>\n<div class=\"notices green\">\n<p>After receiving a <span translate=\"no\"><strong>Confirmed<\/strong><\/span> notification, it is still possible that the payout is returned to Adyen by the receiving bank.<\/p>\n<\/div>\n<h2 id=\"payout-failed\">Payout failed<\/h2>\n<p>Receiving the notification with <code>status.statusCode<\/code> <span translate=\"no\"><strong>Failed<\/strong><\/span> means that the payout failed due to one of the following reasons:<\/p>\n<ul>\n<li><span translate=\"no\"><strong>10_132<\/strong><\/span>: Invalid Account Number.<\/li>\n<li><span translate=\"no\"><strong>10_133<\/strong><\/span>: Invalid ACH Routing Number.<\/li>\n<li><span translate=\"no\"><strong>10_134<\/strong><\/span>: No Account\/Unable to Locate Account.<\/li>\n<li><span translate=\"no\"><strong>10_135<\/strong><\/span>: Account Closed.<\/li>\n<li><span translate=\"no\"><strong>10_069<\/strong><\/span>: Funds have been returned to Adyen.<\/li>\n<li>Validation error. For example, payouts are not enabled for the account holder or you pay out a higher amount than the available payable balance. You receive an <code>invalidFields<\/code> array in the notification.<\/li>\n<\/ul>\n<p>Make sure to update the account holder's bank account details by making a POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Account\/4\/post\/updateAccountHolder\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/updateAccountHolder<\/a> request.<\/p>\n<p>For detailed information on error codes and messages, refer to <a href=\"\/pt\/classic-platforms\/error-codes\">General error codes<\/a>.<\/p>\n<p>A failed payout will have a new <code>pspReference<\/code>, different from the initial payout.<\/p>\n<p>If you set up <a href=\"\/pt\/classic-platforms\/payouts\/scheduled-payout\">scheduled payouts<\/a> and the payout was returned, the account holder's payout state will be automatically disabled. Update their bank account details by making a POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Account\/4\/post\/updateAccountHolder\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/updateAccountHolder<\/a> request and enable the payout state by making a POST <a href=\"https:\/\/docs.adyen.com\/api-explorer\/#\/Account\/updateAccountHolderState\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/updateAccountHolderState<\/a> request. You can link the returned payout to the initial payout using the <a href=\"\/pt\/reporting\/marketpay-payments-accounting-report\">MarketPay payments accounting report<\/a>.<\/p>","url":"https:\/\/docs.adyen.com\/pt\/classic-platforms\/payouts\/payout-notifications","articleFields":{"search_category":"Classic Platforms","feedback_component":true,"last_edit_on":"24-11-2022 14:49","parameters":{"directoryPath":"\/classic-platforms"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/classic-platforms\/payouts\/payout-notifications","title":"Payout notifications","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\nAfter a payout is initiated, Adyen sends an  ACCOUNT_HOLDER_PAYOUT notification for each status update of the payout. The notification may contain any of the following status.statusCode:\n\n\n  \n    Initiated\n  \n\n\n  \n    Confirmed\n  \n\n\n  \n    Failed\n  \n\n\nPayout initiated\nReceiving the notification with status.statusCode Initiated means that the payout has been scheduled to be sent to the account holder's bank. In this case, you can inform your account holder to expect the funds at the indicated estimatedArrivalDate.\nPayout confirmed\nAvailable in Notification v5 or later.\nReceiving the notification with status.statusCode Confirmed means that the funds have left Adyen and are on their way to the account holder's bank.\nYou can inform your account holder to expect the funds within a few business days.\nFrom the Confirmed notification you can gather the following details:\n\npayoutReference: The unique payout id.\npayoutAccountNumber: The account number of the bank from which the payout is initiated.\npayoutBranchCode: The branch code of the bank from which the payout is initiated.\npayoutAccountCountry: The country code of the bank from which the payout is initiated.\npayoutBankName: The name of the bank the payout is made from.\nThese details can help your account holder find the payout.\n\n\nAfter receiving a Confirmed notification, it is still possible that the payout is returned to Adyen by the receiving bank.\n\nPayout failed\nReceiving the notification with status.statusCode Failed means that the payout failed due to one of the following reasons:\n\n10_132: Invalid Account Number.\n10_133: Invalid ACH Routing Number.\n10_134: No Account\/Unable to Locate Account.\n10_135: Account Closed.\n10_069: Funds have been returned to Adyen.\nValidation error. For example, payouts are not enabled for the account holder or you pay out a higher amount than the available payable balance. You receive an invalidFields array in the notification.\n\nMake sure to update the account holder's bank account details by making a POST  \/updateAccountHolder request.\nFor detailed information on error codes and messages, refer to General error codes.\nA failed payout will have a new pspReference, different from the initial payout.\nIf you set up scheduled payouts and the payout was returned, the account holder's payout state will be automatically disabled. Update their bank account details by making a POST  \/updateAccountHolder request and enable the payout state by making a POST \/updateAccountHolderState request. You can link the returned payout to the initial payout using the MarketPay payments accounting report.","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Classic integration","lvl2":"Payouts","lvl3":"Payout notifications"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/classic-platforms","lvl2":"https:\/\/docs.adyen.com\/pt\/classic-platforms\/payouts","lvl3":"\/pt\/classic-platforms\/payouts\/payout-notifications"},"levels":4,"category":"Classic Platforms","category_color":"green","tags":["Payout","notifications"]}}