DetailRecordAggregate Property

Set this property with xml aggregates of the transactions you wish to settle.

Syntax

tsyssettlecontrol.DetailRecordAggregate(DetailRecordIndex)[=string]

Default Value

""

Remarks

Set this property with xml aggregates of the transactions you wish to settle.

To settle previously authorized transactions, this property must be set with the xml aggregate returned from the TSYSRetail, or TSYSECommerce control's GetDetailAggregate method. For instance:

  TSYSSettle.DetailRecordCount = 1
  TSYSSettle.DetailAggregate[0] = TSYSRetail.GetDetailAggregate()

On occasion, you may need to modify these aggregates before sending them to settlement. For instance, if you're running a restaurant you may need to add a gratuity to the charge. If you're accepting installment payments, you will need to add the installment info. To accomplish this, you may use the TSYSDetailRecord control.

For example, to add a gratuity to a charge:

  DetailRecord.ParseAggregate(TSYSRetail.GetDetailAggregate())
  DetailRecord.Gratuity = "500"
  DetailRecord.SettlementAmount = DetailRecord.AuthorizedAmount + DetailRecord.Gratuity
  TSYSSettle.DetailAggregate[0] = DetailRecord.GetDetailAggregate()

To settle a transaction authorized with the ttInstallment TransactionType, you must use the TSYSDetailRecord control to add the number of this installment and the total count of all installments to be made. For instance, if the purchase was for "Three easy payments of $19.95", and this is the first payment, then the installment number will be 1, and the installment count 3. An example is included below:

  TSYSECommerce.TransactionType = ttInstallment
  TSYSECommerce.TransactionAmount = "1995"
  TSYSECommerce.Authorize()

  DetailRecord.ParseAggregate TSYSECommerce.GetDetailAggregate()
  DetailRecord.InstallmentCount = 3
  DetailRecord.InstallmentNumber = 1
  
  TSYSSettle.DetailAggregate[5] = DetailRecord.GetDetailAggregate()

The size of the array is controlled by the DetailRecordCount property.

This property is not available at design time.

Data Type

String