--- title: "Feature Deployment Instructions: Supporting Surcharge" slug: "feature" updated: 2026-08-11T02:32:10Z published: 2026-08-11T02:32:10Z canonical: "support.kiosoft.com/feature" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.kiosoft.com/llms.txt > Use this file to discover all available pages before exploring further. # Feature Deployment Instructions: Supporting Surcharge This feature allows vendors to define a surcharge value on the reader and apply on the vending machine. > [!WARNING] > Note: This feature is unavailable effective 08/05/26. | **Release Date** | **Market** | **Payment Types** | **Minimum Terminal** **Version Requirement** | | --- | --- | --- | --- | | 07/13/2026 | All Market | Credit/Debit Card | V2500.003.010.006 | ## Enable Surcharge at the Location Level In Vendor Portal → Locations, enable the Surcharge toggle and define the surcharge value. The default setting is disabled, and the default value is 0.01. ![](https://cdn.document360.io/43d8b414-8496-484c-a971-494dc8473827/Images/Documentation/image-D2T7WQ96.png?sv=2026-02-06&spr=https&st=2026-11-18T20%3A48%3A22Z&se=2026-11-18T21%3A48%3A22Z&sr=b&sp=r&sig=5pDtTJlNroWAQ7rlCNleVRIGOxrQOgeOy%2FReddlrO8s%3D) ## Reader UI Display When a surcharge is enabled at the server/location level and the reader's profile includes Credit/Debit card payment, a surcharge prompt appears at the top of the idle screen. The complete prompt text is “A $x.xx Surcharge Will Be Added To Credit/Debit Card Transaction” ($x.xx is the Surcharge Value defined in Vendor Portal → Locations). | ![](https://cdn.document360.io/43d8b414-8496-484c-a971-494dc8473827/Images/Documentation/image-48GRTB4T.png?sv=2026-02-06&spr=https&st=2026-11-18T20%3A48%3A22Z&se=2026-11-18T21%3A48%3A22Z&sr=b&sp=r&sig=zKAvmDfHCrZWPnxGpE3tQD7ao7z8NVuI0s4PPwDTuPo%3D) | ![](https://cdn.document360.io/43d8b414-8496-484c-a971-494dc8473827/Images/Documentation/image-1T2KRML4.png?sv=2026-02-06&spr=https&st=2026-11-18T20%3A48%3A22Z&se=2026-11-18T21%3A48%3A22Z&sr=b&sp=r&sig=V2pbF5Y98wGISEckOMZ3V5JJOWvyaGBLsthmDCOPmGE%3D) | ![](https://cdn.document360.io/43d8b414-8496-484c-a971-494dc8473827/Images/Documentation/image-WBXY8KWI.png?sv=2026-02-06&spr=https&st=2026-11-18T20%3A48%3A22Z&se=2026-11-18T21%3A48%3A22Z&sr=b&sp=r&sig=dHJ4jctG%2BVSWwNnWaP06wJpeYZAfx28eWtJKw59eMXk%3D) | ![](https://cdn.document360.io/43d8b414-8496-484c-a971-494dc8473827/Images/Documentation/image-Q9Z76WJL.png?sv=2026-02-06&spr=https&st=2026-11-18T20%3A48%3A22Z&se=2026-11-18T21%3A48%3A22Z&sr=b&sp=r&sig=6NpNtyCsSNA5bzyVPHbtZvxgakubx0sYToMin2M9ezk%3D) | | --- | --- | --- | --- | | Idle Screen (Vertical) | Payment Screen (Vertical) | Idle Screen (Horizontal) | Payment Screen (Horizontal) | ## Review Report for Surcharge Information Detailed surcharge information for each credit/debit card transaction can be seen in the Vendor Portal → Reports → Detail Reports → Pay At Machine page, as well as in Reports → Pro reports. #### Pay At Machine | ![](https://cdn.document360.io/43d8b414-8496-484c-a971-494dc8473827/Images/Documentation/image-L7H0RV9X.png?sv=2026-02-06&spr=https&st=2026-11-18T20%3A48%3A22Z&se=2026-11-18T21%3A48%3A22Z&sr=b&sp=r&sig=0jv1hZdLdMDbpW8SqD97XmIssa%2FAL1jKlpHl2LNAy7k%3D) | | --- | #### Pro Reports Transaction Report & Refund Report. | ![](https://cdn.document360.io/43d8b414-8496-484c-a971-494dc8473827/Images/Documentation/image-HCNYDYOG.png?sv=2026-02-06&spr=https&st=2026-11-18T20%3A48%3A22Z&se=2026-11-18T21%3A48%3A22Z&sr=b&sp=r&sig=MwJ%2BU3z05P3%2F1vgfF8YixVb02rCl2L7SV2C30Ilf7AQ%3D) | | --- | | ![](https://cdn.document360.io/43d8b414-8496-484c-a971-494dc8473827/Images/Documentation/image-U2VCMN42.png?sv=2026-02-06&spr=https&st=2026-11-18T20%3A48%3A22Z&se=2026-11-18T21%3A48%3A22Z&sr=b&sp=r&sig=tgagGowPgJFcQrBzAEFsSOIIuTvxzah4bmssvyn7zRM%3D) |