--- title: "Tipping on the receipt" description: "Implement tipping on the receipt with authorization adjustment or overcapture." url: "https://docs.adyen.com/point-of-sale/tipping/tipping-on-receipt" source_url: "https://docs.adyen.com/point-of-sale/tipping/tipping-on-receipt.md" canonical: "https://docs.adyen.com/point-of-sale/tipping/tipping-on-receipt" last_modified: "2026-01-27T09:42:00+01:00" language: "en" --- # Tipping on the receipt Implement tipping on the receipt with authorization adjustment or overcapture. [View source](/point-of-sale/tipping/tipping-on-receipt.md) ##### Only when necessary Tipping on the receipt is harder to implement and subject to limitations. See [Tipping](/point-of-sale/tipping) for alternatives. 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. ## Requirements Before you begin, take into account the following requirements, limitations, and preparations. | Requirement | Description | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Integration type** | A [Terminal API](/point-of-sale/design-your-integration/terminal-api) integration with payment terminals. | | **Webhooks** | Set up [standard webhooks](/development-resources/webhooks/). | | **Limitations** | Make sure to check the [limitations](#limitations). | | **Setup steps** | Before you begin:- Set up [manual capture](/point-of-sale/capturing-payments#manual-capture). - If you want to use authorization adjustment, make sure you understand the [pre-authorization](/point-of-sale/pre-authorisation/) flow. - If you want to overcapture the amount, contact our [Support Team](https://ca-test.adyen.com/ca/ca/contactUs/support.shtml?form=other). | ## Authorization adjustment or overcapture There are two ways to implement tipping on the receipt: * [Adjust an authorization](#adjust-authorisation): 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. * [Overcapture](#capture): 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. The following table compares the two implementation methods for tipping on the receipt: | | Adjust authorization | Overcapture | | ------------- | -------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | | **Processes** | The authorized amount is increased *before* the final capture. | The final capture amount is higher than the authorized amount (within limits). | | **Use cases** | When the tipping on receipt amount is very high. | Standard tipping on receipt in restaurants, bars, taxis. | | **Fees** | Slightly higher scheme fees. | Standard (lower) fees. | | **Risks** | Lower risk, the bank authorizes the new total before capture. | Higher risk that the overcaptured (unauthorized) amount is charged back. This is subject to scheme rules. | ## How it works To implement tipping on the receipt: * Make a payment request with `authorisationType` set to **PreAuth**, in case you want to adjust the authorized amount after learning the tip amount. * Decide on your next step: * If the tip is a significant increase of the original amount, make a request to [adjust the authorization](#adjust-authorisation) with the tip amount. * If the tip amount is a relatively small increase, go straight to [capturing the payment](#capture). * Manually capture payment of the final amount. ## Limitations for tipping on the receipt 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. To follow this practice, take into account the following: * [Availability](/online-payments/adjust-authorisation#availability): support for authorization adjustment is limited to specific credit card schemes, and also depends on your Merchant Category Code (MCC). * If the tip is more than a certain percentage of the original authorized amount, the card schemes require an [authorization adjustment](#adjust-authorisation). 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%. * If you want to [overcapture](#capture) the total amount, including the tip without authorization adjustment, contact our [Support Team](https://ca-test.adyen.com/ca/ca/contactUs/support.shtml?form=other). If the tip is too high, this increase can be rejected or lead to a higher chargeback amount. * You need to manually capture the payment, ideally before the pre-authorization expires. Refer to [Expiration of authorizations](/online-payments/adjust-authorisation#validity). * The flow is not supported for wallets and debit cards. ## Pre-authorize the payment Initiate payment: 1. [Make a payment request](/point-of-sale/basic-tapi-integration/make-a-payment), specifying a [PaymentRequest](https://docs.adyen.com/api-explorer/terminal-api/latest/post/payment) object with: * `SaleData.SaleToAcquirerData`: **authorisationType=PreAuth** to indicate this is a pre-authorisation request. For more request and response details, see [Pre-authorization](/point-of-sale/pre-authorisation#pre-authorize). 2. When you receive the pre-authorization response: * Store the `pspReference` from the `AdditionalResponse` for later use when adjusting the authorization or capturing the payment. * If you are using synchronous authorization adjustment, also URL decode the `adjustAuthorisationData` blob and store it. 3. Check whether the customer added a tip. * **If the customer didn't add a tip**, proceed to [Capture the payment](#capture). 4. If 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](/development-resources/currency-codes). * **If the tip is a slight increase of the original amount**, proceed to [Capture the payment](#capture). * **If the tip is a significant increase of the original amount**, proceed to [Adjust the authorization](#adjust-authorisation).\ Though 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%. ## (Optional) Adjust the pre-authorization To obtain a new authorization for the original amount plus the tip amount: ### Tab: Asynchronous adjustment 1. Make a POST [/payments/{paymentPspReference}/amountUpdates](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments/\(paymentPspReference\)/amountUpdates) request, where `paymentPspReference` is the `pspReference` of the pre-authorization request. Specify: * `amount`: The `currency` and `value` of the new **total** amount **in minor units**. This is the sum of the pre-authorized amount and the additional amount. * `reason`: **DelayedCharge** * `merchantAccount`: The name of your merchant account that is used to process the payment. For more request and response details, see [Authorization adjustment](/point-of-sale/pre-authorisation#adjust-auth). 2. Make sure that you receive the [asynchronous standard webhook](/development-resources/webhooks). This informs you whether the new amount has been authorized. ### Tab: Synchronous adjustment 1. Make a POST [/adjustAuthorisation](https://docs.adyen.com/api-explorer/#/Payment/adjustAuthorisation) request, specifying: * `originalReference`: The `pspReference` of the pre-authorization request. * `modificationAmount`: The `currency` and `value` of the new **total** amount **in minor units**. This is the sum of the pre-authorized amount and the additional amount. * `additionalData.adjustAuthorisationData`: The `adjustAuthorisationData` blob you received in the response to your pre-authorization request, **in URL-decoded format**. * `merchantAccount`: The name of your merchant account that is used to process the payment. For more request and response details, see [Authorization adjustment](/point-of-sale/pre-authorisation#adjust-auth). 2. URL-decode and store the `adjustAuthorisationData` blob you receive in the `/adjustAuthorisation` response. You will need this if you later adjust the authorization again (although with tipping it is not expected you'll need to adjust the authorization more than once). ## Capture the payment To ensure the original amount plus the tip amount is settled to your account, you need to [manually capture the payment](/online-payments/capture#manual-capture): 1. Make a POST request to the  [/payments/{paymentPspReference}/captures](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments/\(paymentPspReference\)/captures)  endpoint, where `paymentPspReference` is the `pspReference` of the original pre-authorization. Specify: * `amount`: The `currency` of the final amount and its `value` in [minor units](/development-resources/currency-codes). This is the sum of the original authorized amount and the tip. * `merchantAccount`: The name of your merchant account that is used to process the payment. For more request and response details, see [Pre-authorization](/point-of-sale/pre-authorisation#capture-authorization). 2. Make sure that you receive the [asynchronous standard webhook](/development-resources/webhooks). This informs you whether the final amount has been captured. ## See also * [Pre-authorization](/point-of-sale/pre-authorisation) * [Adjust the payment authorization](/online-payments/adjust-authorisation) * [Capture a payment manually](/online-payments/capture)