{"title":"Track transactions","category":"default","creationDate":1779620071,"content":"<p>Every fund movement in your balance platform results in a transaction. You can track transactions to identify their current state, find out when funds become available, and confirm the outcome. To get transaction data, you can make API requests or receive webhooks in real time.<\/p>\n<h2>Transfer lifecycle<\/h2>\n<p>A transfer moves through several statuses as it is processed by Adyen and the financial networks. Tracking these allows you to confirm exactly where funds are in the reconciliation flow:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Status<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>authorised<\/strong><\/span><\/td>\n<td style=\"text-align: left;\">The transfer request is valid and the funds are reserved.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>booked<\/strong><\/span><\/td>\n<td style=\"text-align: left;\">The funds have been successfully deducted from the source balance account.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>failed<\/strong><\/span><\/td>\n<td style=\"text-align: left;\">The transfer could not be initiated, for example due to insufficient funds.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>refused<\/strong><\/span><\/td>\n<td style=\"text-align: left;\">The transfer was rejected by the clearing system or recipient bank.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>returned<\/strong><\/span><\/td>\n<td style=\"text-align: left;\">The funds were sent but were returned by the receiving bank.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>Choose a tracking method<\/h2>\n<p>You can track transactions using webhooks for real-time updates, or by making API requests on demand.<\/p>\n<div class=\"fingerpost output-inline\">\n<a href=\"\/platforms\/transfer-transactions\/track-webhooks\" class=\"fingerpost__link fingerpost__link--medium\" style=\"overflow:hidden;\" target=\"_self\"><div class=\"fingerpost__body\"><p><img src=\"\/reuse\/pfs-transfers\/transactions\/track-transactions-landing\/\/user\/themes\/adyen-docs\/assets\/icons\/event-code.svg\" alt=\"Webhook icon\" \/><\/p><h2>Real-time tracking (webhooks)<\/h2><p>Track transactions using the Transfers and Transactions webhooks.<\/p><\/div><\/a><a href=\"\/platforms\/transfer-transactions\/track-api\" class=\"fingerpost__link fingerpost__link--medium\" style=\"overflow:hidden;\" target=\"_self\"><div class=\"fingerpost__body\"><p><img src=\"\/reuse\/pfs-transfers\/transactions\/track-transactions-landing\/\/user\/themes\/adyen-docs\/assets\/icons\/api-explorer.svg\" alt=\"API icon\" \/><\/p><h2>Manual tracking (API)<\/h2><p>Track transactions using the Transfers API.<\/p><\/div><\/a><\/div>\n\n<h2>Handle exceptions<\/h2>\n<h3>Failed and refused transfers<\/h3>\n<p>When a transfer has the status <strong>failed<\/strong> or <strong>refused<\/strong>, the funds are not deducted from the balance account. If this happens, notify your user and verify their bank account details or balance status.<\/p>\n<h3>Returned transfers<\/h3>\n<p>A transfer can be returned by the recipient bank several days after it was initiated. When this happens:<\/p>\n<ol>\n<li>Adyen sends a  <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> webhook with the status <strong>returned<\/strong>.<\/li>\n<li>The funds are credited back to the original balance account.<\/li>\n<li>The return is recorded as a separate entry in your <a href=\"\/platforms\/reports-and-fees\/balance-platform-accounting-report\">Balance Platform Accounting Report<\/a>.<\/li>\n<\/ol>\n<h2>See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/platforms\/payout-reconciliation\"\n                        target=\"_self\"\n                        >\n                    Payout reconciliation\n                <\/a><\/li><li><a href=\"\/platforms\/view-transfers-details\"\n                        target=\"_self\"\n                        >\n                    View transfer details\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/platforms\/transfer-transactions","articleFields":{"description":"Use our API and webhooks to get updates about transactions in your balance platform.","feedback_component":true,"filters_component":false,"cache_enable":false,"parameters":{"directoryPath":"\/platforms","model":"platform","transferType":"transfers"}},"algolia":{"url":"https:\/\/docs.adyen.com\/platforms\/transfer-transactions","title":"Track transactions","content":"Every fund movement in your balance platform results in a transaction. You can track transactions to identify their current state, find out when funds become available, and confirm the outcome. To get transaction data, you can make API requests or receive webhooks in real time.\nTransfer lifecycle\nA transfer moves through several statuses as it is processed by Adyen and the financial networks. Tracking these allows you to confirm exactly where funds are in the reconciliation flow:\n\n\n\nStatus\nDescription\n\n\n\n\nauthorised\nThe transfer request is valid and the funds are reserved.\n\n\nbooked\nThe funds have been successfully deducted from the source balance account.\n\n\nfailed\nThe transfer could not be initiated, for example due to insufficient funds.\n\n\nrefused\nThe transfer was rejected by the clearing system or recipient bank.\n\n\nreturned\nThe funds were sent but were returned by the receiving bank.\n\n\n\nChoose a tracking method\nYou can track transactions using webhooks for real-time updates, or by making API requests on demand.\n\nReal-time tracking (webhooks)Track transactions using the Transfers and Transactions webhooks.Manual tracking (API)Track transactions using the Transfers API.\n\nHandle exceptions\nFailed and refused transfers\nWhen a transfer has the status failed or refused, the funds are not deducted from the balance account. If this happens, notify your user and verify their bank account details or balance status.\nReturned transfers\nA transfer can be returned by the recipient bank several days after it was initiated. When this happens:\n\nAdyen sends a  balancePlatform.transfer.updated webhook with the status returned.\nThe funds are credited back to the original balance account.\nThe return is recorded as a separate entry in your Balance Platform Accounting Report.\n\nSee also\n\n\n                    Payout reconciliation\n                \n                    View transfer details\n                \n","type":"page","locale":"en","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Platforms","lvl2":"Track transactions"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/platforms","lvl2":"\/platforms\/transfer-transactions"},"levels":3,"category":"Platforms","category_color":"green","tags":["Track","transactions"]}}