GetAggregate Method

Returns an aggregate containing level 3 details for a transaction.

Syntax

[VB.NET]
Public Function GetAggregate() As String

[C#]
public string GetAggregate();

Remarks

This method returns an aggregate containing the level 3 data specified. This aggregate must be passed to the ICharge component's Level3Aggregate property in order for the level 3 data to be sent in the transaction. Each gateway has different requirements when processing level 3 transactions. Please refer to Level3 to identify which properties are required for the gateway you are implementing.

An example of how this method is used is shown below:

	Level3.LineItems.Add(new EPLineItem());
  Level3.LineItems[0].CommodityCode = "4900"; // Books and printed materials
  Level3.LineItems[0].Description = "Reference manual";
  Level3.LineItems[0].DiscountAmount = ""; // No discount
  Level3.LineItems[0].ProductCode = "ISBN123456";
  Level3.LineItems[0].Quantity = "2";
  Level3.LineItems[0].TaxAmount = "60";
  Level3.LineItems[0].TaxRate = "600"; // 6.00 percent
  Level3.LineItems[0].Total = "1060";
  Level3.LineItems[0].UnitCost = "500";
  Level3.LineItems[0].Units = "each";

	Level3.LineItems.Add(new EPLineItem());
  Level3.LineItems[1].CommodityCode = "4900";
  Level3.LineItems[1].Description = "Quick Start manual";
  Level3.LineItems[1].DiscountAmount = "";
  Level3.LineItems[1].ProductCode = "ISBN654321";
  Level3.LineItems[1].Quantity = "1";
  Level3.LineItems[1].TaxAmount = "60";
  Level3.LineItems[1].TaxRate = "600"; // 6.00 percent
  Level3.LineItems[1].Total = "1060";
  Level3.LineItems[1].UnitCost = "1000";
  Level3.LineItems[1].Units = "each";
  
  ICharge.Level3Aggregate = Level3.GetAggregate();

NOTE: This method has a corresponding asynchronous version (GetAggregateAsync) for use in the WinRT environment.