TSYSLineItem Type

Code describing the good or service being supplied.

This field will contain an international description code of the individual good or service being supplied. The acquirer's bank will provide the merchant an updated listing of currently defined codes. It is recommended to use a National or International list of standardized codes.

The maximum length for this field is 12 characters.

This property is only used for Visa Corporate Purchasing Cards (CardType = ctVisa).

Description of the item.

This field contains an alphanumeric description of the item(s) being supplied.

The maximum length of this field is 35 characters.

This property is used for both Visa and MasterCard Corporate Purchasing Cards.

Amount of the discount for each line item (if any).

This field contains the amount of any discount applied by the merchant to this line item. This field should be empty (or zero) if the UnitCost reflects a discount price or if no line item discount applies.

This amount is to be presented with an implied decimal point. For example, US $10.00 must be represented as 1000, and $0.10 is likewise simply 10. The allowable number of significant digits as well as the positioning of any implied decimal point is dictated by the designated CurrencyCode configuration setting. In the United States (default), the number of allowable significant digits is seven. Thus the maximum TransactionAmount is "9999999", yielding a US dollar amount of $99,999.99. This field may not contain a negative number.

This property is used for both Visa and MasterCard Corporate Purchasing Cards.

Rate used to calculate the DiscountAmount.

This field contains the rate used to calculate the DiscountAmount. This field is a two decimal value. This property is only used for MasterCard Corporate Purchasing Cards (CardType = ctMasterCard).

Merchant-defined product code for this Line Item.

This field can contain a merchant-defined description of the individual item contained in this Line Item.

The maximum length of this field is 12 characters.

This property is used for both Visa and MasterCard Corporate Purchasing Cards.

Quantity of items in this Line Item.

This field contains the quantity of items being purchased, in whole numbers. For example, if your customer purchased 3 T-Shirts at $13.99 each, then:

  TSYSLevel3.LineItems.Add(new TSYSLineItem());
  TSYSLevel3.LineItems[0].Quantity = 3;
  TSYSLevel3.LineItems[0].UnitCost = "1399";
  TSYSLevel3.LineItems[0].Units = "each";
  TSYSLevel3.LineItems[0].Total = "4197"; // $13.99 x 3 = $41.97

This property is used for both Visa and MasterCard Corporate Purchasing Cards.

Tax on this individual item.

This field contains the amount of any Value Added Taxes (VAT) which can be associated with the purchased item.

This amount is to be presented with an implied decimal point. For example, US $10.00 must be represented as 1000, and $0.10 is likewise simply 10. The allowable number of significant digits as well as the positioning of any implied decimal point is dictated by the designated CurrencyCode configuration setting. In the United States (default), the number of allowable significant digits is seven. Thus the maximum TransactionAmount is "9999999", yielding a US dollar amount of $99,999.99. This field may not contain a negative number.

This property is used for both Visa and MasterCard Corporate Purchasing Cards.

Net/Gross Indicator.

If this field is true, the Total already contains the TaxAmount. If false, the TaxAmount has not yet been added to the Total. This property is only used for MasterCard Corporate Purchasing Cards (CardType = ctMasterCard).

Tax rate used to calculate the TaxAmount.

This field contains the tax rate used to calculate the TaxAmount. This field has a two-digit implied decimal position, and the maximum length is 4 digits.

This property is used for both Visa and MasterCard Corporate Purchasing Cards.

Type of tax charged in TaxAmount.

This 4-character field designates the type of value-added taxes that are being used.

This property is only used for MasterCard Corporate Purchasing Cards (CardType = ctMasterCard).

Total cost of this line item.

This field contains the total amount of the individual item, typically calculated as UnitCost multiplied by Quantity, with any TaxAmount and DiscountAmount taken into account. For example, if your customer purchased 3 T-Shirts at $13.99 each, then:

  TSYSLevel3.LineItems.Add(new TSYSLineItem());
  TSYSLevel3.LineItems[0].Quantity = 3;
  TSYSLevel3.LineItems[0].UnitCost = "1399";
  TSYSLevel3.LineItems[0].Units = "each";
  TSYSLevel3.LineItems[0].Total = "4197"; // $13.99 x 3 = $41.97

This amount is to be presented with an implied decimal point. For example, US $10.00 must be represented as 1000, and $0.10 is likewise simply 10. The allowable number of significant digits as well as the positioning of any implied decimal point is dictated by the designated CurrencyCode configuration setting. In the United States (default), the number of allowable significant digits is seven. Thus the maximum TransactionAmount is "9999999", yielding a US dollar amount of $99,999.99. This field may not contain a negative number.

Note: This field is 12 digits in length for Visa, but only 9 for MasterCard.

This property is used for both Visa and MasterCard Corporate Purchasing Cards.

Cost of each individual item.

This field contains the cost of each item in this Line Item. For example, if your customer purchased 3 T-Shirts at $13.99 each, then:

  TSYSLevel3.LineItems.Add(new TSYSLineItem());
  TSYSLevel3.LineItems[0].Quantity = 3;
  TSYSLevel3.LineItems[0].UnitCost = "1399";
  TSYSLevel3.LineItems[0].Units = "each";
  TSYSLevel3.LineItems[0].Total = "4197"; // $13.99 x 3 = $41.97

This amount is to be presented with an implied decimal point. For example, US $10.00 must be represented as 1000, and $0.10 is likewise simply 10. The allowable number of significant digits as well as the positioning of any implied decimal point is dictated by the designated CurrencyCode configuration setting. In the United States (default), the number of allowable significant digits is seven. Thus the maximum TransactionAmount is "9999999", yielding a US dollar amount of $99,999.99. This field may not contain a negative number.

This property is only used for Visa Corporate Purchasing Cards (CardType = ctVisa).

Unit of measure for this Line Item.

This field contains the alphanumeric code for units of measure as used in international trade. In practice, this should reflect the way in which the UnitCost is calculated. If you're selling rope by the foot, the Units might be "feet". If you're selling chemicals, it might be by the "ounce". For example, if your customer purchased 3 T-Shirts at $13.99 each, then:

  TSYSLevel3.LineItems.Add(new TSYSLineItem());
  TSYSLevel3.LineItems[0].Quantity = 3;
  TSYSLevel3.LineItems[0].UnitCost = "1399";
  TSYSLevel3.LineItems[0].Units = "each";
  TSYSLevel3.LineItems[0].Total = "4197"; // $13.99 x 3 = $41.97

The maximum length of this field is 12 characters.

This property is used for both Visa and MasterCard Corporate Purchasing Cards.