4D Payments SDK 2016 .NET Edition
4D Payments SDK 2016 .NET Edition
Questions / Feedback?

TSYSLineItem Type

Contains a single Level 3 line item.

Remarks

This type contains a single line item, used for Level 3 settlements. The fields contained by this type are listed below.

Fields

CommodityCode
String

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).

DebitCreditIndicator
String

Debit/Credit Indicator.

This 1-character field represents the sign of the Total. Possible values are:

C - Line Item Amount is a Credit (negative amount)
D - Line Item Amount is a Debit (positive amount)

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

Description
String

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.

DiscountAmount
String

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.

DiscountRate
String

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).

ProductCode
String

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
Integer

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.

TaxAmount
String

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.

TaxIncluded
Boolean

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).

TaxRate
String

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.

TaxType
String

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
String

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.

UnitCost
String

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).

Units
String

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.

Constructors

[VB.NET]
Public TSYSLineItem()

[C#]
public TSYSLineItem();



 
 
Copyright (c) 2020 4D Payments Inc. - All rights reserved.
4D Payments SDK 2016 .NET Edition - Version 16.0 [Build 7311]