All fields apply to both merchant pricing and hierarchical pricing 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.
|
DDA Account Type The DDA Account Type is the type of account specified in the Fee DDA Override Fee DDA Override is used for the purpose of a particular fee being directed to a different DDA than the primary DDA used for funding. .
|
DdaAccountType
|
Cond.
|
Only required when Fee DDA Override field is populated.
|
Fee DDA Override Fee DDA Override is used for the purpose of a particular fee being directed to a different DDA than the primary DDA used for funding.
|
DdaAccountOverride
|
N
|
|
Fee Transit Routing Override If the DDA is overridden (i.e. if a value is present in the Fee DDA Override Fee DDA Override is used for the purpose of a particular fee being directed to a different DDA than the primary DDA used for funding. ), the Fee Transit Routing Override routing number is needed to override the Transit Routing number set for the merchant.
|
TransitRouting
|
Cond.
|
Only required when Fee DDA field is populated.
|
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
|
|
 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.
|
Include in Monthly Minimum Fee Include in Monthly Minimum Fee is an indication of whether the fee will be included in a minimum discount comparison. For example an authorization fee item can be included with fee items in the Discount category and compared to an overall minimum discount of $20. If the calculated authorization plus the calculated discount equals $30, the minimum discount would not be applied. If the calculated authorization plus the calculated discount equals $19, the minimum discount of $20 would apply.
|
IncludeInMonthlyMinimum
|
N
|
This option is only available if the Overall Monthly Minimum option is turned on for the bank (i.e. if the bank subscribes to the Monthly Minimum service).
|
Daily Fee Indicator A fee item may be billed daily rather than assessed at month-end. If a fee item is billed daily it is deducted during ACH processing each day. For clients that participate in this service, the client may specify which banks use this option and which do not at client implementation. If a client does not participate in Daily Fee Assessment, the Daily Fee Indicator should not be used.
|
DailyFeeIndicator
|
N
|
Only available if the bank subscribes to the Daily Fee Assessment service.
|
Daily Fee ACH Type If a bank participates in Daily Fee Assessment and thus the Daily Fee Indicator A fee item may be billed daily rather than assessed at month-end. If a fee item is billed daily it is deducted during ACH processing each day. For clients that participate in this service, the client may specify which banks use this option and which do not at client implementation. If a client does not participate in Daily Fee Assessment, the Daily Fee Indicator should not be used. is set to 'Y' (Yes), an ACH payment method must be selected.
|
DailyFeeAchType
|
N
|
Only available if the bank subscribes to the Daily Fee Assessment service, and if Daily Fee Indicator is selected.
|
Billing Method Billing Method determines how the merchant pays for a fee item. It is required for all fee items.
|
BillingMethodType
|
Yes
|
|
Name & Address Usage Code Name and Address Usage Code indicates which name and address record will be used for a particular fee. The merchant’s Discount (DIS) name and address record is most commonly used. However, if a fee should be directed to a statement that is mailed to a different address, specify the name and address usage code for the targeted address.
|
NameAddressUsageCode
|
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
|
|
Combine Code The Combine Code is an option to combine fee items on the merchant statement. For example, if a merchant has five authorizations fee items, setting this combine code to auth on all five items instructs the system to take all of these fees and bundle them into one line item on the merchant’s statement. The Statement Fee Description The Statement Fee Description is the description that will display on the merchant statement. If this field is used, one line, with this description, will display on the statement for the fee item. An alternative is to use the Display Detail on Statement Display Detail on Statement provides an option to break out the activity in one fee item and provide that detail on the merchant’s statement. This option must be selected if the client wants the merchant to see a description for each fee type within a fee item. This is a convenient feature to bundle many items for pricing (into one fee item), but unbundle on the merchant statement for reporting. setting. should be identical for each fee item included with a common Combine Code. If the descriptions are not identical, PPM selects one of the descriptions to display on the statement.
|
CombineCode
|
N
|
May not be used with the Display on Statement: Detail setting
|
Statement Fee Description The Statement Fee Description is the description that will display on the merchant statement. If this field is used, one line, with this description, will display on the statement for the fee item. An alternative is to use the Display Detail on Statement Display Detail on Statement provides an option to break out the activity in one fee item and provide that detail on the merchant’s statement. This option must be selected if the client wants the merchant to see a description for each fee type within a fee item. This is a convenient feature to bundle many items for pricing (into one fee item), but unbundle on the merchant statement for reporting. setting.
|
StatementFeeDescription
|
Cond.
|
May not be used with Display on Statement: Detail setting. Required if not using Display on Statement Detail field.
Note: A value sent in this field will produce an error if the Display Detail tag is Yes; the fee item will be rejected.
|
Display on Statement: Detail Display Detail on Statement provides an option to break out the activity in one fee item and provide that detail on the merchant’s statement. This option must be selected if the client wants the merchant to see a description for each fee type within a fee item. This is a convenient feature to bundle many items for pricing (into one fee item), but unbundle on the merchant statement for reporting.
|
DisplayDetail
|
N
|
May not be used with Statement Fee Description or Combine Code.
|
Display on Statement: Count Display on Statement: Count provides an option to display on the merchant statement the total number of items used to calculate the fee. For example, using this setting would display how many authorization transactions a merchant had for a particular auth fee.
|
DisplayCount
|
N
|
|
Display on Statement: Amount Display on Statement: Amount provides an option to display the total dollar amount of the items used to calculate the fee.
|
DisplayAmount
|
N
|
|
Display Rates on Statement Display Rates on Statement provides an option to display the rates for a particular fee item on the merchant’s statement. It will display Per Item ($) and Percent rates for Per Item, Percent, Pass Through and Tiered pricing. Rates applied over and above the Pass Through Rates will be combined into the Percent and Per Item ($) rates displayed.
|
DisplayRate
|
N
|
May be used with Percent, Per Item ($), Qual Per Item, Qual Percent, or Pass Through Interchange pricing. If the rate is negative it will display as negative on the statement.
|
Combine Fee on Rate Change Combine Fee on Rate Change is used if a rate changes mid-month. Normally when a rate change occurs, two line items will display on the statement, one for each set of activity that applied to each rate. The Combine Fee on Rate Change option allows the user to combine both line items into one item on the merchant’s statement. The merchant will see one line item, with a total of the calculated fees from the month, regardless of what rate was applied throughout the month.
|
CombineFeeOnRateChange
|
N
|
|
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. Is not required if used with Pass Through Interchange rate method. If Percent and/or Per Item are used along with Pass Through Interchange and this field is not populated, the fee item will be processed as if this field contained a value of Net.
|
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. Is not required if used with Pass Through Interchange rate method. If Percent and/or Per Item are used along with Pass Through Interchange and this field is not populated, the fee item will be processed as if this field contained a value of Net.
|
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 with Percent, Qualification Per Item ($), Qualification Percent, and/or Pass Through Interchange in any combination.
|
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 with Per Item ($), Qualification Per Item ($), Qualification Percent, and/or Pass Through Interchange in any combination.
|
Qualification Per Item ($) Qualification Per Item ($), primarily used for interchange differential pricing, will compare the actual interchange rate for each transaction to the rate defined as the qualified rate, in the fee item. Only the difference between the two rates is charged to the merchant.
|
QualificationRateAmount
|
Cond.
|
At least one rate method must be chosen per fee item. May be used with Percent, Per Item ($) and/or Qualification Percent in any combination. May not be used with Pass Through Interchange.
|
Qualification Percent (%) Qualification Percent (%), primarily used for interchange differential pricing, will compare the actual interchange rate for each transaction to the rate defined as the qualified rate in the fee item. Only the difference between the two rates is charged to the merchant.
|
QualificationRatePercent
|
Cond.
|
At least one rate method must be chosen per fee item. May be used with Per Item ($), Percent, and/or Qualification Per Item ($) in any combination. May not be used with Pass Through Interchange.
|
Pass Through Interchange The Pass Through Interchange rate method allows the acquirer to pass the actual interchange fee directly to the merchant. The system calculates these fees based on the most current interchange rates from the major card brands.
|
PassThroughInterchange
|
Cond.
|
At least one rate method must be chosen per fee item. May be used alone, or with Per Item ($) and/or Percent. May not be used with Qualification Percent or Qualification Per Item ($). May not be used with Count Net/Gross/Both, nor Amount Net/Gross/Both if it is the only rate method chosen.
|
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 Percent, Per Item, Pass Through Interchange, Qualification Percent, nor Qualification Per Item ($).
|
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.
|
Tier Statement Fee Description The Tier Statement Fee Description provides the ability to set a fee description on the statement for each tier.
|
StatementFeeDescription
|
Cond.
|
Required for each tier.
|
Lock Settings – Hierarchy Profiles Only
|
Fee Item Rate Lock The Fee Item Rate Lock applies to hierarchy profiles only. This field is not available for merchant profiles or ERGs.
|
RateLock
|
N
|
For hierarchy profiles only – may use on Per Item, Percent, Qualification Per Item, Qualification Percent, Pass Through Interchange and Transaction Tiers.
|
Fee Item Rate Range Max The Fee Item Rate Range: Maximum applies to hierarchy profiles only. This field is not available for merchant profiles or ERGs.
|
Max
|
N
|
For hierarchy profiles only – may use on Per Item, Percent, Qualification Per Item, Qualification Percent, Pass Through Interchange and Transaction Tiers.
|
Fee Item Rate Range Min The Fee Item Rate Range: Minimum applies to hierarchy profiles only. This field is not available for merchant profiles or ERGs.
|
Min
|
N
|
For hierarchy profiles only – may use on Per Item, Percent, Qualification Per Item, Qualification Percent, Pass Through Interchange and Transaction Tiers.
|
Fee Item Rate Range Lock The Fee Item Rate Range Lock (that is, the restriction of the allowable range of values for this fee item) applies to hierarchy profiles only. This field is not available for merchant profiles or ERGs.
|
RangeLock
|
N
|
For hierarchy profiles only – may use on Per Item, Percent, Qualification Per Item, Qualification Percent, Pass Through Interchange and Transaction Tiers.
|
