{"title":"Surcharge","category":"default","creationDate":1676035020,"content":"<p>Payment brands, such as card schemes and debit network providers, charge a fee for accepting payments on their payment network, called a payment acceptance fee. As a platform, you must have agreements in place with your users about how the payment acceptance fee is charged for each payment. Your users can pass on these costs to their customers by adding a surcharge to their payments.<\/p>\n<p>Similar to the other <a href=\"\/pt\/platforms\/in-person-payments\/transaction-fees\">transaction fees<\/a>, you can use split instructions to define how to book the surcharge. By default, the surcharge amount on a payment is booked to your liable balance account. However, you can book this amount directly to your user's balance account.<\/p>\n<h2>Requirements<\/h2>\n<p>In addition to the <a href=\"\/pt\/platforms\/in-person-payments#requirements\">general requirements<\/a> for in-person payments with an Adyen for Platforms integration, take into account the following information.<\/p>\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;\">The supported in-person payments solution and hardware differ per <a href=\"#surcharge-methods\">surcharge method<\/a>. For details, see: <ul><li markdown=\"1\"><a href=\"\/pt\/platforms\/in-person-payments\/surcharge\/configuration\">Configuration-based surcharge<\/a><\/li> <li markdown=\"1\"><a href=\"\/pt\/platforms\/in-person-payments\/surcharge\/dynamic\">Dynamic surcharge<\/a><\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Limitations<\/strong><\/td>\n<td style=\"text-align: left;\">Note the following: <ul><li markdown=\"1\">The surcharge feature is available in Australia, Canada, Europe, Great Britain, New Zealand, and the United States.<\/li><li markdown=\"1\">For surcharges in a Mobile solution, the <a href=\"#surcharge-confirmation-screen\">surcharge confirmation screen<\/a> does not show.<\/li> <li markdown=\"1\">It is not allowed to apply a <a href=\"#surcharge-or-dcc\">surcharge and Dynamic Currency Conversion<\/a> to the same transaction.<\/li> <li markdown=\"1\">It is not allowed to apply surcharges to authorization adjustments or overcaptures, because the surcharge amount cannot be higher than the surcharge amount that was shown to the customer at the point of sale.<\/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 you comply with the general and regional compliance requirements mentioned in our <a href=\"\/pt\/development-resources\/surcharge-compliance\">Surcharge compliance guide<\/a>.<\/li> <li markdown=\"1\">Also consult your own legal advisor on compliance with regulatory requirements, and review the scheme rules for the latest information.<\/li><\/ul><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>Compliance<\/h2>\n<p>Surcharges must comply with legal, regulatory, and card scheme requirements. For example, schemes require that you provide signage to inform customers about the payment methods that are subject to surcharges, and the related costs such as the surcharge percentage.<\/p>\n<p>Surcharging is also subject to specific local\/jurisdictional restrictions. For example, in the European Economic Area (EEA) surcharges are not allowed on payments made with a consumer card that was issued in the EEA. And in the US surcharges are not allowed on payments made with a debit card.<\/p>\n<p>The Adyen surcharge feature does not include automated global compliance enforcement. You must validate your setup against the compliance considerations and local mandates. We strongly recommend you consult your own legal advisor on compliance with regulatory and legal implications and use the correct settings based on our <a href=\"\/pt\/development-resources\/surcharge-compliance\">Surcharge compliance guide<\/a>.<\/p>\n<h3>Compliant receipts<\/h3>\n<p>The Adyen-generated receipt data that you receive in the Terminal API response include the surcharge amount, both in the merchant receipt and in the shopper receipt. We strongly recommend using the Adyen-generated receipt data without alterations.<\/p>\n<p>If you customize receipts, it is your responsibility to ensure that all scheme requirements are met, including requirements for disclosing the surcharge amount on the receipt.<\/p>\n<p>If you use a standalone terminal, the built-in printer automatically prints a compliant receipt.<\/p>\n<h2>Surcharge methods<\/h2>\n<p>You can add a surcharge to in-person payments using various methods:<\/p>\n<ul>\n<li>\n<p><a href=\"\/pt\/platforms\/in-person-payments\/surcharge\/configuration\">Configuration-based surcharge<\/a>.<br \/>\nUsing configuration settings, you create rules to apply surcharges depending on aspects such as payment method (card brand), funding source, issuing country, and currency. You can create these rules for your Adyen company or merchant account, store, or individual terminals. The surcharge amount is then calculated and applied automatically.<\/p>\n<\/li>\n<li>\n<p><a href=\"\/pt\/platforms\/in-person-payments\/surcharge\/dynamic\">Dynamic surcharge<\/a>.<br \/>\nYou use your own logic or a third-party service to calculate the amount of the surcharge. To get the data needed for this calculation, you can send a card acquisition request. Then you specify the calculated surcharge fee in your payment request.<br \/>\nThis method is not supported with standalone terminals.<\/p>\n<\/li>\n<\/ul>\n<p>You can use either method, or both. When you use both methods, passing a surcharge amount in the payment request overrules the configuration-based surcharge.<\/p>\n<p>The following considerations can help you choose a surcharge method:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Use case<\/th>\n<th style=\"text-align: left;\">Surcharge method(s)<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">You do not have your own logic or a third-party service for the surcharge calculation.<\/td>\n<td style=\"text-align: left;\">Configuration-based surcharge.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">You have only standalone terminals, a mix of both integrated and standalone terminals, or want to be able to switch terminals between integrated and standalone mode.<\/td>\n<td style=\"text-align: left;\">Standalone terminals only support configuration-based surcharge, so you must set up a surcharge configuration. <br> For the integrated terminals you can use the same configuration-based surcharge and\/or dynamic surcharge.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">You want to be able to apply a zero (0) surcharge on specific transactions. For example, for a better customer experience on very high value transactions.<\/td>\n<td style=\"text-align: left;\">You can use dynamic surcharge for all transactions, or set up configuration-based surcharge and overrule this using dynamic surcharge only when desired.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">You have your own surcharge calculation logic that you want to apply to both point-of-sale and ecommerce transactions.<\/td>\n<td style=\"text-align: left;\">Dynamic surcharge.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">You want to use a third party for the surcharge calculation. <br>This option is especially useful if you want to move terminals between locations (within the country\/region that the terminal was ordered for) with different compliance requirements. For example, between different states in the US.<\/td>\n<td style=\"text-align: left;\">Dynamic surcharge.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>Surcharge confirmation screen<\/h2>\n<p>As part of the surcharge flow on payment terminals, the terminal can show a confirmation screen with the total amount of the payment, the surcharge amount, and the payment method to which the surcharge is applied.<\/p>\n<div class=\"hint--right\" data-hint=\"Confirmation screen showing total amount and fees amount\">\n<p><img alt=\"\" src=\"\/images\/3\/1\/2\/c\/d\/312cd1048a50a51a1278ea6aa15f7c12be2b9584-screen-ensurcharge-final.png\" \/><\/p>\n<\/div>\n<p>The customer can then:<\/p>\n<ul>\n<li>Accept the surcharge by selecting <strong>Confirm<\/strong> (or the <strong><img alt=\"\" src=\"\/images\/e\/1\/f\/d\/f\/e1fdf2ab953d26666e876b743ce54acaa22e7206-confirm2x.png\" \/><\/strong> key).<\/li>\n<li>Reject the surcharge by selecting the button to cancel the transaction (or the <strong><img alt=\"\" src=\"\/images\/6\/2\/0\/e\/0\/620e0c5c343676dd2b947bbdb1573f7eebc3caf7-cancel2x.png\" \/><\/strong> key).<\/li>\n<\/ul>\n<div class=\"notices yellow\">\n<p>In a Mobile solution, a confirmation screen is currently not supported. <br> Be aware that regulations require you to inform the customer that a surcharge is added to the payment amount.<\/p>\n<\/div>\n<p>You can choose to skip the surcharge confirmation screen provided by Adyen in favor of other forms of disclosure. Reasons for this choice can be, for example:<\/p>\n<ul>\n<li>The rules and regulations on surcharge disclosure applicable to the location of the store.<\/li>\n<li>Local habits with regard to the payment flow.<\/li>\n<li>The use of your own application for surcharge disclosure (for example, in a Mobile solution).<\/li>\n<\/ul>\n<p>To show or skip the Adyen confirmation screen, you need to use the Management API to configure the terminal setting <code>askConfirmation<\/code>.<\/p>\n<h2 id=\"surcharge-or-dcc\">Surcharge or DCC<\/h2>\n<p>It is not possible to apply both Dynamic Currency Conversion (DCC) and a surcharge to the same transaction. You can nevertheless integrate both the DCC feature and the surcharge feature:<\/p>\n<ul>\n<li>If your payment terminals are on a software version <strong>earlier than v1.112<\/strong>, we recommend not configuring both features on the same terminals.<\/li>\n<li>If your payment terminals are on software version <strong>v1.112 or later<\/strong>, we automatically skip DCC if the surcharge amount is greater than 0 (zero).<\/li>\n<li>The flexible  <a href=\"\/pt\/platforms\/in-person-payments\/surcharge#configure-surcharges\">surcharge configuration<\/a>  enables you to configure surcharges for some cases and not for other cases, so that you can offer DCC in those other cases.<\/li>\n<\/ul>\n<h2>AUTHORISATION webhooks<\/h2>\n<p>To have more visibility on the surcharge amounts that were added to payments, we strongly recommend that you enable receiving the surcharge amount in  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Webhooks\/latest\/post\/AUTHORISATION\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">AUTHORISATION<\/a> webhook messages.<\/p>\n<p>You can enable this in your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a> using either of the following methods:<\/p>\n<ul>\n<li>\n<p>Update the configuration of the <strong>Standard<\/strong> webhook type by selecting the additional setting <strong>Include Extra Costs Surcharge<\/strong>. For instructions, see <a href=\"\/pt\/development-resources\/webhooks\/webhook-types\/additional-settings\">Additional settings<\/a>.<\/p>\n<\/li>\n<li>\n<p>Under <strong>Developers<\/strong> &gt; <strong>Additional data<\/strong> select <strong>Surcharge amount<\/strong> and save the change.<\/p>\n<\/li>\n<\/ul>\n<p>AUTHORISATION webhook messages then include an <code>additionalData<\/code> object with:<\/p>\n<ul>\n<li><code>extraCostsCurrency<\/code>: The currency of the surcharge.<\/li>\n<li><code>extraCostsValueSurcharge<\/code>: The amount of the surcharge <a href=\"\/pt\/development-resources\/currency-codes\">in minor units<\/a>.<\/li>\n<\/ul>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'AUTHORISATION webhook message with surcharge details'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n  \\\"live\\\": \\\"false\\\",\\n  \\\"notificationItems\\\": [\\n    {\\n      \\\"NotificationRequestItem\\\": {\\n        \\\"additionalData\\\": {\\n          \\\"authCode\\\": \\\"123456\\\",\\n          \\\"cardSummary\\\": \\\"9999\\\",\\n          \\\"expiryDate\\\": \\\"02\\\/2028\\\",\\n          \\\"extraCostsCurrency\\\": \\\"USD\\\",\\n          \\\"extraCostsValue\\\": \\\"2000\\\",\\n          \\\"extraCostsValueSurcharge\\\": \\\"2000\\\"\\n        },\\n        \\\"amount\\\": {\\n          \\\"currency\\\": \\\"USD\\\",\\n          \\\"value\\\": 62000\\n        },\\n        \\\"eventCode\\\": \\\"AUTHORISATION\\\",\\n        \\\"eventDate\\\": \\\"2026-01-05T16:00:01.973Z\\\",\\n        \\\"merchantAccountCode\\\": \\\"ADYEN_MERCHANT_ACCOUNT\\\",\\n        \\\"merchantReference\\\": \\\"1753267488\\\",\\n        \\\"operations\\\": [\\n          \\\"CANCEL\\\",\\n          \\\"CAPTURE\\\",\\n          \\\"REFUND\\\"\\n        ],\\n        \\\"paymentMethod\\\": \\\"mc\\\",\\n        \\\"pspReference\\\": \\\"CWBC43ZX2VTFWR82\\\",\\n        \\\"reason\\\": \\\"123456:9999:02\\\/2028\\\",\\n        \\\"success\\\": \\\"true\\\"\\n      }\\n    }\\n  ]\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<h2>Track fund movements<\/h2>\n<p>To track the status of the fund transfers initiated by a surcharge:<\/p>\n<ol>\n<li>Listen to the following webhooks:\n<ul>\n<li> <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>: Adyen sends a  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfer-webhooks\/latest\/post\/balancePlatform.transfer.created\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balancePlatform.transfer.created<\/a> webhook to inform your server that funds will be credited to balance accounts, and  <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> webhooks after every status change.<\/li>\n<li> <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>: 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 to inform your server that funds have been credited to a balance account.<\/li>\n<\/ul><\/li>\n<li>Acknowledge the webhooks. We send these webhooks for every split item in the payment.<\/li>\n<li>In the  <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 payload, note that the <code>event<\/code> array includes all previous transfer events, and the <code>sequenceNumber<\/code> defines the number of webhooks sent for the transfer, including the current one.<\/li>\n<\/ol>\n<h3>Webhook examples<\/h3>\n<p>The following examples show the webhooks you receive for a surcharge. We send webhooks for each balance account involved in the payment, and each split of the payment amount, including the surcharge.<\/p>\n<p>You can identify surcharge-related transfer webhooks by the following values:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<th style=\"text-align: left;\">Value<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfer-webhooks\/latest\/post\/balancePlatform.transfer.created#request-data-category\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">category<\/a><\/td>\n<td style=\"text-align: left;\">Specifies the category of the transfer.<\/td>\n<td style=\"text-align: left;\"><strong>platformPayment<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfer-webhooks\/latest\/post\/balancePlatform.transfer.created#request-data-direction\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">direction<\/a><\/td>\n<td style=\"text-align: left;\">The direction of the transfer based on the balance account.<\/td>\n<td style=\"text-align: left;\"><strong>incoming<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfer-webhooks\/latest\/post\/balancePlatform.transfer.created#request-data-type\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">type<\/a><\/td>\n<td style=\"text-align: left;\">Specifies the type of the transfer.<\/td>\n<td style=\"text-align: left;\"><strong>payment<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfer-webhooks\/latest\/post\/balancePlatform.transfer.created#request-data-categoryData-PlatformPayment-platformPaymentType\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">platformPaymentType<\/a><\/td>\n<td style=\"text-align: left;\">Specifies the nature of each transfer on the balance platform. This parameter helps categorize transfers so you can reconcile transactions at a later time using the <a href=\"\/pt\/platforms}\/reports-and-fees\/balance-platform-accounting-report\/\">Balance Platform Accounting Report<\/a>.<\/td>\n<td style=\"text-align: left;\"><strong>Surcharge<\/strong><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n    <div class=\"faqs\">\n        <div class=\"adl-accordion adl-accordion--max-height-transition\" style=\"margin-bottom:24px\">\n                                                            <div class=\"adl-accordion__item\">\n                    <div tabindex=\"1\" role=\"question\" aria-expanded=\"true\" class=\"adl-accordion__header\" data-accordion=\"#1-incoming-transfer-received\">\n                        <i class=\"adl-accordion__toggle adl-icon-chevron-down\"><\/i>\n                        <div class=\"adl-accordion__title-wrapper\">\n                            <h3 class=\"adl-accordion__title no-anchor\">\n                                1. Incoming transfer received <div class=\"faq-link-icon adl-icon adl-icon-chain\"><\/div>\n                            <\/h3>\n                                                    <\/div>\n                    <\/div>\n                    <div role=\"answer\" class=\"adl-accordion__content\">\n                        <p>When a transfer request is received to credit funds for the surcharge to your user's balance account, Adyen sends a  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfer-webhooks\/latest\/post\/balancePlatform.transfer.created\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balancePlatform.transfer.created<\/a> webhook with <code>status<\/code> <strong>received<\/strong> and <code>direction<\/code> <strong>incoming<\/strong>. The webhook provides information about the transfer, such as the payment and split references and which user and balance account is credited with the funds.<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Transfer received'\" :id=\"'received-ba1'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"data\\\": {\\n        \\\"accountHolder\\\": {\\n            \\\"description\\\": \\\"Your description for the account holder\\\",\\n            \\\"id\\\": \\\"AH00000000000000000000001\\\",\\n            \\\"reference\\\": \\\"Your reference for the account holder\\\"\\n        },\\n        \\\"amount\\\": {\\n            \\\"currency\\\": \\\"EUR\\\",\\n            \\\"value\\\": 200\\n        },\\n        \\\"balanceAccount\\\": {\\n            \\\"description\\\": \\\"Your description for the balance account\\\",\\n            \\\"id\\\": \\\"BA00000000000000000000001\\\",\\n            \\\"reference\\\": \\\"Your reference for the balance account\\\"\\n        },\\n        \\\"balancePlatform\\\": \\\"YOUR_BALANCE_PLATFORM\\\",\\n        \\\"balances\\\": [\\n            {\\n                \\\"currency\\\": \\\"EUR\\\",\\n                \\\"received\\\": 200\\n            }\\n        ],\\n        \\\"category\\\": \\\"platformPayment\\\",\\n        \\\"categoryData\\\": {\\n            \\\"modificationMerchantReference\\\": \\\"MRef#000001\\\",\\n            \\\"modificationPspReference\\\": \\\"PPKFQ89R6QRXGN82\\\",\\n            \\\"paymentMerchantReference\\\": \\\"Payment reference\\\",\\n            \\\"platformPaymentType\\\": \\\"Surcharge\\\",\\n            \\\"pspPaymentReference\\\": \\\"CWBC43ZX2VTFWR82\\\",\\n            \\\"type\\\": \\\"platformPayment\\\"\\n        },\\n        \\\"creationDate\\\": \\\"2025-10-20T13:30:05+02:00\\\",\\n        \\\"description\\\": \\\"Your description for the surcharge\\\",\\n        \\\"direction\\\": \\\"incoming\\\",\\n        \\\"events\\\": [\\n            {\\n                \\\"bookingDate\\\": \\\"2025-10-20T13:30:18+02:00\\\",\\n                \\\"id\\\": \\\"SKRL00000000000000000000000001\\\",\\n                \\\"mutations\\\": [\\n                    {\\n                        \\\"currency\\\": \\\"EUR\\\",\\n                        \\\"received\\\": 200\\n                    }\\n                ],\\n                \\\"status\\\": \\\"received\\\",\\n                \\\"type\\\": \\\"accounting\\\"\\n            }\\n        ],\\n        \\\"id\\\": \\\"JN4227222422265\\\",\\n        \\\"reason\\\": \\\"approved\\\",\\n        \\\"reference\\\": \\\"Your reference for the surcharge\\\",\\n        \\\"sequenceNumber\\\": 1,\\n        \\\"status\\\": \\\"received\\\",\\n        \\\"type\\\": \\\"payment\\\"\\n    },\\n    \\\"environment\\\": \\\"test\\\",\\n    \\\"type\\\": \\\"balancePlatform.transfer.created\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n                    <\/div>\n                <\/div>\n                                                            <div class=\"adl-accordion__item\">\n                    <div tabindex=\"2\" role=\"question\" aria-expanded=\"true\" class=\"adl-accordion__header\" data-accordion=\"#2-incoming-transfer-authorized\">\n                        <i class=\"adl-accordion__toggle adl-icon-chevron-down\"><\/i>\n                        <div class=\"adl-accordion__title-wrapper\">\n                            <h3 class=\"adl-accordion__title no-anchor\">\n                                2. Incoming transfer authorized <div class=\"faq-link-icon adl-icon adl-icon-chain\"><\/div>\n                            <\/h3>\n                                                    <\/div>\n                    <\/div>\n                    <div role=\"answer\" class=\"adl-accordion__content\">\n                        <p>When the transfer request is authorized, 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 <code>status<\/code> <strong>authorised<\/strong>.<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Transfer authorized'\" :id=\"'authorised-ba1'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"data\\\": {\\n        \\\"accountHolder\\\": {\\n            \\\"description\\\": \\\"Your description for the account holder\\\",\\n            \\\"id\\\": \\\"AH00000000000000000000001\\\",\\n            \\\"reference\\\": \\\"Your reference for the account holder\\\"\\n        },\\n        \\\"amount\\\": {\\n            \\\"currency\\\": \\\"EUR\\\",\\n            \\\"value\\\": 200\\n        },\\n        \\\"balanceAccount\\\": {\\n            \\\"description\\\": \\\"Your description for the balance account\\\",\\n            \\\"id\\\": \\\"BA00000000000000000000001\\\",\\n            \\\"reference\\\": \\\"Your reference for the balance account\\\"\\n        },\\n        \\\"balancePlatform\\\": \\\"YOUR_BALANCE_PLATFORM\\\",\\n        \\\"balances\\\": [\\n            {\\n                \\\"currency\\\": \\\"EUR\\\",\\n                \\\"received\\\": 0,\\n                \\\"reserved\\\": 200\\n            }\\n        ],\\n        \\\"category\\\": \\\"platformPayment\\\",\\n        \\\"categoryData\\\": {\\n            \\\"modificationMerchantReference\\\": \\\"MRef#000001\\\",\\n            \\\"modificationPspReference\\\": \\\"PPKFQ89R6QRXGN82\\\",\\n            \\\"paymentMerchantReference\\\": \\\"Payment reference\\\",\\n            \\\"platformPaymentType\\\": \\\"Surcharge\\\",\\n            \\\"pspPaymentReference\\\": \\\"CWBC43ZX2VTFWR82\\\",\\n            \\\"type\\\": \\\"platformPayment\\\"\\n        },\\n        \\\"creationDate\\\": \\\"2025-10-20T13:30:05+02:00\\\",\\n        \\\"description\\\": \\\"Your description for the surcharge\\\",\\n        \\\"direction\\\": \\\"incoming\\\",\\n        \\\"events\\\": [\\n            {\\n                \\\"bookingDate\\\": \\\"2025-10-20T13:30:18+02:00\\\",\\n                \\\"id\\\": \\\"SKRL00000000000000000000000001\\\",\\n                \\\"mutations\\\": [\\n                    {\\n                        \\\"currency\\\": \\\"EUR\\\",\\n                        \\\"received\\\": 200\\n                    }\\n                ],\\n                \\\"status\\\": \\\"received\\\",\\n                \\\"type\\\": \\\"accounting\\\"\\n            },\\n            {\\n                \\\"bookingDate\\\": \\\"2025-10-20T13:30:18+02:00\\\",\\n                \\\"id\\\": \\\"SKRL00000000000000000000000002\\\",\\n                \\\"mutations\\\": [\\n                    {\\n                        \\\"currency\\\": \\\"EUR\\\",\\n                        \\\"received\\\": -200,\\n                        \\\"reserved\\\": 200\\n                    }\\n                ],\\n                \\\"status\\\": \\\"authorised\\\",\\n                \\\"type\\\": \\\"accounting\\\"\\n            }\\n        ],\\n        \\\"id\\\": \\\"JN4227222422265\\\",\\n        \\\"reason\\\": \\\"approved\\\",\\n        \\\"reference\\\": \\\"Your reference for the surcharge\\\",\\n        \\\"sequenceNumber\\\": 2,\\n        \\\"status\\\": \\\"authorised\\\",\\n        \\\"type\\\": \\\"payment\\\"\\n    },\\n    \\\"environment\\\": \\\"test\\\",\\n    \\\"type\\\": \\\"balancePlatform.transfer.updated\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n                    <\/div>\n                <\/div>\n                                                            <div class=\"adl-accordion__item\">\n                    <div tabindex=\"3\" role=\"question\" aria-expanded=\"true\" class=\"adl-accordion__header\" data-accordion=\"#3-incoming-transfer-captured\">\n                        <i class=\"adl-accordion__toggle adl-icon-chevron-down\"><\/i>\n                        <div class=\"adl-accordion__title-wrapper\">\n                            <h3 class=\"adl-accordion__title no-anchor\">\n                                3. Incoming transfer captured <div class=\"faq-link-icon adl-icon adl-icon-chain\"><\/div>\n                            <\/h3>\n                                                    <\/div>\n                    <\/div>\n                    <div role=\"answer\" class=\"adl-accordion__content\">\n                        <p>When the funds are credited to your user's balance account, 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 <code>status<\/code> <strong>captured<\/strong> and the <code>transactionId<\/code>.<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Transfer captured'\" :id=\"'captured-ba1'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"data\\\": {\\n        \\\"accountHolder\\\": {\\n            \\\"description\\\": \\\"Your description for the account holder\\\",\\n            \\\"id\\\": \\\"AH00000000000000000000001\\\",\\n            \\\"reference\\\": \\\"Your reference for the account holder\\\"\\n        },\\n        \\\"amount\\\": {\\n            \\\"currency\\\": \\\"EUR\\\",\\n            \\\"value\\\": 200\\n        },\\n        \\\"balanceAccount\\\": {\\n            \\\"description\\\": \\\"Your description for the balance account\\\",\\n            \\\"id\\\": \\\"BA00000000000000000000001\\\",\\n            \\\"reference\\\": \\\"Your reference for the balance account\\\"\\n        },\\n        \\\"balancePlatform\\\": \\\"YOUR_BALANCE_PLATFORM\\\",\\n        \\\"balances\\\": [\\n            {\\n                \\\"balance\\\": 200,\\n                \\\"currency\\\": \\\"EUR\\\",\\n                \\\"received\\\": 0,\\n                \\\"reserved\\\": 0\\n            }\\n        ],\\n        \\\"category\\\": \\\"platformPayment\\\",\\n        \\\"categoryData\\\": {\\n            \\\"modificationMerchantReference\\\": \\\"MRef#000001\\\",\\n            \\\"modificationPspReference\\\": \\\"PPKFQ89R6QRXGN82\\\",\\n            \\\"paymentMerchantReference\\\": \\\"Payment reference\\\",\\n            \\\"platformPaymentType\\\": \\\"Surcharge\\\",\\n            \\\"pspPaymentReference\\\": \\\"CWBC43ZX2VTFWR82\\\",\\n            \\\"type\\\": \\\"platformPayment\\\"\\n        },\\n        \\\"creationDate\\\": \\\"2025-10-20T13:30:05+02:00\\\",\\n        \\\"description\\\": \\\"Your description for the surcharge\\\",\\n        \\\"direction\\\": \\\"incoming\\\",\\n        \\\"events\\\": [\\n            {\\n                \\\"bookingDate\\\": \\\"2025-10-20T13:30:18+02:00\\\",\\n                \\\"id\\\": \\\"SKRL00000000000000000000000001\\\",\\n                \\\"mutations\\\": [\\n                    {\\n                        \\\"currency\\\": \\\"EUR\\\",\\n                        \\\"received\\\": 200\\n                    }\\n                ],\\n                \\\"status\\\": \\\"received\\\",\\n                \\\"type\\\": \\\"accounting\\\"\\n            },\\n            {\\n                \\\"bookingDate\\\": \\\"2025-10-20T13:30:18+02:00\\\",\\n                \\\"id\\\": \\\"SKRL00000000000000000000000002\\\",\\n                \\\"mutations\\\": [\\n                    {\\n                        \\\"currency\\\": \\\"EUR\\\",\\n                        \\\"received\\\": -200,\\n                        \\\"reserved\\\": 200\\n                    }\\n                ],\\n                \\\"status\\\": \\\"authorised\\\",\\n                \\\"type\\\": \\\"accounting\\\"\\n            },\\n            {\\n                \\\"bookingDate\\\": \\\"2025-10-20T13:30:20+02:00\\\",\\n                \\\"id\\\": \\\"SKRL00000000000000000000000003\\\",\\n                \\\"mutations\\\": [\\n                    {\\n                        \\\"balance\\\": 200,\\n                        \\\"currency\\\": \\\"EUR\\\",\\n                        \\\"received\\\": 0,\\n                        \\\"reserved\\\": -200\\n                    }\\n                ],\\n                \\\"status\\\": \\\"captured\\\",\\n                \\\"transactionId\\\": \\\"EVJN42272224222B5JB8BRC84N686ZEUR\\\",\\n                \\\"type\\\": \\\"accounting\\\",\\n                \\\"valueDate\\\": \\\"2023-03-01T00:00:00+02:00\\\"\\n            }\\n        ],\\n        \\\"id\\\": \\\"JN4227222422265\\\",\\n        \\\"reason\\\": \\\"approved\\\",\\n        \\\"reference\\\": \\\"Your reference for the surcharge\\\",\\n        \\\"sequenceNumber\\\": 3,\\n        \\\"status\\\": \\\"captured\\\",\\n        \\\"type\\\": \\\"payment\\\"\\n    },\\n    \\\"environment\\\": \\\"test\\\",\\n    \\\"type\\\": \\\"balancePlatform.transfer.updated\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n                    <\/div>\n                <\/div>\n                                                            <div class=\"adl-accordion__item\">\n                    <div tabindex=\"4\" role=\"question\" aria-expanded=\"true\" class=\"adl-accordion__header\" data-accordion=\"#4-transaction-booked\">\n                        <i class=\"adl-accordion__toggle adl-icon-chevron-down\"><\/i>\n                        <div class=\"adl-accordion__title-wrapper\">\n                            <h3 class=\"adl-accordion__title no-anchor\">\n                                4. Transaction booked <div class=\"faq-link-icon adl-icon adl-icon-chain\"><\/div>\n                            <\/h3>\n                                                    <\/div>\n                    <\/div>\n                    <div role=\"answer\" class=\"adl-accordion__content\">\n                        <p>When the funds are credited, Adyen also 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, which includes information about the related transaction.<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Transaction created'\" :id=\"'booked-transaction-ba1'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"data\\\": {\\n        \\\"id\\\": \\\"EVJN42272224222B5JB8BRC84N686ZEUR\\\",\\n        \\\"amount\\\": {\\n            \\\"value\\\": 200,\\n            \\\"currency\\\": \\\"EUR\\\"\\n        },\\n        \\\"status\\\": \\\"booked\\\",\\n        \\\"transfer\\\": {\\n            \\\"id\\\": \\\"JN4227222422265\\\",\\n            \\\"categoryData\\\": {\\n                \\\"modificationMerchantReference\\\": \\\"MRef#000001\\\",\\n                \\\"modificationPspReference\\\": \\\"PPKFQ89R6QRXGN82\\\",\\n                \\\"paymentMerchantReference\\\": \\\"Payment reference\\\",\\n                \\\"platformPaymentType\\\": \\\"Surcharge\\\",\\n                \\\"pspPaymentReference\\\": \\\"CWBC43ZX2VTFWR82\\\",\\n                \\\"type\\\": \\\"platformPayment\\\"\\n            },\\n            \\\"reference\\\": \\\"Your reference for the surcharge\\\"\\n        },\\n        \\\"valueDate\\\": \\\"2023-03-01T00:00:00+02:00\\\",\\n        \\\"bookingDate\\\": \\\"2025-10-20T13:30:20+02:00\\\",\\n        \\\"creationDate\\\": \\\"2025-10-20T13:30:05+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            \\\"reference\\\": \\\"Your reference 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                    <\/div>\n                <\/div>\n                    <\/div>\n    <\/div>\n\n<h2>Reports and reconciliation<\/h2>\n<p>To have full visibility of the surcharge amounts that were added to payments, we strongly recommend you <a href=\"\/pt\/reporting\/invoice-reconciliation\/payment-accounting-report\/#configure-report-columns\">add an extra column<\/a> <strong>Surcharge Amount<\/strong> to the following reports:<\/p>\n<ul>\n<li><a href=\"\/pt\/reporting\/invoice-reconciliation\/payment-accounting-report\">Payment Accounting Report<\/a> (PAR)<\/li>\n<li><a href=\"\/pt\/reporting\/settlement-reconciliation\/transaction-level\/settlement-details-report\">Settlement Detail Report<\/a> (SDR)<\/li>\n<\/ul>\n<p>If you specify the split type <strong>Surcharge<\/strong> in the payment request or in the split configuration, a separate incoming transfer is generated for the surcharge amount. The following reports are affected:<\/p>\n<ul>\n<li>The <a href=\"\/pt\/platforms\/reports-and-fees\/balance-platform-accounting-report\">Balance Platform Accounting Report<\/a> (BPAR) contains extra lines with information related to surcharges.<\/li>\n<li>The <a href=\"\/pt\/platforms\/reports-and-fees\/statement-report\">Balance Platform Statement Report<\/a> (BPSR) contains extra lines showing the impact of the surcharges on the balance account.\n<\/li>\n<\/ul>\n<h2>Next steps<\/h2>\n<div class=\"next-steps\" id=\"next-steps\" >\n<a href=\"\/platforms\/in-person-payments\/surcharge\/configuration\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><img src=\"\/user\/themes\/adyen\/images\/illustrations\/settings.svg\"><h6 class=\"next-steps__title\">Configure surcharge<\/h6><p>Apply surcharges based on surcharge settings for your Adyen account, store, or terminal.<\/p><\/div><\/p><\/a><a href=\"\/platforms\/in-person-payments\/surcharge\/dynamic\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><img src=\"\/user\/themes\/adyen\/images\/illustrations\/user-plus.svg\"><h6 class=\"next-steps__title\">Use dynamic surcharge<\/h6><p>Apply surcharges by specifying a surcharge amount in your transaction request.<\/p><\/div><\/p><\/a><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/platforms\/in-person-payments\/surcharge","articleFields":{"description":"Pass on payment acceptance fees to customers as a surcharge to their payments.","feedback_component":true,"parameters":{"directoryPath":"\/platforms","ippPath":"\/platforms\/in-person-payments","model":"platform","channel":"pos"},"filters_component":false},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/platforms\/in-person-payments\/surcharge","title":"Surcharge","content":"Payment brands, such as card schemes and debit network providers, charge a fee for accepting payments on their payment network, called a payment acceptance fee. As a platform, you must have agreements in place with your users about how the payment acceptance fee is charged for each payment. Your users can pass on these costs to their customers by adding a surcharge to their payments.\nSimilar to the other transaction fees, you can use split instructions to define how to book the surcharge. By default, the surcharge amount on a payment is booked to your liable balance account. However, you can book this amount directly to your user's balance account.\nRequirements\nIn addition to the general requirements for in-person payments with an Adyen for Platforms integration, take into account the following information.\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nThe supported in-person payments solution and hardware differ per surcharge method. For details, see: Configuration-based surcharge Dynamic surcharge\n\n\nLimitations\nNote the following: The surcharge feature is available in Australia, Canada, Europe, Great Britain, New Zealand, and the United States.For surcharges in a Mobile solution, the surcharge confirmation screen does not show. It is not allowed to apply a surcharge and Dynamic Currency Conversion to the same transaction. It is not allowed to apply surcharges to authorization adjustments or overcaptures, because the surcharge amount cannot be higher than the surcharge amount that was shown to the customer at the point of sale.\n\n\nSetup steps\nBefore you begin: Make sure you comply with the general and regional compliance requirements mentioned in our Surcharge compliance guide. Also consult your own legal advisor on compliance with regulatory requirements, and review the scheme rules for the latest information.\n\n\n\nCompliance\nSurcharges must comply with legal, regulatory, and card scheme requirements. For example, schemes require that you provide signage to inform customers about the payment methods that are subject to surcharges, and the related costs such as the surcharge percentage.\nSurcharging is also subject to specific local\/jurisdictional restrictions. For example, in the European Economic Area (EEA) surcharges are not allowed on payments made with a consumer card that was issued in the EEA. And in the US surcharges are not allowed on payments made with a debit card.\nThe Adyen surcharge feature does not include automated global compliance enforcement. You must validate your setup against the compliance considerations and local mandates. We strongly recommend you consult your own legal advisor on compliance with regulatory and legal implications and use the correct settings based on our Surcharge compliance guide.\nCompliant receipts\nThe Adyen-generated receipt data that you receive in the Terminal API response include the surcharge amount, both in the merchant receipt and in the shopper receipt. We strongly recommend using the Adyen-generated receipt data without alterations.\nIf you customize receipts, it is your responsibility to ensure that all scheme requirements are met, including requirements for disclosing the surcharge amount on the receipt.\nIf you use a standalone terminal, the built-in printer automatically prints a compliant receipt.\nSurcharge methods\nYou can add a surcharge to in-person payments using various methods:\n\n\nConfiguration-based surcharge.\nUsing configuration settings, you create rules to apply surcharges depending on aspects such as payment method (card brand), funding source, issuing country, and currency. You can create these rules for your Adyen company or merchant account, store, or individual terminals. The surcharge amount is then calculated and applied automatically.\n\n\nDynamic surcharge.\nYou use your own logic or a third-party service to calculate the amount of the surcharge. To get the data needed for this calculation, you can send a card acquisition request. Then you specify the calculated surcharge fee in your payment request.\nThis method is not supported with standalone terminals.\n\n\nYou can use either method, or both. When you use both methods, passing a surcharge amount in the payment request overrules the configuration-based surcharge.\nThe following considerations can help you choose a surcharge method:\n\n\n\nUse case\nSurcharge method(s)\n\n\n\n\nYou do not have your own logic or a third-party service for the surcharge calculation.\nConfiguration-based surcharge.\n\n\nYou have only standalone terminals, a mix of both integrated and standalone terminals, or want to be able to switch terminals between integrated and standalone mode.\nStandalone terminals only support configuration-based surcharge, so you must set up a surcharge configuration.  For the integrated terminals you can use the same configuration-based surcharge and\/or dynamic surcharge.\n\n\nYou want to be able to apply a zero (0) surcharge on specific transactions. For example, for a better customer experience on very high value transactions.\nYou can use dynamic surcharge for all transactions, or set up configuration-based surcharge and overrule this using dynamic surcharge only when desired.\n\n\nYou have your own surcharge calculation logic that you want to apply to both point-of-sale and ecommerce transactions.\nDynamic surcharge.\n\n\nYou want to use a third party for the surcharge calculation. This option is especially useful if you want to move terminals between locations (within the country\/region that the terminal was ordered for) with different compliance requirements. For example, between different states in the US.\nDynamic surcharge.\n\n\n\nSurcharge confirmation screen\nAs part of the surcharge flow on payment terminals, the terminal can show a confirmation screen with the total amount of the payment, the surcharge amount, and the payment method to which the surcharge is applied.\n\n\n\nThe customer can then:\n\nAccept the surcharge by selecting Confirm (or the  key).\nReject the surcharge by selecting the button to cancel the transaction (or the  key).\n\n\nIn a Mobile solution, a confirmation screen is currently not supported.  Be aware that regulations require you to inform the customer that a surcharge is added to the payment amount.\n\nYou can choose to skip the surcharge confirmation screen provided by Adyen in favor of other forms of disclosure. Reasons for this choice can be, for example:\n\nThe rules and regulations on surcharge disclosure applicable to the location of the store.\nLocal habits with regard to the payment flow.\nThe use of your own application for surcharge disclosure (for example, in a Mobile solution).\n\nTo show or skip the Adyen confirmation screen, you need to use the Management API to configure the terminal setting askConfirmation.\nSurcharge or DCC\nIt is not possible to apply both Dynamic Currency Conversion (DCC) and a surcharge to the same transaction. You can nevertheless integrate both the DCC feature and the surcharge feature:\n\nIf your payment terminals are on a software version earlier than v1.112, we recommend not configuring both features on the same terminals.\nIf your payment terminals are on software version v1.112 or later, we automatically skip DCC if the surcharge amount is greater than 0 (zero).\nThe flexible  surcharge configuration  enables you to configure surcharges for some cases and not for other cases, so that you can offer DCC in those other cases.\n\nAUTHORISATION webhooks\nTo have more visibility on the surcharge amounts that were added to payments, we strongly recommend that you enable receiving the surcharge amount in  AUTHORISATION webhook messages.\nYou can enable this in your Customer Area using either of the following methods:\n\n\nUpdate the configuration of the Standard webhook type by selecting the additional setting Include Extra Costs Surcharge. For instructions, see Additional settings.\n\n\nUnder Developers &gt; Additional data select Surcharge amount and save the change.\n\n\nAUTHORISATION webhook messages then include an additionalData object with:\n\nextraCostsCurrency: The currency of the surcharge.\nextraCostsValueSurcharge: The amount of the surcharge in minor units.\n\n\n    \n\nTrack fund movements\nTo track the status of the fund transfers initiated by a surcharge:\n\nListen to the following webhooks:\n\n Transfer webhooks: Adyen sends a  balancePlatform.transfer.created webhook to inform your server that funds will be credited to balance accounts, and  balancePlatform.transfer.updated webhooks after every status change.\n Transaction webhooks: Adyen sends a  balancePlatform.transaction.created webhook to inform your server that funds have been credited to a balance account.\n\nAcknowledge the webhooks. We send these webhooks for every split item in the payment.\nIn the  balancePlatform.transfer.updated webhook payload, note that the event array includes all previous transfer events, and the sequenceNumber defines the number of webhooks sent for the transfer, including the current one.\n\nWebhook examples\nThe following examples show the webhooks you receive for a surcharge. We send webhooks for each balance account involved in the payment, and each split of the payment amount, including the surcharge.\nYou can identify surcharge-related transfer webhooks by the following values:\n\n\n\nParameter\nDescription\nValue\n\n\n\n\n category\nSpecifies the category of the transfer.\nplatformPayment\n\n\n direction\nThe direction of the transfer based on the balance account.\nincoming\n\n\n type\nSpecifies the type of the transfer.\npayment\n\n\n platformPaymentType\nSpecifies the nature of each transfer on the balance platform. This parameter helps categorize transfers so you can reconcile transactions at a later time using the Balance Platform Accounting Report.\nSurcharge\n\n\n\n    \n        \n                                                            \n                    \n                        \n                        \n                            \n                                1. Incoming transfer received \n                            \n                                                    \n                    \n                    \n                        When a transfer request is received to credit funds for the surcharge to your user's balance account, Adyen sends a  balancePlatform.transfer.created webhook with status received and direction incoming. The webhook provides information about the transfer, such as the payment and split references and which user and balance account is credited with the funds.\n\n    \n\n                    \n                \n                                                            \n                    \n                        \n                        \n                            \n                                2. Incoming transfer authorized \n                            \n                                                    \n                    \n                    \n                        When the transfer request is authorized, Adyen sends a  balancePlatform.transfer.updated webhook with status authorised.\n\n    \n\n                    \n                \n                                                            \n                    \n                        \n                        \n                            \n                                3. Incoming transfer captured \n                            \n                                                    \n                    \n                    \n                        When the funds are credited to your user's balance account, Adyen sends a  balancePlatform.transfer.updated webhook with status captured and the transactionId.\n\n    \n\n                    \n                \n                                                            \n                    \n                        \n                        \n                            \n                                4. Transaction booked \n                            \n                                                    \n                    \n                    \n                        When the funds are credited, Adyen also sends a  balancePlatform.transaction.created webhook, which includes information about the related transaction.\n\n    \n\n                    \n                \n                    \n    \n\nReports and reconciliation\nTo have full visibility of the surcharge amounts that were added to payments, we strongly recommend you add an extra column Surcharge Amount to the following reports:\n\nPayment Accounting Report (PAR)\nSettlement Detail Report (SDR)\n\nIf you specify the split type Surcharge in the payment request or in the split configuration, a separate incoming transfer is generated for the surcharge amount. The following reports are affected:\n\nThe Balance Platform Accounting Report (BPAR) contains extra lines with information related to surcharges.\nThe Balance Platform Statement Report (BPSR) contains extra lines showing the impact of the surcharges on the balance account.\n\n\nNext steps\n\nConfigure surchargeApply surcharges based on surcharge settings for your Adyen account, store, or terminal.Use dynamic surchargeApply surcharges by specifying a surcharge amount in your transaction request.\n","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Platforms","lvl2":"Process in-person payments","lvl3":"Surcharge"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/platforms","lvl2":"https:\/\/docs.adyen.com\/pt\/platforms\/in-person-payments","lvl3":"\/pt\/platforms\/in-person-payments\/surcharge"},"levels":4,"category":"Platforms","category_color":"green","tags":["Surcharge"]}}