Custom Fee Fields

Custom Fee Fields is a powerful feature in Payment Form. It allows you to charge your users different fee depends on the value(s) they enter/selected on a field on a form. If you use custom fee field feature, please remember the following rules:

  1. Only the custom fields has Fee Field property set to Yes will be used to calculate fee for the subscription.
  2. Custom Fee Fields only works for the following custom field types: List (Single + Multiple Select), Checkboxes, Radio and Textbox.
  3. On a form, there can be multiple custom fee fields. TOTAL AMOUNT USER HAS TO PAY = THE FORM AMOUNT + SUM OF ALL FEE FIELDS. (THE FORM AMOUNT is amount you enter in the Amount setting of the form)

Radio List + Single Dropdown Custom Field Type

Let says you are creating a custom field which allow users to choose membership type on your site. So you create a custom field with following parameters:

  1. Values : Basic Member (Free), Silver Member (+10$), Gold Member (+20$). Each item in one line.
  2. Default Values : Silver Member (+10$).
  3. Fee Values : 0, 10, 20 . Each item in one line.
  4. Field Type : Radio List.
  5. Fee Fied: must set to Yes

Radio Custom Fee Field

In the front-end , the system will display a radio custom field with 3 options : Basic Member (Free), Silver Member (+10$), Gold Member (+20$)

Radio custom fee field display

With the above settings:

  1. If users choose Basic Member , they won't have to pay any additional fee.
  2. If users choose Silver Member option, they will have to pay additional 10$.
  3. If users choose Gold Member option, they will have to pay additional 20$.

Please note the mapping 1-1 between Values and Fee Values settings of the custom field. Basic Member (Free) mapped To 0 . Silver Member (+10$) mapped to 10. Gold Member mapped to 20.

Checkboxes + MultiSelect Custom Field Type

You can setup a same field as Radio Custom Fee field mentioned above. The only difference is the way the fee is calculated. For Checkboxes and MultiSelect custom field, the fee which users will be charged will be total fee of all selected options. For example, with the above setup:

  1. If users If users select Basic Member , they won't have to pay any additional fee.
  2. If users select Silver Member option, they will have to pay additional 10$.
  3. If users select Gold Member option, they will have to pay additional 20$.
  4. If users select both Silver Member and Gold Member, they will have to pay additional 30$ (10$ for Silver Member and 20$ for Gold Member).

Textbox Custom Field Type

Let say you want to create a text field called Donation to allow users to make additional donation for you (beside paying for their fee). You can then create a new custom field with the following setting:

  1. Name : osm_donation_amount
  2. Title: Donation Amount
  3. Field Type: Text
  4. Fee Formula: [FIELD_VALUE]
  5. Fee Fied: Yes.

Now, any value users enter into this field will be added to total payment amount which users have to pay. For example, if they enter 10, 10$ will be added to total payment fee, if they enter 20, 20$ will be added to total payment fee and so on. As you can see [FIELD_VALUE] will be replaced with the value users entered in the field for calculating the fee in Fee Formula.

Understand Fee Formula

Fee Formula is a bit difficult to understand. However, once you get it, you will see that is is very powerful for fee calculation.

  1. You can use *math operators : +, -, , /** in the fee formula.
  2. When you use [FIELD_VALUE] tag in the fee formula, it will be replaced with the actual fee associated with that field for fee calculation:
    • If the field is a Text custom field, [FIELD_VALUE] will be replaced with the value subscribers enter on the textbox.
    • If the field is a single select field (Radio, Single Select box), [FIELD_VALUE] will be replaced with the fee amount corresponding with the value subscribers select for the field.
    • If the field is a multiple select field (Checkboxes, Multiple Select), [FIELD_VALUE] will be replaced with the total fee values of all the options which users select for that field.
  3. You can also use a custom fee in fee formular with the syntax: [NAME_OF_CUSTOM_FIELD_IN_UPPERCASE]. For example, if you have a textbox custom field called osm_quantity to allow users to enter quantity of the items they want to purchase, you can use the tag [PF_QUANTITY] in the fee formula of any custom fields. Please note that when you use a custom field in fee formula, it will be replaced with a value using the same rules with [FIELD_VALUE] tag mentioned above.