TSYSReversal Component

Properties   Methods   Events   Configuration Settings   Errors  

The TSYSReversal component is used to reverse transactions that were previously authorized using the TSYSRETAIL , TSYSECOMMERCE , or TSYSHEALTHCARE components.

Syntax

nsoftware.InPayDirect.Tsysreversal

Remarks

Credit card authorizations put a hold on funds on a credit card, until the time at which the transaction is settled or the hold expires. Reversals are similar to voids, but they're online transactions. Voids are off-line. This means that a void will not release the hold on funds at the next batch settlement (usually). Authorization reversals are online transactions, meaning that the hold on funds is immediately removed, and the cardholder may use the funds on the card for other purchases.

This component works for all IndustryTypes and supports Credit, EBT, and Debit card transactions. Both partial and full reversals are supported. When a transaction has been fully reversed (SettlementAmount is "0") the original transaction must not be included in the batch settlement. However, if the transaction has been only partially reversed, the original detail record must be updated with the new settlement amount. Both SettlementAmount and AuthorizedAmount in the detail record should be set with the SettlementAmount sent in the reversal transaction. The TotalAuthorizedAmount configuration setting should contain the original authorization amount. You must also set the PartiallyAuthorized configuration setting to True. For instance:

  TSYSRetail.TransactionAmount = "10000"; // $100.00
  TSYSRetail.Authorize();
  
  TSYSReversal.ParseAggregate(TSYSRetail.GetDetailAggregate());
  TSYSReversal.ReversalCode = rcCustomerDirected;
  TSYSReversal.ReversalType = rtPreSettlement;
  TSYSReversal.SettlementAmount = "5000"; // $50.00
  TSYSReversal.Reverse();

  TSYSDetailRecord.ParseAggregate(TSYSRetail.GetDetailAggregate());
  TSYSDetailRecord.AuthorizedAmount = "5000"; // Current open authorization
  TSYSDetailRecord.SettlementAmount = "5000"; // Amount you wish to settle (need not be equal to AuthorizedAmount)
  TSYSDetailRecord.Config("PartiallyReversed=True");
  
  TSYSSettle.DetailRecords.Add(new TSYSRecordType(TSYSDetailRecord.GetDetailAggregate()));

So long as you pass aggregates around, the TSYSDetailRecord's TotalAuthorizedAmount will still reflect the originally authorized amount. You may change this using the TSYSDetailRecord's Config method.

When the component receives a response from the Vital/TSYS servers, the result of the reversal will be displayed in several Response properties. The Code indicates whether the reversal was approved, and the remaining response properties should exactly match the response from the original authorization.