Support Documentation
 
Library All Articles

Common

Enhancements

Reference

PosGreen Messages

External Apps

Backblaze

Knowledge Base

Payment Surcharge TEMP Files Fractional Pricing Receipts

Adding a Payment fee or Surcharge

If you need to charge a surcharge when customers pay using a specific payment type to some products but not all, then you can define the PaymentFee setting. This might be required where you are selling very low margin items and the customer wishes to pay by credit card, which attracts a percent charge to the retailer from the credit card provider.

This setting is only required in the narrow case of

  • The surcharge only applies to a specific payment type
  • Only some products attract the fee.
  • The payment acquirer (eg eftpos) does not have a way of applying surcharges directly

Enabling surcharges for payment types may be covered by Country specific rules and laws.

Payment fees are automatically applied at time of payment.

Where possible, the POS will restrict the customers actions when using surcharges. For some eftpos providers this means the debit/saving options are disabled.

Steps

Editting control files

Edit the file fpos_all.ctl on the lane, or in the central distribution folder if using centralised management. Insert the following line with changes as required. Warning case and space sensitive.

force:PaymentFee=2.5|3|6823|14,15,21,898,343

This setting is a pipe delimited list of values

  • The percentage fee to apply. 2.5% in this example
  • The payment type code. These can be seen under "Maintain Payment Types" on your store controller. 3 in the example means "eftpos". 3 meaning eftpos is standard over all Fieldpine retailers.
  • Output Product. This is the PID (6823 in this example) of a product that will automatically be added to the sale and adjust in value as required. Fieldpine requires that (sum items purchased) = (sum payments) so a product is added to the sale to ensure it balances accounting wise. Typically this product has a description like "Credit Card Surcharge" and is obvious to the shopper.
  • A comma separated list of Product ids to include in the fee calculation. In this example only Pids 14,15,21,898 and 343 attract the surcharge

The overall effect of this setting can be stated - If the sale includes pids 14,15,21,898 or 343, and the customer is paying by eftpos, the calculate a 2.5% amount based on only those products and add Product# 6823 to the sale for this amount.

Distributed Settings

If you have multiple lanes and stores and are NOT using a centralised deployment folder, you can enter the setting into your main Store controller and it will be deployed to all lanes.

From "settings" click "all settings" and enter a new a setting. The name is "PaymentFee" and the value is exactly the same as above.

Note, if you are using a Multi retailer model or are providing membership settings to other retailers you should NOT define this setting, as this is an individual retailer decision. The setting also includes retailer specific product Id#s