Add Convenience Fee

💡What is a Convenience Fee?

A convenience fee is a fee charged by a seller when a consumer pays with an electronic payment card rather than by a standard form of payment accepted by the business. Standard payments include cash, check, or an Automated Clearing House (ACH) transfer.

Convenience fees can be a fixed dollar amount or a percentage of the sale and must be disclosed to the consumer in advance.

Add Convenience Fee

TWO WAYS TO ADD CONVENIENCE FEE

✦ Payment Forms with Credit Card Payments ONLY

✦ Payment Forms with Credit Card and ACH Payment option (for version 2.0)

Credit Card Payments

1. Each component has their own API name. To be able to get the field components' API name, simply drag and drop the selected component and click API. Copy API name.

NOTE: Field components' API name can be changed. This is optional.

(e.g. In the example below, component used is Multiple Product and has been renamed from productfield to multipleproduct.)

2. Drag and drop a PRICE component and under the Display tab, rename the field to Convenience Fee.

3. Scroll down on Display tab and tick DISABLED. This is required to block customers from editing this field.

4. Go to Data tab, untick clear value when hidden and click Calculated Values.

5. Under Calculated Value, type the following script in the JavaScript field:

❖ value = data.{FieldComponentAPIname}.amount * {Convenience Fee rate in decimal form};

↳ For example, 5% is the rate for merchant’s convenience fee and in the example above, API name has been renamed to multipleproduct. Hence, calculated value script would be:

❖ value = data.multipleproduct.amount * 0.05;

6. Click Save, finish up building the Payment Form and embed to an HTML page.

Credit Card and ACH Payments (for version 2)

1. For payment forms with two payment options, first, get the API name of the Payment System component. This can also be renamed.

2. Go to the Data tab of the Price component. Under Calculated Value, type the following script in the JavaScript field:

❖ value = data.{PaymentSystemComponentAPIname} && data.{PaymentSystemComponentAPIname}.paymentType === '{PaymentTypeToChargeConvenienceFee}' ? data.{FieldComponentAPIname}.amount * {Convenience Fee rate in decimal form};

↳ For example, paying using credit card. The rate for merchant’s convenience fee is 5% and in the example above, API name has been renamed to multipleproduct. Payment System Component’s API name remains as heartlandpayment. Hence, calculated value script would be:

❖ value = data.heartlandpayment && data.heartlandpayment.paymentType === 'credit_card' ? data.multipleproduct.amount * 0.05 : 0;

NOTE: Change ‘credit_card’ to ‘ach’ when merchant prefers to charge a convenience fee ONLY for ACH payments.

3. Under the Price component, go to Conditional tab and click Advanced Conditions.

4. Type the following script in the JavaScript field:

❖ show = data.{PaymentSystemComponentAPIname} && data.{PaymentSystemComponentAPIname}.paymentType === '{PaymentTypeToChargeConvenienceFee}';

↳ For example, selected payment type to charge convenience fee is credit card. Payment System Component’s API name remains as heartlandpayment. Hence, calculated value script would be:

❖ show = data.heartlandpayment && data.heartlandpayment.paymentType === 'credit_card';

NOTE: Change ‘credit_card’ to ‘ach’ when configured calculated value under the Data tab is ACH.

5. Click Save, finish up building the Payment Form and embed to an HTML page.