How to Use the Surcharge Pricing Programme

For managers setting up card surcharges in Backoffice and cashiers verifying the surcharge through a SalsaPOS card payment.

What the Surcharge Programme Does

The POS keeps the normal order total for cash and gift card payments. When the customer pays by card, it adds the configured surcharge percentage and records the added amount as CC Charges.

Before You Start

Use a Backoffice account that can change settings for the correct location.
Confirm the approved surcharge percentage before saving it.
Allow the setting to sync to the POS, then start a new order.
For this test flow, use a debug environment where Dummy Payment Response is enabled. Use the configured card terminal for a real transaction.

Part 1: Set Up Surcharge in Backoffice

Sign in to Backoffice for the correct location. Open Settings, find Pricing Set-up, and select Set Up Your Pricing.
Open Price Programme and select Surcharge. Enter the approved value in Surcharge Percentage; this example uses 10. Review the value, then select Save.

Mandatory: After saving changes in Backoffice, fully restart the SalsaPOS application on every POS device. The updated surcharge pricing program is not ready for use until SalsaPOS restarts and synchronizes.

Important: The percentage affects card payments after the setting reaches the POS. Test with a new order so an older ticket does not retain previous pricing.

Part 2: Take an Order and Pay by Card

On the POS, start a new order, select the order type, and add an item. Complete any required size or modifier choices. Review the order and select Checkout. The example order total is $4.81 before the card surcharge.
On Quick Pay, compare the payment methods. The normal total remains $4.81, while Card shows $5.29. The 10% surcharge is $0.48 after currency rounding. Select Card $5.29.
On Add Tip, let the guest choose a tip or select No Tip. Collect a signature when required, then select Continue. With Dummy Payment Response enabled, the test payment completes without a physical card terminal.
Confirm Payment Done Successfully shows $5.29 Paid By Card. Select the guest's receipt method, or select No Receipt for this test.
On the completed order, confirm the status is Settled, the payment is Credit $5.29, and CC Charges is $0.48. Select Close Order when finished.

Expected Result

The base order is $4.81. Selecting Card applies the 10% surcharge, charges $5.29, records $0.48 as CC Charges, and settles the order for the card amount.

Troubleshooting

Card shows the same amount as the order total: Confirm Surcharge and the percentage were saved for the correct location. Fully restart SalsaPOS, wait for synchronization, then create a new order.
The surcharge amount looks wrong: Recheck the Backoffice percentage. Remember that the final amount is rounded to the location's currency precision.
The test opens a terminal flow: Confirm Dummy Payment Response is enabled in the test build. Do not enable it in a live payment environment.
The card payment fails: In a live environment, check the selected payment terminal and network connection, then retry according to the location's payment procedure.
The order is paid but not closed: Choose a receipt option, confirm the Settled screen, and select Close Order.

Common Questions

Does the surcharge change the menu price? No. The POS adds the configured percentage when Card is selected.
Does Gift Card receive the surcharge? No. In the surcharge programme, the card adjustment applies to the credit-card payment path.
Where can I verify the added amount? Check CC Charges in the settled order details and confirm that Total Paid matches the Card amount.