All fields apply to both ERGs and RP ERGs unless specifically indicated otherwise.
Full Name
|
Field Name
|
Req’d
|
Business Rules
|
Start Date The Start Date is the date a fee item becomes active and is applied. The Start Date cannot be in the past when updating existing fee items. The fee item will start processing from the Start Date. If the fee item is saved on a profile, ERG or RP ERG with a date in the future, even though it is not currently being applied, it counts toward the overall "active" fee limit for that profile, ERG or RP ERG.
|
StartDate
|
Yes
|
|
Stop Date The Stop Date is the date after which a fee item expires. This date may be used to mark the end of the application of this fee item, or to stop the current rate and begin the next rate, if using the effective rate features in the Date Rate tag (located within the Pricing tag).
|
StopDate
|
N
|
Must be after start date.
|
Frequency Frequency is a setting to indicate when this fee item applies. This can be all months, or specific months. Each month is a separate three-letter tag: Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec.
|
FrequencyType
|
Yes
|
|
GL Item Code The GL Item Code can be used to group certain types of fee items for GL or other reporting purposes. This setting may be used in profiles and ERGs to differentiate between income and expense items. The client may then access profitability totals by his GL Item Code Values.
|
GLItemCodeType
|
N
|
|
User Data Code The User Data Code can be used to label groups of fee items for certain merchants with a client-defined value for reporting, searching and possible re-pricing at a later time. For example, a client may want to group pricing for hotels, or gas stations, or retail into different auth rates. The client may then access profitability totals by his User Data Code Values.
|
UserDataCodeType
|
N
|
|
 Align to Seasonal Billing
A fee item level indicator that will, if a merchant is seasonal with seasonal months, align the fee item billing frequency to be that of the merchant's seasonal months. This is completed when the fee item is added to the merchant profile, when a fee item is modified, or when a merchant's seasonal settings are established or modified.
For example, a merchant that has billing frequency established as September through March submits a request; fees containing a Y for SeasonalIndicator will set the fee item to have a billing frequency of September through March. If the merchant's billing frequency months are changed, the fee item's billing frequency months will also be changed.
|
AlignToSeasonalBilling
|
N
|
May not be used with IRG and Hierarchy Fee Items.
|
Count Net The Count Net/Gross/Both Indicator specifies how to apply the per item pricing, based on the sales and credits activity. The Count indicator tells the system how to treat the number of items. If the indicator is set to Gross, only sales are applied. If it is set to Net, sales – (minus) credits are applied. If it is set to Both, sales + (plus) credits are applied./Gross/
Both Flag
|
CountChargeType
|
Yes
|
One value must be applied. However, unavailable and not set when using with Apply 100% Interchange Fee and Cost Plus % on Fee (ERG only). Not required but may be set any time Apply 100% Interchange Fee is used; if sent it will be ignored when processing that rate method (RP ERG only). If Apply 100% Interchange Fee and Percent and/or Per Item ($) are chosen together, and this field is left blank, the fee will be processed as if the field had a value of Net (RP ERG only).
|
Amount Ne The Amount Net/Gross/Both Indicator specifies how to apply the percentage pricing, based on the sales and credits activity. The Amount indicator tells the system how to treat the dollar amount of items. If the indicator is set to Gross, only sales are applied. If it is set to Net, sales – (minus) credits are applied. If it is set to Both, sales + (plus) credits are applied.t/Gross/
Both Flag
|
AmountChargeType
|
Yes
|
One value must be applied. However, unavailable and not set when using with Apply 100% Interchange Fee and Cost Plus % on Fee (ERG only). Not required but may be set any time Apply 100% Interchange Fee is used; if sent it will be ignored when processing that rate method (RP ERG only). If Apply 100% Interchange Fee and Percent and/or Per Item ($) are chosen together, and this field is left blank, the fee will be processed as if the field had a value of Net (RP ERG only).
|
Per Item ($) Per Item ($) is a rate to be charged on a per item basis (dollar amount), calculated against the total number of transactions defined in each fee item. It is considered a rate method. It may be used alone as the only rate method, or combined with other rate methods, depending on which fee category is used.
|
PerItem
|
Cond.
|
At least one rate method must be chosen per fee item. May be used alone or with Percent. May not be used with Transaction Level Tiers. May be used with Agent % on Fee. May not be used with Apply 100% Interchange Fee and Cost Plus (%) on Fee (ERG only). May be used with Apply 100% Interchange Fee and Cost Plus (%) on Fee (RP ERG only). May not be used with Cap or Minimum if it is the only rate method used.
|
Percent (%) Percent is a rate to be charged on a percentage basis, calculated against the total dollar amount of the activity defined in each fee item. It is considered a rate method. It may be used alone, as the only rate method for a fee item, or in conjunction with other rate methods, depending on the fee category of the fee item.
|
Percent
|
Cond.
|
At least one rate method must be chosen per fee item. May be used alone or with Per Item ($), and/or with Agent % on Fee in any combination. May not be used with Apply 100% Interchange Fee or Cost Plus (%) on Fee (ERG only). May be used with Apply 100% Interchange Fee and/or Cost Plus (%) on Fee (RP ERG only).
|
Apply 100% Interchange Fee The Apply 100% Interchange Fee setting enables the user to expense an entire fee without entering the interchange rates. (For expenses in the Interchange category only.) When this rate method is selected, the system uses the latest published rate from the card brand to calculate the interchange fee.
|
ApplyICFee
|
Cond.
|
May not be used with Transaction Tier Pricing.
May be used with Cost Plus % on Fee or Agent % on Fee. May not use Count Net/Gross/Both or Amount Net/Gross/Both if only rate method used, or if only used with Cost Plus % on Fee and/or Agent % on Fee. May not be used with Per Item ($) or Percent (ERG only). May be used with Per Item ($) or Percent (RP ERG only).
|
Cost Plus (%) on Fee The Cost Plus (% of Fee) setting in the ERG accompanies the Apply 100% Interchange Fee The Apply 100% Interchange Fee setting enables the user to expense an entire fee without entering the interchange rates. (For expenses in the Interchange category only.) When this rate method is selected, the system uses the latest published rate from the card brand to calculate the interchange fee. or Apply 100% Card Brand Fee The Apply 100% Card Brand Fee setting enables the user to expense an entire fee from the card brand. (For expenses in the Card Brand category only.) When this rate method is selected, the system uses the latest published rate from the card brand to calculate the expense amount. fields. If this field is used, an additional percentage will be calculated in addition to passing 100% of the interchange or card brand fee as the calculated expense.
|
CostPlusFeePercent
|
Cond.
|
Only available when Apply 100% Interchange Fee is selected. May be used with Agent % on Fee (RP ERG only). May not be used with Per Item ($) or Percent (ERG only). May not be used with Count Net/Gross/Both or Amount Net/Gross/Both (ERG only). May be used with Per Item ($) or Percent (RP ERG only). May not be used with Count Net/Gross/Both or Amount Net/Gross/Both unless Percent and/or Per Item ($) are also used (RP ERG only).
|
Agent (%) On Fee Agent % on Fee is the percentage of the fee that the agent will pay to the next agent in the hierarchy.
|
AgentFeePercent
(RP ERG Only)
|
Cond.
|
For RP ERGs only; not available for ERGs. May be used with Per Item, Percent, Apply 100% Interchange Fee and Cost Plus % on Fee. May not be used with Count Net/Gross/Both or Amount Net/Gross/Both unless Percent and/or Per Item ($) are also used.
|
Tier Type Tier Type is a pricing method allowing different rates for different levels of activity, whether tiered by overall volume for the month.
|
TierType
|
Cond.
|
At least one rate method is required in each fee item. May not be used with Per Item or Percent. May not be used with Apply 100% Interchange Fee nor Cost Plus % on Fee. May be used with Agent (%) on Fee. May be used with Count Net/Gross/Both or Amount Net/Gross/Both.
|
Tier Min Factor The Tier Minimum Factor is the lowest value for each tier.
|
MinFactor
|
Cond.
|
Required for each tier. A tiered fee item must have at least two tiers and no more than nine tiers. First tier minimum must be zero.
|
Tier Max Factor The Tier Maximum Factor is the highest value for each tier. This is a calculated field based on the previous tier's minimum. It is not to be sent in XML.
|
MaxFactor
|
|
Note: Max Factor is calculated by the system based on Min Factor. If it is sent via XML it is ignored.
|
Tier Fee The Tier Fee sent may be either Percent, Per Item, or both.
|
Percent
PerItem
|
Cond.
|
Required for each tier. This can be Per Item and/or Percent.
|
