How to Configure Location Payment Processing Settings
The Payment Processing tab lets a location use its own payment processor and configure features like tips, surcharges, void/refund behavior, and automatic batch settlement.
Prerequisites
Before location payment processing override works:
- A global payment processor must be configured in Settings → Payment Processing
- The global processor must have "Allow Location Override" turned on
If override is not allowed, you will see the message: "Location payment processor override is disabled by global settings. Configure the global processor in Settings → Payment Processing."
Opening the Payment Processing Tab
- Open the location for editing
- Click the Payment Processing tab
Payment Processor Settings
The top section contains the Payment Processor Settings control, which lets you:
- Select a processor type (Stripe, Worldpay, Manual, etc.)
- Enter the processor's API credentials for this location
- Test the connection
This allows different locations to use different payment processors or different merchant accounts.
Tips Configuration
| Setting | Default | Description |
|---|---|---|
| Enable Tips | Off | Master toggle. When checked, tip prompts appear during payment at POS machines in this location. |
| Tip Preset 1 | 15% | First suggested tip percentage shown to customers |
| Tip Preset 2 | 18% | Second suggested tip percentage |
| Tip Preset 3 | 20% | Third suggested tip percentage |
| Tip Preset 4 | 25% | Fourth suggested tip percentage |
| Allow Custom Tip | On | When checked, customers can enter a custom tip amount instead of using presets |
When "Enable Tips" is unchecked, all tip preset fields and the custom tip checkbox are disabled and hidden from the POS.
Surcharge Configuration
| Setting | Default | Description |
|---|---|---|
| Enable Surcharge | Off | Master toggle. When checked, a surcharge is added to card payments at this location. |
| Surcharge Percent | 0.00% | The percentage surcharge added to card transactions (0–4%, in 0.25% increments) |
| Surcharge Label | "Card Processing Fee" | The text shown on the receipt describing the surcharge |
Note: Surcharge percentages are validated to ensure compliance. Most jurisdictions cap credit card surcharges at 3-4%.
Processor Behavior
| Setting | Description |
|---|---|
| Void Through Processor | When checked, voided transactions are sent to the payment gateway for reversal. When unchecked, voids are handled locally only. |
| Refund Through Processor | When checked, refunds are sent to the payment gateway. When unchecked, refunds are handled locally. |
| Auto Batch Settlement | When checked, enables automatic end-of-day batch settlement at the time you specify |
| Settlement Time | The time of day when automatic batch settlement runs (e.g., 11:00 PM). Only active when Auto Batch Settlement is checked. |
Saving Payment Processing Settings
Payment processing settings are saved when you click Save & Close on the Location form. This saves both the processor credentials and all feature toggles (tips, surcharges, void/refund behavior, batch settlement).