{"title":"Surcharge","category":"default","creationDate":1776961627,"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. Usually, businesses include the costs for payment-related fees in the prices they charge. But in some countries\/regions it is common to pass on these costs as a surcharge when the customer uses a card for payment.<\/p>\n<h2>Requirements<\/h2>\n<p>Before you begin, take into account the following requirements, limitations, and preparations.<\/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\/point-of-sale\/surcharge\/configuration\">Configuration-based surcharge<\/a><\/li> <li markdown=\"1\"><a href=\"\/pt\/point-of-sale\/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\/point-of-sale\/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\/point-of-sale\/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\/point-of-sale\/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>Surcharge in 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>Surcharge in reports<\/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<\/li>\n<\/ul>\n<h2>Next steps<\/h2>\n<div class=\"next-steps\" id=\"next-steps\" >\n<a href=\"\/point-of-sale\/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=\"\/point-of-sale\/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\/point-of-sale\/surcharge","articleFields":{"description":"Pass on payment acceptance fees to customers as a surcharge to their payments.","parameters":{"ippPath":"\/point-of-sale","model":"platform","channel":"pos","integrationType":"direct"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/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. Usually, businesses include the costs for payment-related fees in the prices they charge. But in some countries\/regions it is common to pass on these costs as a surcharge when the customer uses a card for payment.\nRequirements\nBefore you begin, take into account the following requirements, limitations, and preparations.\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\nSurcharge in AUTHORISATION 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\nSurcharge in reports\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\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":18,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Surcharge"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/point-of-sale","lvl2":"\/pt\/point-of-sale\/surcharge"},"levels":3,"category":"In-person payments","category_color":"green","tags":["Surcharge"]}}
