{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","cards","card"]},"type":"markdown"},"seo":{"title":"Surcharging on Terminals | Finix Documentation","description":"Add a surcharge to in-person credit card payments on Finix terminals. Covers Standalone Mode, POS API integrations, and card brand requirements.","siteUrl":"https://docs.finix.com/","llmstxt":{"hide":false,"sections":[{"title":"Getting Started","includeFiles":["guides/getting-started/**/*.md"],"excludeFiles":[]},{"title":"Online Payments","includeFiles":["guides/online-payments/**/*.md"],"excludeFiles":["guides/online-payments/payment-features/fsa-hsa-non-healthcare-mcc.md"]},{"title":"In-Person Payments","includeFiles":["guides/in-person-payments/**/*.md"],"excludeFiles":[]},{"title":"Subscriptions","includeFiles":["guides/subscriptions/**/*.md"],"excludeFiles":[]},{"title":"After the Payment","includeFiles":["guides/after-the-payment/**/*.md"],"excludeFiles":[]},{"title":"Managing Operations","includeFiles":["guides/managing-operations/**/*.md"],"excludeFiles":[]},{"title":"Platform Payments","includeFiles":["guides/platform-payments/**/*.md"],"excludeFiles":[]},{"title":"Payouts","includeFiles":["guides/payouts/**/*.md"],"excludeFiles":[]},{"title":"Low-Code / No-Code","includeFiles":["low-code-no-code/**/*.md"],"excludeFiles":[]},{"title":"Developers","includeFiles":["additional-resources/developers/**/*.md"],"excludeFiles":[]},{"title":"Plugins","includeFiles":["additional-resources/plugins/**/*.md"],"excludeFiles":[]},{"title":"Industry Considerations","includeFiles":["guides/industry-considerations/**/*.md"],"excludeFiles":[]},{"title":"Regional Considerations","includeFiles":["guides/regional-considerations/**/*.md"],"excludeFiles":[]},{"title":"Release Notes","includeFiles":["release-notes/**/*.md"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"surcharging-on-terminals","__idx":0},"children":["Surcharging on Terminals"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add a surcharge to in-person credit card payments to help cover the cost of processing."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Finix terminals support surcharging through the device configuration. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["surcharge_basis_points"]}," field sets the surcharge as a percentage of the transaction amount and cannot exceed ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["300"]}," (3%). For more information, see the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://finix.com/docs/api/tag/Devices/#tag/Devices/operation/updateDevice"},"children":["Update Device API"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["How the surcharge gets applied depends on your integration:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Standalone Terminals:"]}," The Finix Payment App on the terminal calculates the surcharge and adds it to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Transfer"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization"]}," automatically. No additional steps are needed on your end."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POS API integrations:"]}," Reach out to your Finix point of contact or email ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"mailto:support@finix.com"},"children":["support@finix.com"]}," to incorporate surcharging appropriately into your integration."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Requirements"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Merchants must be enabled by Finix before processing surcharge fees. Reach out to your Finix point of contact or email ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"mailto:support@finix.com"},"children":["support@finix.com"]}," at least 35 days in advance. Card brand rules also apply: surcharges are limited to credit cards, capped at 3%, and must be disclosed to the buyer before payment. For more information, see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/online-payments/payment-features/buyer-charges/card-brand-fees/surcharge-fees"},"children":["Surcharge Fees"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"learn-more","__idx":2},"children":["Learn more"]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":3,"cardMinWidth":180},"children":[{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Surcharge Fees","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"outlined","to":"/guides/online-payments/payment-features/buyer-charges/card-brand-fees/surcharge-fees"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Review the full card brand requirements and refund rules for surcharge fees."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Configuration Overrides","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"outlined","to":"/guides/in-person-payments/device-capabilities/overrides"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Adjust terminal behavior per transaction using transaction-level flags."]}]}]}]},"headings":[{"value":"Surcharging on Terminals","id":"surcharging-on-terminals","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Learn more","id":"learn-more","depth":2}],"frontmatter":{"seo":{"title":"Surcharging on Terminals | Finix Documentation","description":"Add a surcharge to in-person credit card payments on Finix terminals. Covers Standalone Mode, POS API integrations, and card brand requirements."},"keywords":{"includes":["card-present surcharge","in-person surcharge","surcharge on terminal","surcharging","terminal surcharge"],"excludes":["convenience fees","payment links","virtual terminal"]}},"lastModified":"2026-09-15T22:17:40.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/in-person-payments/device-capabilities/surcharging","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}