{"title":"Transaction webhooks","category":"default","creationDate":1776961628,"content":"<p>When a funds transfer takes place between one of your user's balance accounts and a counterparty bank account, balance account, or card, Adyen sends a transaction webhook to your server. This webhook informs your server that Adyen has deducted funds from or credited funds to your balance account.<\/p>\n<p> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transaction-webhooks\/latest\/overview\" class=\" external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Transaction webhooks<\/a> can be used in combination with  <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 stay fully up to date about the status of your transfers. While a transfer webhook is sent for every status change, transaction webhooks are only sent when the funds from the transfer are credited or debited from the balance account.<\/p>\n<h2>Requirements<\/h2>\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;\">You must have an <a href=\"\/pt\/adyen-for-platforms-model\/\">Adyen for Platforms<\/a>, <a href=\"\/pt\/issuing\/account-structure-resources\/issuing-enterprise\/\">Issuing<\/a>, or <a href=\"\/pt\/payouts\/payout-service\/\">Payouts<\/a> integration.<\/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 following webhook(s): <ul><li markdown=\"1\"><a href=\"\/pt\/development-resources\/webhooks\/webhook-types#webhook-structure\">Standard webhooks<\/a><\/li><li markdown=\"1\"> <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> (optional)<\/li><li markdown=\"1\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transaction-webhooks\/latest\/overview\" class=\" external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Transaction webhooks<\/a><\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Setup steps<\/strong><\/td>\n<td style=\"text-align: left;\">Before you begin: <ul><li markdown=\"1\">Make sure that your server can <a href=\"\/pt\/development-resources\/webhooks\/configure-and-manage\">receive and accept webhooks<\/a>.<\/li><\/ul><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>Types of transaction webhooks<\/h2>\n<p>The values returned in the transaction webhook can vary depending on the following factors:<\/p>\n<ul>\n<li>Whether you are <strong>sending funds from (outgoing)<\/strong>, or <strong>receiving funds to (incoming)<\/strong>, the balance account.<\/li>\n<li>Whether the transfer is <strong>internal<\/strong> or <strong>external<\/strong>.<\/li>\n<\/ul>\n<h2>Sending funds (outgoing)<\/h2>\n <p>Adyen sends webhooks for:<\/p>\n<ul>\n<li><a href=\"#outgoing-external-transactions\">Outgoing external transactions<\/a>: transactions that result from <a href=\"\/pt\/business-accounts\/send-funds\">transfers to third-party bank accounts<\/a>.<\/li>\n<li><a href=\"#outgoing-internal-transactions\">Outgoing internal transactions<\/a> (incoming internal direct debit): transactions that result from <a href=\"\/pt\/business-accounts\/transfer-funds-internally\">sending funds from a balance account to another<\/a>.<\/li>\n<\/ul>\n<h3>Outgoing external transactions<\/h3>\n<ol>\n<li>\n<p>You send a POST <a href=\"https:\/\/docs.adyen.com\/api-explorer\/#\/transfers\/latest\/post\/transfers\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/transfers<\/a> requesting a EUR 100.00 transfer to a third-party bank account.<\/p>\n<div class=\"accordion-shortcode adl-accordion adl-accordion--max-height-transition\" data-expand=\"true\" data-ignore=\"anchorjs-link\">\n    \n    <div class=\"adl-accordion__item\" style=\"\">\n        <div tabindex=\"0\" role=\"item\" aria-expanded=\"false\" class=\"adl-accordion__header\">\n            <i class=\"adl-accordion__toggle adl-icon-chevron-down\"><\/i>\n            <div class=\"adl-accordion__title-wrapper\" data-accordion=\"#outgoing-external-transfer-request\">\n                                    <h4 class=\"adl-accordion__title\">Outgoing external transfer request<\/h4>\n                            <\/div>\n        <\/div>\n        <div role=\"region\" class=\"adl-accordion__content\">\n            \n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Outgoing external transfer request'\" :id=\"'outgoing-external-request'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"amount\\\": {\\n        \\\"currency\\\": \\\"EUR\\\",\\n        \\\"value\\\": 150000\\n    },\\n    \\\"category\\\": \\\"bank\\\",\\n    \\\"priority\\\": \\\"regular\\\",\\n    \\\"balanceAccountId\\\": \\\"BA00000000000000000000001\\\",\\n    \\\"counterparty\\\": {\\n        \\\"bankAccount\\\": {\\n            \\\"accountHolder\\\": {\\n                \\\"fullName\\\": \\\"A. Klaassen\\\"\\n            },\\n            \\\"accountIdentification\\\": {\\n                \\\"type\\\": \\\"iban\\\",\\n                \\\"iban\\\": \\\"NL91ABNA0417164300\\\"\\n            }\\n        }\\n    },\\n    \\\"referenceForBeneficiary\\\": \\\"Your reference sent to the beneficiary\\\",\\n    \\\"reference\\\": \\\"Your internal reference\\\",\\n    \\\"description\\\": \\\"Your description of the transfer\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n\n        <\/div>\n    <\/div>\n<\/div>\n\n<\/li>\n<li>\n<p>After the transfer is <a href=\"\/business-accounts\/third-party-transfer-webhooks\/#outgoing-bank-transfer-booked\">\n  <strong>booked<\/strong>\n<\/a>, Adyen sends a  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transaction-webhooks\/latest\/post\/balancePlatform.transaction.created\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balancePlatform.transaction.created<\/a> webhook with the following information:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter<\/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\/transaction-webhooks\/latest\/post\/balancePlatform.transaction.created#request-data-accountHolder\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">accountHolder<\/a><\/td>\n<td style=\"text-align: left;\">An object containing information about the account holder that owns the source balance account.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transaction-webhooks\/latest\/post\/balancePlatform.transaction.created#request-data-amount\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">amount<\/a><\/td>\n<td style=\"text-align: left;\">An object containing the value and currency of the transaction.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transaction-webhooks\/latest\/post\/balancePlatform.transaction.created#request-data-balanceAccount\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balanceAccount<\/a><\/td>\n<td style=\"text-align: left;\">The balance account that sends the funds.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transaction-webhooks\/latest\/post\/balancePlatform.transaction.created#request-data-id\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">id<\/a><\/td>\n<td style=\"text-align: left;\">The unique identifier of the transaction event.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transaction-webhooks\/latest\/post\/balancePlatform.transaction.created#request-data-transfer\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">transfer<\/a><\/td>\n<td style=\"text-align: left;\">An object containing information about the related transfer.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div class=\"accordion-shortcode adl-accordion adl-accordion--max-height-transition\" data-expand=\"true\" data-ignore=\"anchorjs-link\">\n    \n    <div class=\"adl-accordion__item\" style=\"\">\n        <div tabindex=\"0\" role=\"item\" aria-expanded=\"false\" class=\"adl-accordion__header\">\n            <i class=\"adl-accordion__toggle adl-icon-chevron-down\"><\/i>\n            <div class=\"adl-accordion__title-wrapper\" data-accordion=\"#outgoing-external-transaction-webhook\">\n                                    <h4 class=\"adl-accordion__title\">Outgoing external transaction webhook<\/h4>\n                            <\/div>\n        <\/div>\n        <div role=\"region\" class=\"adl-accordion__content\">\n            \n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Outgoing external transaction created'\" :id=\"'outgoing-external-transaction-webhook'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"data\\\": {\\n        \\\"id\\\": \\\"EVJN00000000000000000000000001EUR\\\",\\n        \\\"amount\\\": {\\n            \\\"value\\\": -10000,\\n            \\\"currency\\\": \\\"EUR\\\"\\n        },\\n        \\\"status\\\": \\\"booked\\\",\\n        \\\"transfer\\\": {\\n            \\\"categoryData\\\": {\\n                \\\"priority\\\": \\\"regular\\\",\\n                \\\"type\\\": \\\"bank\\\"\\n            },    \\n            \\\"id\\\": \\\"3JNC3O5ZVFLLGV4B\\\",\\n            \\\"reference\\\": \\\"Your internal reference of the transfer\\\"\\n        },\\n        \\\"valueDate\\\": \\\"2023-08-11T16:19:35+02:00\\\",\\n        \\\"bookingDate\\\": \\\"2023-08-11T16:31:02+02:00\\\",\\n        \\\"creationDate\\\": \\\"2023-08-11T16:19:35+02:00\\\",\\n        \\\"description\\\": \\\"Your description of the transfer\\\",\\n        \\\"referenceForBeneficiary\\\": \\\"Your reference sent to the beneficiary\\\",\\n        \\\"accountHolder\\\": {\\n            \\\"id\\\": \\\"AH00000000000000000000001\\\",\\n            \\\"reference\\\": \\\"Your reference for the account holder\\\",\\n            \\\"description\\\": \\\"Your description of the account holder\\\"\\n        },\\n        \\\"balanceAccount\\\": {\\n            \\\"id\\\": \\\"BA00000000000000000000001\\\",\\n            \\\"description\\\": \\\"Your description of the balance account\\\"\\n        },\\n        \\\"paymentInstrument\\\": {\\n            \\\"id\\\": \\\"PI00000000000000000000001\\\",\\n            \\\"description\\\": \\\"Your description of the payment instrument\\\"\\n        },\\n        \\\"balancePlatform\\\": \\\"YOUR_BALANCE_PLATFORM\\\"\\n    },\\n    \\\"environment\\\": \\\"test\\\",\\n    \\\"type\\\": \\\"balancePlatform.transaction.created\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n\n        <\/div>\n    <\/div>\n<\/div>\n\n<\/li>\n<\/ol>\n<h3>Outgoing internal transactions<\/h3>\n <ol>\n<li>\n<p>You send a POST <a href=\"https:\/\/docs.adyen.com\/api-explorer\/#\/transfers\/latest\/post\/transfers\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/transfers<\/a> requesting a EUR 100.00 transfer between two balance accounts in your platform.<\/p>\n<div class=\"accordion-shortcode adl-accordion adl-accordion--max-height-transition\" data-expand=\"true\" data-ignore=\"anchorjs-link\">\n    \n    <div class=\"adl-accordion__item\" style=\"\">\n        <div tabindex=\"0\" role=\"item\" aria-expanded=\"false\" class=\"adl-accordion__header\">\n            <i class=\"adl-accordion__toggle adl-icon-chevron-down\"><\/i>\n            <div class=\"adl-accordion__title-wrapper\" data-accordion=\"#outgoing-internal-transfer-request\">\n                                    <h4 class=\"adl-accordion__title\">Outgoing internal transfer request<\/h4>\n                            <\/div>\n        <\/div>\n        <div role=\"region\" class=\"adl-accordion__content\">\n            \n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Internal direct debit request'\" :id=\"'internal-direct-debit-request'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"amount\\\": {\\n        \\\"currency\\\": \\\"EUR\\\",\\n        \\\"value\\\": \\\"10000\\\"\\n    },\\n    \\\"balanceAccountId\\\": \\\"BA00000000000000000000001\\\",\\n    \\\"category\\\": \\\"internal\\\",\\n    \\\"counterparty\\\": {\\n        \\\"balanceAccountId\\\": \\\"BA00000000000000000000002\\\"\\n    },\\n    \\\"description\\\": \\\"Your description for the transfer\\\",\\n    \\\"reference\\\": \\\"Your internal reference for the transfer\\\",\\n    \\\"referenceForBeneficiary\\\": \\\"Your reference for the beneficiary of the transfer\\\",\\n    \\\"type\\\": \\\"internalDirectDebit\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n\n        <\/div>\n    <\/div>\n<\/div>\n\n<\/li>\n<li>\n<p>After the transfer is <a href=\"\/business-accounts\/third-party-transfer-webhooks\/#outgoing-bank-transfer-booked\">\n  <strong>booked<\/strong>\n<\/a>, Adyen sends a  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transaction-webhooks\/latest\/post\/balancePlatform.transaction.created\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balancePlatform.transaction.created<\/a> webhook with the following information:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter<\/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\/transaction-webhooks\/latest\/post\/balancePlatform.transaction.created#request-data-accountHolder\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">accountHolder<\/a><\/td>\n<td style=\"text-align: left;\">An object containing information about the account holder that owns the source balance account.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transaction-webhooks\/latest\/post\/balancePlatform.transaction.created#request-data-amount\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">amount<\/a><\/td>\n<td style=\"text-align: left;\">An object containing the value and currency of the transaction.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transaction-webhooks\/latest\/post\/balancePlatform.transaction.created#request-data-balanceAccount\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balanceAccount<\/a><\/td>\n<td style=\"text-align: left;\">The balance account that receives the direct debit request and from which the funds are debited.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transaction-webhooks\/latest\/post\/balancePlatform.transaction.created#request-data-id\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">id<\/a><\/td>\n<td style=\"text-align: left;\">The unique identifier of the transaction event.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transaction-webhooks\/latest\/post\/balancePlatform.transaction.created#request-data-transfer\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">transfer<\/a><\/td>\n<td style=\"text-align: left;\">An object containing information about the related transfer.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div class=\"accordion-shortcode adl-accordion adl-accordion--max-height-transition\" data-expand=\"true\" data-ignore=\"anchorjs-link\">\n    \n    <div class=\"adl-accordion__item\" style=\"\">\n        <div tabindex=\"0\" role=\"item\" aria-expanded=\"false\" class=\"adl-accordion__header\">\n            <i class=\"adl-accordion__toggle adl-icon-chevron-down\"><\/i>\n            <div class=\"adl-accordion__title-wrapper\" data-accordion=\"#outgoing-internal-transaction-webhook\">\n                                    <h4 class=\"adl-accordion__title\">Outgoing internal transaction webhook<\/h4>\n                            <\/div>\n        <\/div>\n        <div role=\"region\" class=\"adl-accordion__content\">\n            \n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Outgoing internal transaction created'\" :id=\"'outgoing-internal-transaction-webhook'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"data\\\": {\\n        \\\"id\\\": \\\"EVJN00000000000000000000000001EUR\\\",\\n        \\\"amount\\\": {\\n            \\\"value\\\": -10000,\\n            \\\"currency\\\": \\\"EUR\\\"\\n        },\\n        \\\"status\\\": \\\"booked\\\",\\n        \\\"transfer\\\": {\\n            \\\"categoryData\\\": {\\n                \\\"type\\\": \\\"internal\\\"\\n            },\\n            \\\"id\\\": \\\"48TYZO5ZVURJ2FCW\\\",\\n            \\\"reference\\\": \\\"Your internal reference for the transfer\\\"\\n        },\\n        \\\"valueDate\\\": \\\"2023-08-11T16:19:35+02:00\\\",\\n        \\\"bookingDate\\\": \\\"2023-08-11T16:19:38+02:00\\\",\\n        \\\"creationDate\\\": \\\"2023-08-11T16:19:35+02:00\\\",\\n        \\\"description\\\": \\\"Your description for the transfer\\\",\\n        \\\"referenceForBeneficiary\\\": \\\"Your reference for the beneficiary of the transfer\\\",\\n        \\\"accountHolder\\\": {\\n            \\\"id\\\": \\\"AH00000000000000000000001\\\",\\n            \\\"description\\\": \\\"Your description of the account holder\\\",\\n            \\\"reference\\\": \\\"Your reference of the account holder\\\"\\n        },\\n        \\\"balanceAccount\\\": {\\n            \\\"id\\\": \\\"BA00000000000000000000001\\\",\\n            \\\"description\\\": \\\"Your description of the balance account\\\"\\n        },\\n        \\\"balancePlatform\\\": \\\"YOUR_BALANCE_PLATFORM\\\"\\n    },\\n    \\\"type\\\": \\\"balancePlatform.transaction.created\\\",\\n    \\\"environment\\\": \\\"test\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n\n        <\/div>\n    <\/div>\n<\/div>\n\n<\/li>\n<\/ol>\n<h2>Receiving funds (incoming)<\/h2>\n <p>Adyen sends webhooks for:<\/p>\n<ul>\n<li><a href=\"#incoming-external-transactions\">Incoming external transactions<\/a>: transactions that result from <a href=\"\/pt\/business-accounts\/receive-funds\">receiving funds from a third-party bank account<\/a>.<\/li>\n<li><a href=\"#incoming-internal-transactions\">Incoming internal transactions<\/a>: transactions that result from a balance account <a href=\"\/pt\/business-accounts\/transfer-funds-internally\">receiving funds from another balance account<\/a>.<\/li>\n<\/ul>\n <h3>Incoming external transactions<\/h3>\n<p>After an incoming third-party transfer is <a href=\"\/pt\/business-accounts\/third-party-transfer-webhooks\/#incoming-bank-transfer-booked\">\n  <strong>booked<\/strong>\n<\/a> into your user's account, Adyen sends a  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transaction-webhooks\/latest\/post\/balancePlatform.transaction.created\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balancePlatform.transaction.created<\/a> webhook with the following information:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter<\/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\/transaction-webhooks\/latest\/post\/balancePlatform.transaction.created#request-data-accountHolder\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">accountHolder<\/a><\/td>\n<td style=\"text-align: left;\">An object containing information about the account holder that owns the target balance account.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transaction-webhooks\/latest\/post\/balancePlatform.transaction.created#request-data-amount\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">amount<\/a><\/td>\n<td style=\"text-align: left;\">An object containing the value and currency of the transaction.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transaction-webhooks\/latest\/post\/balancePlatform.transaction.created#request-data-balanceAccount\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balanceAccount<\/a><\/td>\n<td style=\"text-align: left;\">The balance account that receives the funds.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transaction-webhooks\/latest\/post\/balancePlatform.transaction.created#request-data-id\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">id<\/a><\/td>\n<td style=\"text-align: left;\">The unique identifier of the transaction event.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transaction-webhooks\/latest\/post\/balancePlatform.transaction.created#request-data-transfer\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">transfer<\/a><\/td>\n<td style=\"text-align: left;\">An object containing information about the related transfer.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div class=\"accordion-shortcode adl-accordion adl-accordion--max-height-transition\" data-expand=\"true\" data-ignore=\"anchorjs-link\">\n    \n    <div class=\"adl-accordion__item\" style=\"\">\n        <div tabindex=\"0\" role=\"item\" aria-expanded=\"false\" class=\"adl-accordion__header\">\n            <i class=\"adl-accordion__toggle adl-icon-chevron-down\"><\/i>\n            <div class=\"adl-accordion__title-wrapper\" data-accordion=\"#incoming-external-transaction-webhook\">\n                                    <h4 class=\"adl-accordion__title\">Incoming external transaction webhook<\/h4>\n                            <\/div>\n        <\/div>\n        <div role=\"region\" class=\"adl-accordion__content\">\n            \n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Incoming external transaction created'\" :id=\"'incoming-external-transaction-webhook'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"data\\\": {\\n        \\\"id\\\": \\\"EVJN00000000000000000000000001EUR\\\",\\n        \\\"amount\\\": {\\n            \\\"value\\\": 10000,\\n            \\\"currency\\\": \\\"EUR\\\"\\n        },\\n        \\\"status\\\": \\\"booked\\\",\\n        \\\"transfer\\\": {\\n            \\\"categoryData\\\": {\\n                \\\"priority\\\": \\\"regular\\\",\\n                \\\"type\\\": \\\"bank\\\"\\n            },\\n            \\\"id\\\": \\\"3JW8PC5ZVV06067J\\\",\\n            \\\"reference\\\": \\\"automatically-generated-reference\\\"\\n        },\\n        \\\"valueDate\\\": \\\"2023-08-11T16:19:35+02:00\\\",\\n        \\\"bookingDate\\\": \\\"2023-08-11T16:43:46+02:00\\\",\\n        \\\"creationDate\\\": \\\"2023-08-11T16:43:46+02:00\\\",\\n        \\\"accountHolder\\\": {\\n            \\\"id\\\": \\\"AH00000000000000000000001\\\",\\n            \\\"description\\\": \\\"Your description of the account holder\\\"\\n        },\\n        \\\"balanceAccount\\\": {\\n            \\\"id\\\": \\\"BA00000000000000000000001\\\",\\n            \\\"description\\\": \\\"Your description of the balance account\\\"\\n        },\\n        \\\"paymentInstrument\\\": {\\n            \\\"id\\\": \\\"PI00000000000000000000001\\\",\\n            \\\"description\\\": \\\"Your description of the payment instrument\\\"\\n        },\\n        \\\"balancePlatform\\\": \\\"YOUR_BALANCE_PLATFORM\\\"\\n    },\\n    \\\"environment\\\": \\\"test\\\",\\n    \\\"type\\\": \\\"balancePlatform.transaction.created\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n\n        <\/div>\n    <\/div>\n<\/div>\n\n<h3>Incoming internal transactions<\/h3>\n <p>After an incoming internal transfer is <a href=\"\/pt\/business-accounts\/transfer-funds-internally#3-internal-direct-debit-booked\">\n  <strong>booked<\/strong>\n<\/a> to your user's account, Adyen sends a  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transaction-webhooks\/latest\/post\/balancePlatform.transaction.created\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balancePlatform.transaction.created<\/a> webhook with the following information:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter<\/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\/transaction-webhooks\/latest\/post\/balancePlatform.transaction.created#request-data-accountHolder\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">accountHolder<\/a><\/td>\n<td style=\"text-align: left;\">An object containing information about the account holder that owns the target balance account.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transaction-webhooks\/latest\/post\/balancePlatform.transaction.created#request-data-amount\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">amount<\/a><\/td>\n<td style=\"text-align: left;\">An object containing the value and currency of the transaction.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transaction-webhooks\/latest\/post\/balancePlatform.transaction.created#request-data-balanceAccount\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balanceAccount<\/a><\/td>\n<td style=\"text-align: left;\">The balance account that sends the direct debit request and to which the funds are credited.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transaction-webhooks\/latest\/post\/balancePlatform.transaction.created#request-data-id\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">id<\/a><\/td>\n<td style=\"text-align: left;\">The unique identifier of the transaction event.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transaction-webhooks\/latest\/post\/balancePlatform.transaction.created#request-data-transfer\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">transfer<\/a><\/td>\n<td style=\"text-align: left;\">An object containing information about the related transfer.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div class=\"accordion-shortcode adl-accordion adl-accordion--max-height-transition\" data-expand=\"true\" data-ignore=\"anchorjs-link\">\n    \n    <div class=\"adl-accordion__item\" style=\"\">\n        <div tabindex=\"0\" role=\"item\" aria-expanded=\"false\" class=\"adl-accordion__header\">\n            <i class=\"adl-accordion__toggle adl-icon-chevron-down\"><\/i>\n            <div class=\"adl-accordion__title-wrapper\" data-accordion=\"#incoming-internal-transaction-webhook\">\n                                    <h4 class=\"adl-accordion__title\">Incoming internal transaction webhook<\/h4>\n                            <\/div>\n        <\/div>\n        <div role=\"region\" class=\"adl-accordion__content\">\n            \n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Incoming internal transaction created'\" :id=\"'incoming-internal-transaction-webhook'\" :code-data=\"[{&quot;language&quot;:&quot;json&quot;,&quot;tabTitle&quot;:&quot;&quot;,&quot;content&quot;:&quot;{\\n    \\&quot;data\\&quot;: {\\n        \\&quot;id\\&quot;: \\&quot;EVJN00000000000000000000000002EUR\\&quot;,\\n        \\&quot;amount\\&quot;: {\\n            \\&quot;value\\&quot;: 10000,\\n            \\&quot;currency\\&quot;: \\&quot;EUR\\&quot;\\n        },\\n        \\&quot;status\\&quot;: \\&quot;booked\\&quot;,\\n        \\&quot;transfer\\&quot;: {\\n            \\&quot;categoryData\\&quot;: {\\n                \\&quot;type\\&quot;: \\&quot;internal\\&quot;\\n            },\\n            \\&quot;id\\&quot;: \\&quot;3JW8PC5ZVV06067J\\&quot;,\\n            \\&quot;reference\\&quot;: \\&quot;The sender's reference of the transfer\\&quot;\\n        },\\n        \\&quot;valueDate\\&quot;: \\&quot;2023-08-11T16:19:35+02:00\\&quot;,\\n        \\&quot;bookingDate\\&quot;: \\&quot;2023-08-11T16:43:46+02:00\\&quot;,\\n        \\&quot;creationDate\\&quot;: \\&quot;2023-08-11T16:43:46+02:00\\&quot;,\\n        \\&quot;description\\&quot;: \\&quot;The sender's description of the transfer\\&quot;,\\n        \\&quot;referenceForBeneficiary\\&quot;: \\&quot;The sender's reference for the beneficiary\\&quot;,\\n        \\&quot;accountHolder\\&quot;: {\\n            \\&quot;id\\&quot;: \\&quot;AH00000000000000000000001\\&quot;,\\n            \\&quot;reference\\&quot;: \\&quot;Your reference of the account holder\\&quot;,\\n            \\&quot;description\\&quot;: \\&quot;Your description of the account holder\\&quot;\\n        },\\n        \\&quot;balanceAccount\\&quot;: {\\n            \\&quot;id\\&quot;: \\&quot;BA00000000000000000000002\\&quot;,\\n            \\&quot;description\\&quot;: \\&quot;Your description of the balance account\\&quot;\\n        },\\n        \\&quot;balancePlatform\\&quot;: \\&quot;YOUR_BALANCE_PLATFORM\\&quot;\\n    },\\n    \\&quot;type\\&quot;: \\&quot;balancePlatform.transaction.created\\&quot;,\\n    \\&quot;environment\\&quot;: \\&quot;test\\&quot;\\n}&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n\n        <\/div>\n    <\/div>\n<\/div>\n\n<h2 id=\"see-also\">See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/business-accounts\/third-party-transfer-webhooks\"\n                        target=\"_self\"\n                        >\n                    Third-party transfer webhooks\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/business-accounts\/transactions\/transaction-webhooks","articleFields":{"description":"Find out which webhooks Adyen sends for transfers involving third-party bank accounts.","feedback_component":true,"type":"page","_expandable":null,"operations":"","status":"current","parameters":{"directoryPath":"\/business-accounts","model":"balance platform","transferType":"bank"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/business-accounts\/transactions\/transaction-webhooks","title":"Transaction webhooks","content":"When a funds transfer takes place between one of your user's balance accounts and a counterparty bank account, balance account, or card, Adyen sends a transaction webhook to your server. This webhook informs your server that Adyen has deducted funds from or credited funds to your balance account.\n Transaction webhooks can be used in combination with  Transfer webhooks to stay fully up to date about the status of your transfers. While a transfer webhook is sent for every status change, transaction webhooks are only sent when the funds from the transfer are credited or debited from the balance account.\nRequirements\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nYou must have an Adyen for Platforms, Issuing, or Payouts integration.\n\n\nWebhooks\nSubscribe to the following webhook(s): Standard webhooks Transfer webhooks (optional) Transaction webhooks\n\n\nSetup steps\nBefore you begin: Make sure that your server can receive and accept webhooks.\n\n\n\nTypes of transaction webhooks\nThe values returned in the transaction webhook can vary depending on the following factors:\n\nWhether you are sending funds from (outgoing), or receiving funds to (incoming), the balance account.\nWhether the transfer is internal or external.\n\nSending funds (outgoing)\n Adyen sends webhooks for:\n\nOutgoing external transactions: transactions that result from transfers to third-party bank accounts.\nOutgoing internal transactions (incoming internal direct debit): transactions that result from sending funds from a balance account to another.\n\nOutgoing external transactions\n\n\nYou send a POST \/transfers requesting a EUR 100.00 transfer to a third-party bank account.\n\n    \n    \n        \n            \n            \n                                    Outgoing external transfer request\n                            \n        \n        \n            \n\n\n\n\n        \n    \n\n\n\n\nAfter the transfer is \n  booked\n, Adyen sends a  balancePlatform.transaction.created webhook with the following information:\n\n\n\nParameter\nDescription\n\n\n\n\n accountHolder\nAn object containing information about the account holder that owns the source balance account.\n\n\n amount\nAn object containing the value and currency of the transaction.\n\n\n balanceAccount\nThe balance account that sends the funds.\n\n\n id\nThe unique identifier of the transaction event.\n\n\n transfer\nAn object containing information about the related transfer.\n\n\n\n\n    \n    \n        \n            \n            \n                                    Outgoing external transaction webhook\n                            \n        \n        \n            \n\n\n\n\n        \n    \n\n\n\n\nOutgoing internal transactions\n \n\nYou send a POST \/transfers requesting a EUR 100.00 transfer between two balance accounts in your platform.\n\n    \n    \n        \n            \n            \n                                    Outgoing internal transfer request\n                            \n        \n        \n            \n\n\n\n\n        \n    \n\n\n\n\nAfter the transfer is \n  booked\n, Adyen sends a  balancePlatform.transaction.created webhook with the following information:\n\n\n\nParameter\nDescription\n\n\n\n\n accountHolder\nAn object containing information about the account holder that owns the source balance account.\n\n\n amount\nAn object containing the value and currency of the transaction.\n\n\n balanceAccount\nThe balance account that receives the direct debit request and from which the funds are debited.\n\n\n id\nThe unique identifier of the transaction event.\n\n\n transfer\nAn object containing information about the related transfer.\n\n\n\n\n    \n    \n        \n            \n            \n                                    Outgoing internal transaction webhook\n                            \n        \n        \n            \n\n\n\n\n        \n    \n\n\n\n\nReceiving funds (incoming)\n Adyen sends webhooks for:\n\nIncoming external transactions: transactions that result from receiving funds from a third-party bank account.\nIncoming internal transactions: transactions that result from a balance account receiving funds from another balance account.\n\n Incoming external transactions\nAfter an incoming third-party transfer is \n  booked\n into your user's account, Adyen sends a  balancePlatform.transaction.created webhook with the following information:\n\n\n\nParameter\nDescription\n\n\n\n\n accountHolder\nAn object containing information about the account holder that owns the target balance account.\n\n\n amount\nAn object containing the value and currency of the transaction.\n\n\n balanceAccount\nThe balance account that receives the funds.\n\n\n id\nThe unique identifier of the transaction event.\n\n\n transfer\nAn object containing information about the related transfer.\n\n\n\n\n    \n    \n        \n            \n            \n                                    Incoming external transaction webhook\n                            \n        \n        \n            \n\n    \n\n\n        \n    \n\n\nIncoming internal transactions\n After an incoming internal transfer is \n  booked\n to your user's account, Adyen sends a  balancePlatform.transaction.created webhook with the following information:\n\n\n\nParameter\nDescription\n\n\n\n\n accountHolder\nAn object containing information about the account holder that owns the target balance account.\n\n\n amount\nAn object containing the value and currency of the transaction.\n\n\n balanceAccount\nThe balance account that sends the direct debit request and to which the funds are credited.\n\n\n id\nThe unique identifier of the transaction event.\n\n\n transfer\nAn object containing information about the related transfer.\n\n\n\n\n    \n    \n        \n            \n            \n                                    Incoming internal transaction webhook\n                            \n        \n        \n            \n\n    \n\n\n        \n    \n\n\nSee also\n\n\n                    Third-party transfer webhooks\n                \n","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Business accounts","lvl2":"Track transactions related to third-party transfers","lvl3":"Transaction webhooks"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/business-accounts","lvl2":"https:\/\/docs.adyen.com\/pt\/business-accounts\/transactions","lvl3":"\/pt\/business-accounts\/transactions\/transaction-webhooks"},"levels":4,"category":"","category_color":"","tags":["Transaction","webhooks"]},"articleFiles":{"incoming-external-transaction-webhook.json":"<p alt=\"\">incoming-external-transaction-webhook.json<\/p>","outgoing-external-request.json":"<p alt=\"\">outgoing-external-request.json<\/p>","outgoing-external-transaction-webhook.json":"<p alt=\"\">outgoing-external-transaction-webhook.json<\/p>"}}