{"title":"Tipping on the receipt","category":"default","creationDate":1681721880,"content":"<div class=\"additional-info-block output-inline\">\n<h5 class=\"article__heading additional-info-block__title\">Only when necessary<\/h5><div class=\"additional-info-block__body\"><p>Tipping on the receipt is harder to implement and subject to limitations.<\/p><p>See <a href=\"\/point-of-sale\/tipping\">Tipping<\/a> for alternatives.<\/p><\/div><\/div>\n\n<p>Tipping on the receipt is a payment flow where the customer first presents their card and provides a PIN or signature, and then writes a tip amount on the receipt and signs for it. Because the tip is added after the initial authorization, the original amount is authorized, but the tip is not. To get the full amount including the tip, you can either adjust the authorization or overcapture the payment.<\/p>\n<h2 id=\"before-you-begin\">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;\">A <a href=\"\/point-of-sale\/design-your-integration\/terminal-api\">Terminal API<\/a> integration with payment terminals.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Webhooks<\/strong><\/td>\n<td style=\"text-align: left;\">Set up <a href=\"\/development-resources\/webhooks\/\">standard webhooks<\/a>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Limitations<\/strong><\/td>\n<td style=\"text-align: left;\">Make sure to check the <a href=\"#limitations\">limitations<\/a>.<\/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\">Set up <a href=\"\/point-of-sale\/capturing-payments#manual-capture\">manual capture<\/a>.<\/li><li markdown=\"1\">If you want to use authorization adjustment, make sure you understand the <a href=\"\/point-of-sale\/pre-authorisation\/\">pre-authorization<\/a> flow.<\/li><li markdown=\"1\">If you want to overcapture the amount, contact our <a href=\"https:\/\/ca-test.adyen.com\/ca\/ca\/contactUs\/support.shtml?form=other\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Support Team<\/a>.<\/li><\/ul><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>Authorization adjustment or overcapture<\/h2>\n<p>There are two ways to implement tipping on the receipt:<\/p>\n<ul>\n<li>\n<p><a href=\"#adjust-authorisation\">Adjust an authorization<\/a>: After the initial transaction, you make a request to increase the authorized amount with the tip amount written on the receipt. Then you manually capture the payment. Note that an authorization adjustment can still fail or lead to a chargeback. Card schemes charge slightly higher fees for authorization adjustments than for overcapture.<\/p>\n<\/li>\n<li>\n<p><a href=\"#capture\">Overcapture<\/a>: After the initial transaction, you manually capture the full amount, including the tip. The scheme fees are a bit lower than for authorization adjustment, but there is a risk that the overcapture is not accepted due to scheme rules.<\/p>\n<\/li>\n<\/ul>\n<p>The following table compares the two implementation methods for tipping on the receipt:<\/p>\n<table>\n<thead>\n<tr>\n<th><\/th>\n<th>Adjust authorization<\/th>\n<th>Overcapture<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><strong>Processes<\/strong><\/td>\n<td>The authorized amount is increased <em>before<\/em> the final capture.<\/td>\n<td>The final capture amount is higher than the authorized amount (within limits).<\/td>\n<\/tr>\n<tr>\n<td><strong>Use cases<\/strong><\/td>\n<td>When the tipping on receipt amount is very high.<\/td>\n<td>Standard tipping on receipt in restaurants, bars, taxis.<\/td>\n<\/tr>\n<tr>\n<td><strong>Fees<\/strong><\/td>\n<td>Slightly higher scheme fees.<\/td>\n<td>Standard (lower) fees.<\/td>\n<\/tr>\n<tr>\n<td><strong>Risks<\/strong><\/td>\n<td>Lower risk, the bank authorizes the new total before capture.<\/td>\n<td>Higher risk that the overcaptured (unauthorized) amount is charged back. This is subject to scheme rules.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>How it works<\/h2>\n<p>To implement tipping on the receipt:<\/p>\n<ul>\n<li>Make a payment request with <code>authorisationType<\/code> set to <span translate=\"no\"><strong>PreAuth<\/strong><\/span>, in case you want to adjust the authorized amount after learning the tip amount.<\/li>\n<li>Decide on your next step:\n<ul>\n<li>If the tip is a significant increase of the original amount, make a request to <a href=\"#adjust-authorisation\">adjust the authorization<\/a> with the tip amount.<\/li>\n<li>If the tip amount is a relatively small increase, go straight to <a href=\"#capture\">capturing the payment<\/a>.<\/li>\n<\/ul><\/li>\n<li>Manually capture payment of the final amount.<\/li>\n<\/ul>\n<h2 id=\"limitations\">Limitations for tipping on the receipt<\/h2>\n<p>In some countries\/regions (the US, Singapore, and Hong Kong) a common practice is that the customer signs the tip amount on the receipt after presenting their card and completing the original payment.<\/p>\n<p>To follow this practice, take into account the following:<\/p>\n<ul>\n<li><a href=\"\/online-payments\/adjust-authorisation#availability\">Availability<\/a>: support for authorization adjustment is limited to specific credit card schemes, and also depends on your Merchant Category Code (MCC).<\/li>\n<li>If the tip is more than a certain percentage of the original authorized amount, the card schemes require an <a href=\"#adjust-authorisation\">authorization adjustment<\/a>. If the issuer declines this additional capture, you can get a chargeback for the portion of the final amount that is above the original amount plus this percentage. The percentage differs per scheme and ranges from 0-20%.<\/li>\n<li>If you want to <a href=\"#capture\">overcapture<\/a> the total amount, including the tip without authorization adjustment, contact our <a href=\"https:\/\/ca-test.adyen.com\/ca\/ca\/contactUs\/support.shtml?form=other\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Support Team<\/a>. If the tip is too high, this increase can be rejected or lead to a higher chargeback amount.<\/li>\n<li>You need to manually capture the payment, ideally before the pre-authorization expires. Refer to <a href=\"\/online-payments\/adjust-authorisation#validity\">Expiration of authorizations<\/a>.<\/li>\n<li>The flow is not supported for wallets and debit cards.<\/li>\n<\/ul>\n<h2 id=\"authorisation-request\">Pre-authorize the payment<\/h2>\n<p>Initiate payment:<\/p>\n<ol>\n<li>\n<p><a href=\"\/point-of-sale\/basic-tapi-integration\/make-a-payment\">Make a payment request<\/a>, specifying a  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/terminal-api\/latest\/post\/payment\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">PaymentRequest<\/a> object with:<\/p>\n<ul>\n<li><code>SaleData.SaleToAcquirerData<\/code>: <span translate=\"no\"><strong>authorisationType=PreAuth<\/strong><\/span> to indicate this is a pre-authorisation request.<\/li>\n<\/ul>\n<p>For more request and response details, see <a href=\"\/point-of-sale\/pre-authorisation#pre-authorize\">Pre-authorization<\/a>.<\/p>\n<\/li>\n<li>\n<p>When you receive the pre-authorization response:<\/p>\n<ul>\n<li>Store the <code>pspReference<\/code> from the <code>AdditionalResponse<\/code> for later use when adjusting the authorization or capturing the payment.<\/li>\n<li>\n<p>If you are using synchronous authorization adjustment, also URL decode the <code>adjustAuthorisationData<\/code> blob and store it.<\/p>\n<!-- list separator -->\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Check whether the customer added a tip.<\/p>\n<ul>\n<li>\n<p><strong>If the customer didn't add a tip<\/strong>, proceed to <a href=\"#capture\">Capture the payment<\/a>.<\/p>\n<!-- list separator -->\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>If the customer did add a tip, calculate the tip percentage using the following values from the <code>AdditionalResponse<\/code>: <code>posadditionalamounts.originalAmountValue<\/code> and <code>posAmountGratuityValue<\/code>. These are the original amount and the tip amount in <a href=\"\/development-resources\/currency-codes\">minor units<\/a>.<\/p>\n<ul>\n<li>\n<p><strong>If the tip is a slight increase of the original amount<\/strong>, proceed to <a href=\"#capture\">Capture the payment<\/a>.<\/p>\n<!-- list separator -->\n<\/li>\n<li>\n<p><strong>If the tip is a significant increase of the original amount<\/strong>, proceed to <a href=\"#adjust-authorisation\">Adjust the authorization<\/a>.<br \/>\nThough the card schemes have different standards on when to adjust the authorization, a rule of thumb is to adjust it when the tip amount is higher than 20%.<\/p>\n<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<h2 id=\"adjust-authorisation\">(Optional) Adjust the pre-authorization<\/h2>\n<p>To obtain a new authorization for the original amount plus the tip amount:<\/p>\n\n<div id=\"tabTi0M8\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Asynchronous adjustment&quot;,&quot;content&quot;:&quot;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;Make a POST  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/payments\\\/(paymentPspReference)\\\/amountUpdates\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/payments\\\/{paymentPspReference}\\\/amountUpdates&lt;\\\/a&gt; request, where &lt;code&gt;paymentPspReference&lt;\\\/code&gt; is the &lt;code&gt;pspReference&lt;\\\/code&gt; of the pre-authorization request. Specify:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;code&gt;amount&lt;\\\/code&gt;: The &lt;code&gt;currency&lt;\\\/code&gt; and &lt;code&gt;value&lt;\\\/code&gt; of the new &lt;strong&gt;total&lt;\\\/strong&gt; amount &lt;strong&gt;in minor units&lt;\\\/strong&gt;. This is the sum of the pre-authorized amount and the additional amount.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;reason&lt;\\\/code&gt;: &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;DelayedCharge&lt;\\\/strong&gt;&lt;\\\/span&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;merchantAccount&lt;\\\/code&gt;: The name of your merchant account that is used to process the payment.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;For more request and response details, see &lt;a href=\\&quot;\\\/point-of-sale\\\/pre-authorisation#adjust-auth\\&quot;&gt;Authorization adjustment&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Make sure that you receive the &lt;a href=\\&quot;\\\/development-resources\\\/webhooks\\&quot;&gt;asynchronous standard webhook&lt;\\\/a&gt;. This informs you whether the new amount has been authorized.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Synchronous adjustment&quot;,&quot;content&quot;:&quot;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;Make a POST &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/#\\\/Payment\\\/adjustAuthorisation\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/adjustAuthorisation&lt;\\\/a&gt; request, specifying:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;code&gt;originalReference&lt;\\\/code&gt;: The &lt;code&gt;pspReference&lt;\\\/code&gt; of the pre-authorization request.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;modificationAmount&lt;\\\/code&gt;: The &lt;code&gt;currency&lt;\\\/code&gt; and &lt;code&gt;value&lt;\\\/code&gt; of the new &lt;strong&gt;total&lt;\\\/strong&gt; amount &lt;strong&gt;in minor units&lt;\\\/strong&gt;. This is the sum of the pre-authorized amount and the additional amount.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;additionalData.adjustAuthorisationData&lt;\\\/code&gt;: The &lt;code&gt;adjustAuthorisationData&lt;\\\/code&gt; blob you received in the response to your pre-authorization request, &lt;strong&gt;in URL-decoded format&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;merchantAccount&lt;\\\/code&gt;: The name of your merchant account that is used to process the payment.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;For more request and response details, see &lt;a href=\\&quot;\\\/point-of-sale\\\/pre-authorisation#adjust-auth\\&quot;&gt;Authorization adjustment&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;URL-decode and store the &lt;code&gt;adjustAuthorisationData&lt;\\\/code&gt; blob you receive in the &lt;code&gt;\\\/adjustAuthorisation&lt;\\\/code&gt; response. You will need this if you later adjust the authorization again (although with tipping it is not expected you&#039;ll need to adjust the authorization more than once).&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='false'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<h2 id=\"capture\">Capture the payment<\/h2>\n<p>To ensure the original amount plus the tip amount is settled to your account, you need to <a href=\"\/online-payments\/capture#manual-capture\">manually capture the payment<\/a>:<\/p>\n<ol>\n<li>\n<p>Make a POST request to the\u00a0 <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments\/(paymentPspReference)\/captures\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/payments\/{paymentPspReference}\/captures<\/a> \u00a0endpoint, where <code>paymentPspReference<\/code> is the <code>pspReference<\/code> of the original pre-authorization. Specify:<\/p>\n<ul>\n<li><code>amount<\/code>: The <code>currency<\/code> of the final amount and its <code>value<\/code> in <a href=\"\/development-resources\/currency-codes\">minor units<\/a>. This is the sum of the original authorized amount and the tip.<\/li>\n<li><code>merchantAccount<\/code>: The name of your merchant account that is used to process the payment.<\/li>\n<\/ul>\n<p>For more request and response details, see <a href=\"\/point-of-sale\/pre-authorisation#capture-authorization\">Pre-authorization<\/a>.<\/p>\n<\/li>\n<li>\n<p>Make sure that you receive the <a href=\"\/development-resources\/webhooks\">asynchronous standard webhook<\/a>. This informs you whether the final amount has been captured.<\/p>\n<\/li>\n<\/ol>\n<h2>See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/point-of-sale\/pre-authorisation\"\n                        target=\"_self\"\n                        >\n                    Pre-authorization\n                <\/a><\/li><li><a href=\"\/online-payments\/adjust-authorisation\"\n                        target=\"_self\"\n                        >\n                    Adjust the payment authorization\n                <\/a><\/li><li><a href=\"\/online-payments\/capture\"\n                        target=\"_self\"\n                        >\n                    Capture a payment manually\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/point-of-sale\/tipping\/tipping-on-receipt","articleFields":{"description":"Implement tipping on the receipt with authorization adjustment or overcapture.","feedback_component":true,"filters_component":false,"last_edit_on":"27-01-2026 09:42","decision_tree":"[]","page_id":"34117c50-a220-49af-9477-87d0ec168fd5"},"algolia":{"url":"https:\/\/docs.adyen.com\/point-of-sale\/tipping\/tipping-on-receipt","title":"Tipping on the receipt","content":"\nOnly when necessaryTipping on the receipt is harder to implement and subject to limitations.See Tipping for alternatives.\n\nTipping on the receipt is a payment flow where the customer first presents their card and provides a PIN or signature, and then writes a tip amount on the receipt and signs for it. Because the tip is added after the initial authorization, the original amount is authorized, but the tip is not. To get the full amount including the tip, you can either adjust the authorization or overcapture the 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\nA Terminal API integration with payment terminals.\n\n\nWebhooks\nSet up standard webhooks.\n\n\nLimitations\nMake sure to check the limitations.\n\n\nSetup steps\nBefore you begin: Set up manual capture.If you want to use authorization adjustment, make sure you understand the pre-authorization flow.If you want to overcapture the amount, contact our Support Team.\n\n\n\nAuthorization adjustment or overcapture\nThere are two ways to implement tipping on the receipt:\n\n\nAdjust an authorization: After the initial transaction, you make a request to increase the authorized amount with the tip amount written on the receipt. Then you manually capture the payment. Note that an authorization adjustment can still fail or lead to a chargeback. Card schemes charge slightly higher fees for authorization adjustments than for overcapture.\n\n\nOvercapture: After the initial transaction, you manually capture the full amount, including the tip. The scheme fees are a bit lower than for authorization adjustment, but there is a risk that the overcapture is not accepted due to scheme rules.\n\n\nThe following table compares the two implementation methods for tipping on the receipt:\n\n\n\n\nAdjust authorization\nOvercapture\n\n\n\n\nProcesses\nThe authorized amount is increased before the final capture.\nThe final capture amount is higher than the authorized amount (within limits).\n\n\nUse cases\nWhen the tipping on receipt amount is very high.\nStandard tipping on receipt in restaurants, bars, taxis.\n\n\nFees\nSlightly higher scheme fees.\nStandard (lower) fees.\n\n\nRisks\nLower risk, the bank authorizes the new total before capture.\nHigher risk that the overcaptured (unauthorized) amount is charged back. This is subject to scheme rules.\n\n\n\nHow it works\nTo implement tipping on the receipt:\n\nMake a payment request with authorisationType set to PreAuth, in case you want to adjust the authorized amount after learning the tip amount.\nDecide on your next step:\n\nIf the tip is a significant increase of the original amount, make a request to adjust the authorization with the tip amount.\nIf the tip amount is a relatively small increase, go straight to capturing the payment.\n\nManually capture payment of the final amount.\n\nLimitations for tipping on the receipt\nIn some countries\/regions (the US, Singapore, and Hong Kong) a common practice is that the customer signs the tip amount on the receipt after presenting their card and completing the original payment.\nTo follow this practice, take into account the following:\n\nAvailability: support for authorization adjustment is limited to specific credit card schemes, and also depends on your Merchant Category Code (MCC).\nIf the tip is more than a certain percentage of the original authorized amount, the card schemes require an authorization adjustment. If the issuer declines this additional capture, you can get a chargeback for the portion of the final amount that is above the original amount plus this percentage. The percentage differs per scheme and ranges from 0-20%.\nIf you want to overcapture the total amount, including the tip without authorization adjustment, contact our Support Team. If the tip is too high, this increase can be rejected or lead to a higher chargeback amount.\nYou need to manually capture the payment, ideally before the pre-authorization expires. Refer to Expiration of authorizations.\nThe flow is not supported for wallets and debit cards.\n\nPre-authorize the payment\nInitiate payment:\n\n\nMake a payment request, specifying a  PaymentRequest object with:\n\nSaleData.SaleToAcquirerData: authorisationType=PreAuth to indicate this is a pre-authorisation request.\n\nFor more request and response details, see Pre-authorization.\n\n\nWhen you receive the pre-authorization response:\n\nStore the pspReference from the AdditionalResponse for later use when adjusting the authorization or capturing the payment.\n\nIf you are using synchronous authorization adjustment, also URL decode the adjustAuthorisationData blob and store it.\n\n\n\n\n\nCheck whether the customer added a tip.\n\n\nIf the customer didn't add a tip, proceed to Capture the payment.\n\n\n\n\n\nIf the customer did add a tip, calculate the tip percentage using the following values from the AdditionalResponse: posadditionalamounts.originalAmountValue and posAmountGratuityValue. These are the original amount and the tip amount in minor units.\n\n\nIf the tip is a slight increase of the original amount, proceed to Capture the payment.\n\n\n\nIf the tip is a significant increase of the original amount, proceed to Adjust the authorization.\nThough the card schemes have different standards on when to adjust the authorization, a rule of thumb is to adjust it when the tip amount is higher than 20%.\n\n\n\n\n(Optional) Adjust the pre-authorization\nTo obtain a new authorization for the original amount plus the tip amount:\n\n\n    \n        \n        \n    \n\n\nCapture the payment\nTo ensure the original amount plus the tip amount is settled to your account, you need to manually capture the payment:\n\n\nMake a POST request to the\u00a0 \/payments\/{paymentPspReference}\/captures \u00a0endpoint, where paymentPspReference is the pspReference of the original pre-authorization. Specify:\n\namount: The currency of the final amount and its value in minor units. This is the sum of the original authorized amount and the tip.\nmerchantAccount: The name of your merchant account that is used to process the payment.\n\nFor more request and response details, see Pre-authorization.\n\n\nMake sure that you receive the asynchronous standard webhook. This informs you whether the final amount has been captured.\n\n\nSee also\n\n\n                    Pre-authorization\n                \n                    Adjust the payment authorization\n                \n                    Capture a payment manually\n                \n","type":"page","locale":"en","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"In-person payments","lvl2":"Tipping","lvl3":"Tipping on the receipt"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/point-of-sale","lvl2":"https:\/\/docs.adyen.com\/point-of-sale\/tipping","lvl3":"\/point-of-sale\/tipping\/tipping-on-receipt"},"levels":4,"category":"In-person payments","category_color":"green","tags":["Tipping","receipt"]}}
