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

DPayments.DPaymentsSDK.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. The SettlementAmount property in the detail record should be set to the SettlementAmount sent in the reversal transaction. The AuthorizedAmount in the detail record should contain the transaction amount authorized from the original authorization request message. This value is retrieved from the detail aggregate, however you may set it using the TSYSDetailRecord's AuthorizedAmount property. 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 = "10000";  // Original authorized amount
  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 TotalAuthorizedAmount property.

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.