additionalData.tokenization.storedPaymentMethodId<\/code><\/li>\n<\/ul>\nYou must provide these values when making a bank account payout request.<\/p>\n<\/li>\n<\/ol>","url":"https:\/\/docs.adyen.com\/pt\/payouts\/payout-service\/pay-out-to-bank-accounts\/manage-bank-details","articleFields":{"description":"Learn how to securely process the details of third-party bank accounts.","feedback_component":true,"next_steps":[{"title":"Make a bank account payout request","description":"Pay out your funds to a third-party bank account using the Transfers API.","url":"\/payouts\/payout-service\/pay-out-to-bank-accounts\/bank-payout-request","required":false}],"type":"page","_expandable":{"operations":""},"status":"current","cache_enable":false,"parameters":{"integrationType":"payouts","directoryPath":"\/payouts\/payout-service","payoutType":"third-party"},"filters_component":false,"page_id":"42a76235-52b1-4be4-bdb2-7ae9bd417a01","last_edit_on":"30-11-2023 12:07"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/payouts\/payout-service\/pay-out-to-bank-accounts\/manage-bank-details","title":"Manage bank account details","content":"This page explains how to manage bank account details for third-party payouts. It covers how to securely store bank account details, allowing you to process bank account transfers efficiently.\nTokenization for payouts\nAdyen's tokenization service lets you process payouts to your counterparties using tokenized bank account details. A token is a unique reference for a third party's bank account details, which helps you minimize security risks, simplify data management, and streamline recurring payouts to known recipients.\nRequirements\nBefore you begin, take into account the following requirements, limitations, and preparations.\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nAn Adyen payout service integration and our Checkout API for tokenization.\n\n\nAPI credentials\nYour company (ws@Company.[YourCompanyAccount]) has the following role to use with the Checkout API:Checkout encrypted cardholder data\n\n\nWebhooks\nYour server must be able to receive and accept webhooks.\n\n\nLimitations\nTake the following limitations into account:You cannot use local account details for cross-border transfers. When tokenizing bank details for cross-border payouts, you must use a format that supports them, such as NumberAndBicAccountIdentification.The tokenization service does not validate bank accounts when creating a token. Invalid details may lead to failed payouts later.\n\n\n\n\nSetup steps\nReach out to your Adyen contact to enable the feature on your account.\n\n\n\nSupported countries\/regions\nAdyen currently supports payouts to tokenized local bank account details in the following regions:\n\nEuropeIBANs (SEPA Direct Debit)\nUK Local (BACS)North AmericaUS Local (ACH)\nStore bank account details\nTo tokenize and store bank account details:\n\n\nMake a POST \/payments request, specifying the following parameters:\n\n \n\n\n\nRequest parameter\nRequired\nDescription\n\n\n\n\n amount.currency\n\nSet to the currency that is applicable to the bank account.\n\n\n amount.value\n\nSet to 0 (zero) to combine with a zero-auth payment.\n\n\n paymentMethod\n\nSet to one of the following: sepadirectdebit: SEPA Direct DebitukLocal: UK LocalusLocal: US Local\n\n\n billingAddress\n\nAn object that contains the address details of the bank account.\n\n\n enablePayOut\n\nSet to true.\n\n\n merchantAccount\n\nThe identifier of your merchant account.\n\n\n recurringProcessingModel\n\nSet to Subscription.\n\n\n reference\n\nYour unique reference to identify the payment request.\n\n\n returnUrl\n\nThe return URL to redirect the bank account holder after the payment process.\n\n\n shopperReference\n\nYour unique reference to identify the bank account holder.\n\n\n storePaymentMethod\n\nSet to true.\n\n\n\n\n\n\nThe following code sample shows a zero-auth payment request that creates a token for bank account details.\n\n\n\nThe token is created after a successful payment authorization. This ensures that the payment details are linked to an active, chargeable account.\n\n\nFind the token in the storedPaymentMethodId parameter. You can locate it in either of these places:\n\nIn the successful authorization response, under additionalData.tokenization.storedPaymentMethodId.\nIn the recurring.token.created webhook.\n\nThe following code sample shows an authorized payment response that includes the token.\n\n\n\n\n\nIn your system, store the following parameters together, so that the token is associated with the bank account holder:\n\nadditionalData.tokenization.shopperReference\nadditionalData.tokenization.storedPaymentMethodId\n\nYou must provide these values when making a bank account payout request.\n\n","type":"page","locale":"pt","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"Adyen Payouts","lvl2":"Payouts and Payments","lvl3":"Pay out to bank accounts","lvl4":"Manage bank account details"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/payouts","lvl2":"https:\/\/docs.adyen.com\/pt\/payouts\/payout-service","lvl3":"https:\/\/docs.adyen.com\/pt\/payouts\/payout-service\/pay-out-to-bank-accounts","lvl4":"\/pt\/payouts\/payout-service\/pay-out-to-bank-accounts\/manage-bank-details"},"levels":5,"category":"","category_color":"","tags":["Manage","account","details"]},"articleFiles":{"save-details-raw.js":"
save-details-raw.js<\/p>"}}
![\"-white_check_mark-\"](\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" "\\"-white_check_mark-\\"")
<\/td>\n