{"title":"Transaction webhooks","category":"default","creationDate":1776961627,"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\/marketplaces\/payout-to-users\">payouts to your users<\/a>.<\/li>\n<li><a href=\"#outgoing-internal-transactions\">Outgoing internal transactions<\/a>: Transactions that result from <a href=\"\/pt\/marketplaces\/internal-fund-transfers\">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 transfer instrument.<\/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       \\\"value\\\": 10000,\\n       \\\"currency\\\": \\\"EUR\\\"\\n    },\\n    \\\"balanceAccountId\\\": \\\"BA00000000000000000000001\\\",\\n    \\\"category\\\": \\\"bank\\\",\\n    \\\"counterparty\\\": {\\n      \\\"transferInstrumentId\\\": \\\"SE00000000000000000000001\\\"\\n    },\\n    \\\"description\\\": \\\"Your description for the transfer\\\",\\n    \\\"priority\\\": \\\"regular\\\",\\n    \\\"referenceForBeneficiary\\\": \\\"Your reference sent to the beneficiary of the transfer\\\",\\n    \\\"reference\\\": \\\"Your internal reference for 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=\"\/marketplaces\/payout-to-users\/payout-webhooks\/#payout-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 of the transfer\\\",\\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        \\\"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 transfer request'\" :id=\"'internal-transfer-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}\"}]' :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=\"\/marketplaces\/payout-to-users\/payout-webhooks\/#payout-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-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\/marketplaces\/top-up-balance-account\">topping up a balance account<\/a>.<\/li>\n<li><a href=\"#incoming-internal-transactions\">Incoming internal transactions<\/a>: transactions that result from a balance account <a href=\"\/pt\/marketplaces\/internal-fund-transfers\">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> to your user's balance 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\\\": \\\"EVJN00000000000000000000000002EUR\\\",\\n        \\\"amount\\\": {\\n            \\\"value\\\": 10000,\\n            \\\"currency\\\": \\\"EUR\\\"\\n        },\\n        \\\"status\\\": \\\"booked\\\",\\n        \\\"transfer\\\": {\\n            \\\"categoryData\\\": {\\n                \\\"modificationMerchantReference\\\": \\\"MRef#000001\\\",\\n                \\\"modificationPspReference\\\": \\\"PPKFQ89R6QRXGN82\\\",\\n                \\\"paymentMerchantReference\\\": \\\"Payment reference\\\",\\n                \\\"platformPaymentType\\\": \\\"BalanceAccount\\\",\\n                \\\"pspPaymentReference\\\": \\\"CWBC43ZX2VTFWR82\\\",\\n                \\\"type\\\": \\\"platformPayment\\\"\\n            },\\n            \\\"id\\\": \\\"3JNC3O5ZVFLLGV4B\\\",\\n            \\\"reference\\\": \\\"automatically-generated-reference\\\"\\n        },\\n        \\\"valueDate\\\": \\\"2023-08-11T16:19:35+02:00\\\",\\n        \\\"bookingDate\\\": \\\"2023-08-11T16:19:45+02:00\\\",\\n        \\\"creationDate\\\": \\\"2023-08-11T16:19:35+02:00\\\",\\n        \\\"accountHolder\\\": {\\n            \\\"id\\\": \\\"AH00000000000000000000001\\\",\\n            \\\"description\\\": \\\"Your description for the account holder\\\",\\n            \\\"reference\\\": \\\"Your reference for the account holder\\\"\\n        },\\n        \\\"balanceAccount\\\": {\\n            \\\"id\\\": \\\"BA00000000000000000000001\\\",\\n            \\\"description\\\": \\\"Your description for 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<h3>Incoming internal transactions<\/h3>\n <p>After an incoming internal transfer is <a href=\"\/pt\/marketplaces\/internal-fund-transfers\/internal-transfer-webhooks\/#internal-transfer-booked\">\n  <strong>booked<\/strong>\n<\/a> to the balance 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;\"><code>accountHolder<\/code><\/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;\"><code>amount<\/code><\/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;\"><code>balanceAccount<\/code><\/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;\"><code>id<\/code><\/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;\"><code>transfer<\/code><\/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\/marketplaces\/transfer-transactions\/transaction-webhooks","articleFields":{"description":"Find out which webhooks Adyen sends for transfers in your platform.","feedback_component":true,"type":"page","_expandable":null,"operations":"","status":"current","parameters":{"directoryPath":"\/marketplaces","transferType":"transfers","model":"marketplace"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/marketplaces\/transfer-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 payouts to your users.\nOutgoing internal transactions: 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 transfer instrument.\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 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 internal transaction webhook\n                            \n        \n        \n            \n\n\n\n\n        \n    \n\n\n\n\nReceiving funds (incoming)\nAdyen sends webhooks for:\n\nIncoming external transactions: transactions that result from topping up a balance 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 to your user's balance 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 the balance account, Adyen sends a  balancePlatform.transaction.created webhook with the following information:\n\n\n\nParameter\nDescription\n\n\n\n\naccountHolder\nAn object containing information about the account holder that owns the target balance account\n\n\namount\nAn object containing the value and currency of the transaction.\n\n\nbalanceAccount\nThe balance account that receives the funds.\n\n\nid\nThe unique identifier of the transaction event.\n\n\ntransfer\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":"Marketplaces","lvl2":"Track transactions","lvl3":"Transaction webhooks"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/marketplaces","lvl2":"https:\/\/docs.adyen.com\/pt\/marketplaces\/transfer-transactions","lvl3":"\/pt\/marketplaces\/transfer-transactions\/transaction-webhooks"},"levels":4,"category":"Marketplaces","category_color":"green","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>"}}