Reverse Method

Reverses a previously authorized transaction.

Syntax

tsysreversal.reverse([callback])

Callback

The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).

The callback for this method is defined as:

function(err){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'err' has 2 properties which hold detailed information:

err.code
err.message

Remarks

To reverse a transaction, you need the following information from the original authorization:

Additionally, the CardNumber, CardEntryDataSource and expiration date from the original transaction must be included. Note that you should NOT be saving track data and submitting it in the reversal, you should only store the card number, expiration date, and entry data source.

Instead of setting these properties by hand, it is preferred that you can ParseAggregate with the XML aggregate returned from the authorizing class's GetDetailRecord method.

Then simply set the ReversalType, ReversalCode, and the new SettlementAmount, and then call Reverse. If the reversal was successful the ResponseCode property will be "00". All of the other Response properties will be identical to the values submitted in the properties above.

NOTE: Reversal transactions are not to be entered into the batch settlement. If a transaction has been partially reversed, the original detail record must be updated with the new AuthorizedAmount and SettlementAmount. If the transaction has been completely reversed the original detail record MUST NOT be included in the batch settlement.