# confirm\_surcharge\_accessible {% columns %} {% column width="33%" %} ![](/files/4eS5giFodFu7eRsl35Ju) “Cancel” option showing ![](/files/oiXS8PecjrYWsnCh8WYJ) “Accept” option showing {% endcolumn %} {% column %} **Description** Customer is prompted to confirm the surcharge amount incurred by the transaction. If no surcharge is to be applied to the transaction, the surcharge confirmation screen shall not be presented. When `Merchant.SurchargeApplicationBehavior` is set to *Card product-based surcharging with Merchant-override capability*, the surcharge alert is displayed at the beginning of the transaction. If the merchant decides that the transaction is not subject to surcharge, no surcharge will be added and the surcharge confirmation screen shall not be presented. When `Merchant.PreauthCompletionSurchargeType` is set to apply surcharge during completion, a disclaimer will be prompted indicating that this transaction may be subject to surcharge at completion during the pre-authorisation flow. \ **Customer Action** Selecting Accept will continue the transaction. Selecting Cancel will abort the transaction. Per configuration, the surcharge confirmation prompt will automatically time out after a set time. In normal (non-accessible) mode, the surcharge may be automatically accepted, allowing the transaction flow to proceed, *or* be automatically declined, resulting in cancellation of the transaction. In accessible mode, and when configured to beep and re-prompt, the terminal will beep periodically while awaiting customer decision to proceed. \ **Accessibility mode gestures** Swipe left or swipe right to reveal the next available option and hear its content vocalized. Upon revealing the option, the terminal will announce “showing”. When the desired option is heard, double-tap anywhere on the screen or press the tactile accessibility button on the side of the terminal to select the shown option. Terminal will announce “selected” and move on to the next step in the transaction flow. Option cards that are swiped away will be heard again in the next “round” as the customer continues to swipe through the options; thus, erroneous swipes can be corrected easily. \ **Configuration Parameters`Merchant.PurchaseSurchargeEnabled`** Surcharge may be applied to Purchase (+ Cash + Tip) transactions if this is enabled. \ \&#xNAN;**`Merchant.ContactlessSurchargeEnabled`** In addition to `Merchant.PurchaseSurchargeEnabled`, when this is enabled, surcharge may be applied to Contactless transactions. \ \&#xNAN;**`Merchant.CashOutOnlySurchargeEnabled`** Surcharge may be applied to Cash Only transactions if this is enabled. \ \&#xNAN;**`Merchant.MotoSurchargeEnabled`** Surcharge may be applied to MOTO transactions if this is enabled. \ \&#xNAN;**`Merchant.PreauthCompletionSurchargeType`** Surcharge may be applied to Pre-Auth/Completion transactions as configured. \ \&#xNAN;**`Merchant.SurchargeConfirmationRequired`** Indicates whether the surcharge amount must be confirmed by the customer after it has been calculated during EMV Chip and other non-Contactless transactions. \ \&#xNAN;**`Merchant.SurchargeConfirmationRequiredCtls`** Indicates whether the surcharge amount must be confirmed by the customer after it has been calculated during Contactless transactions.” \ \&#xNAN;**`Merchant.SurchargeConfirmationTimeoutBehavior`** Defines how the terminal will behave when the surcharge confirmation screen times out. 0 - Cancel Transaction 1 - Accept and proceed with transaction flow 2 - Beep and re-prompt *(this behavior is always used in Accessibility mode)* \ \&#xNAN;**`Merchant.DisplaySurchargeConfirmationNotice`** When enabled, a textual notice message will be displayed on the customer surcharge confirmation prompt. \ \&#xNAN;**`Terminal.SurchargeConfirmationTimeout`** The time in seconds that the surcharge confirmation screen will be displayed, before it is automatically dismissed. \ \&#xNAN;**`MerchantSurcharge.MerchantId`** Identifies the merchant to which the surcharge settings apply to. \ \&#xNAN;**`MerchantSurcharge.ProductId`** Identifies the card product to which the surcharge settings apply to. \ \&#xNAN;**`MerchantSurcharge.UseDomesticConfigForInternational`** When enabled, surcharging of transactions that utilize international payment methods follows the same rules as transactions utilizing domestic payment methods. The international configuration variants (below) are ignored. When disabled, unique International configuration parameters will control surcharging of transactions that utilize international payment methods. \ \&#xNAN;**`MerchantSurcharge.SurchargeType` / `MerchantSurcharge.SurchargeTypeInternational`** Specifies the type of surcharge to apply; one of: `Not Configured : 0`, `Fixed Amount : 1`, `Percentage : 2`. \ \&#xNAN;**`MerchantSurcharge.SurchargeValue` / `MerchantSurcharge.SurchargeValueInternational`** Specifies the value of the surcharge depending on the surcharge type – can be a fixed value or a percentage. e.g. 2.00 = $2.00 or 2.00%; 0 = $0.00 or 0%. When the card product is not subject to surcharge, the surcharge type must be set to 1 (Fixed Amount) and the surcharge value must be set to 0. \ \&#xNAN;**`MerchantSurcharge.MinSurchargeAdjAmount` / `MerchantSurcharge.MinSurchargeAdjAmountInternational`** Only applicable if `MerchantSurcharge.SurchargeType` is Percentage. Specifies the minimum surcharge amount; when the calculated applicable surcharge amount is below this value, only the Minimum Surcharge Adjustment Amount will be applied. (e.g. 2.00 = $2.00) \ \&#xNAN;**`MerchantSurcharge.MaxSurchargeAdjAmount` / `MerchantSurcharge.MaxSurchargeAdjAmountInternational`** Only applicable if `MerchantSurcharge.SurchargeType` is Percentage. Specifies the maximum surcharge amount; when the calculated applicable surcharge amount is above this value, only the Maximum Surcharge Adjustment Amount will be applied. (e.g. 2.00 = $2.00) \ \&#xNAN;**`MerchantSurcharge.MinSurchargeableAmount` / `MerchantSurcharge.MinSurchargeableAmountInternational`** If the surchargeable amount is below this value, surcharge is not applied and the surcharge confirmation screen shall not be presented. Note: zero-value transactions are subject to surcharge when this minimum is 0; minimum must be set to 0.01 or higher to exclude zero-value transactions. \ \&#xNAN;**`MerchantSurcharge.MaxSurchargeableAmount` / `MerchantSurcharge.MaxSurchargeableAmountInternational`** If the surchargeable amount is above this value, surcharge is not applied and the surcharge confirmation screen shall not be presented. \ **Surchargeable Amount** Part of the total transaction amount which a surcharge will be applied to, as follows: \\ Purchase only - surchargeable amount is the purchase amount Purchase + Cashout - surchargeable amount is the purchase amount only Purchase + Cashout + Tip - surchargeable amount is the purchase amount only Purchase + Tip - surchargeable amount is the purchase amount only Cashout only - surchargeable amount is the Cashout amount **Domestic vs International** In a *domestic* transaction, the card country of issue matches the terminal location country In an *international* transaction, the card country of issue differs from the terminal location country *MerchantSurcharge* parameters with “International” suffix apply to *international* transactions **Surchargeable Amount** **Domestic vs International** \ **Error Scenarios** If the customer cancels the transaction, Operator Abort message will be shown. If the device crashes or device reboots while on this screen, when the payment application restarts or device boots up, no power failure recovery will happen. If the transaction times out, Transaction Timeout message will be shown when configured to automatically cancel on timeout. {% endcolumn %} {% endcolumns %} \--- --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.verifone.com/functional-specification/confirm_surcharge_accessible.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.