Properties   Methods   Events   Configuration Settings  

The FDMSLevel3 component is a tool used to create Level3 Corporate Purchasing Card addendum aggregates, which can then be passed to the FDMSSETTLE component and settled.

NOTE: What follows is a very short description of the component interfaces. For more information, please consult the help files that come with the respective package.

Remarks

This Level3Extension component creates Level III addendum data, which can be sent in the settlement to achieve a better interchange rate when accepting corporate purchasing cards. The Level III addendum allows the merchant to send very detailed information about every item that was purchased by the card holder, as well as tax and shipping information.

This component creates a different addendum aggregate based on the CardType. Visa and MasterCard addendums differ slightly, and therefore a slightly different set of properties are required for each.

List of valid Line Item properties for Visa:

• ItemQuantity (required)
• ItemUnitCost (required)
• ItemCommodityCode (optional)
• ItemDescription (optional)
• ItemDiscountAmount (optional)
• ItemProductCode (optional)
• ItemTaxAmount (optional)
• ItemTaxRate (optional)
• ItemTotal (optional)
• ItemUnits (optional)

List of valid Line Item properties for Mastercard:

• ItemDescription (required)
• ItemProductCode (required)
• ItemQuantity (required)
• ItemUnits (required)
• ItemUnitCost (optional)
• ItemTotal (required)
• ItemDiscountAmount (optional)
• ItemTaxIncluded (required)
• ItemTaxRate (required)
• ItemTaxAmount (required)
• ItemTaxType (required)

The following example illustrates how to build a Level III addendum for the ctVisa CardType:

'First, authorize the credit card FDMSECommerce.TransactionAmount = "2720" '$27.20 FDMSECommerce.Authorize() 'Then, put the result into the settlement component FDMSSettle.DetailRecordCount = 1 FDMSSettle.DetailAggregate[0] = FDMSECommerce.GetDetailAggregate() 'Then build the Level2 portion FDMSLevel2.CardType = ctVisa FDMSLevel2.CommercialCardType = FDMSECommerce.ResponseCommercialCard FDMSLevel2.OrderDate = "060828" 'September 28th, 2006 FDMSLevel2.FreightTaxAmount = "0" FDMSLevel2.FreightAmount = "600" FDMSLevel2.PurchaseIdentifier = "123456PURCHID" FDMSLevel2.CustomerCode = "CUSTCODE" FDMSLevel2.ShippedToZip = "90210" FDMSLevel2.ShippedFromZip = "90210" FDMSLevel2.TaxAmount = "120" 'Now build the Level3 portion FDMSLevel3.CardType = ctVisa FDMSLevel3.LineItemCount = 2 FDMSLevel3.ItemCommodityCode[0] = "4900" ' Books and printed materials FDMSLevel3.ItemDescription[0] = "Reference manual" FDMSLevel3.ItemDiscountAmount[0] = "" ' No discount FDMSLevel3.ItemProductCode[0] = "ISBN123456" FDMSLevel3.ItemQuantity[0] = "2" FDMSLevel3.ItemTaxAmount[0] = "60" FDMSLevel3.ItemTaxRate[0] = "600" ' 6.00 percent FDMSLevel3.ItemTotal[0] = "1060" FDMSLevel3.ItemUnitCost[0] = "500" FDMSLevel3.ItemUnits[0] = "each" FDMSLevel3.ItemCommodityCode[1] = "4900" FDMSLevel3.ItemDescription[1] = "Quick Start manual" FDMSLevel3.ItemDiscountAmount[1] = "" FDMSLevel3.ItemProductCode[1] = "ISBN654321" FDMSLevel3.ItemQuantity[1] = "1" FDMSLevel3.ItemTaxAmount[1] = "60" FDMSLevel3.ItemTaxRate[1] = "600" ' 6.00 percent FDMSLevel3.ItemTotal[1] = "1060" FDMSLevel3.ItemUnitCost[1] = "1000" FDMSLevel3.ItemUnits[1] = "each" 'Finally, add the Level2 and Level3 addendum data to the settlement at the same index 'as the associated transaction. FDMSSettle.DetailAddendum[0] = FDMSLevel2.GetAddendum() & FDMSLevel3.GetAddendum()

A Level III addendum for the ctMasterCard CardType is constructed similarly:

NOTE: You must send both a Level2 addendum and a Level3 addendum together in the same DetailAddendum. Level3 data cannot be processed without a corresponding Level2 aggregate. (However, you can send Level2 data without Level3 data).

Method List

Event List

Configuration Settings