VoidTransaction Method

Voids a transaction in the current batch.

Syntax

Remarks

A stored value Void transaction allows the removal of a transaction from the open batch in the terminal. The void will communicate to the stored value host so that the host can reverse the requested stored value transaction.

The VoidTransaction method has two parameters, RetrievalNumberToVoid and LastRetrievalNumber. RetrievalNumberToVoid is the ResponseRetrievalNumber of the transaction you wish to void. LastRetrievalNumber should be set to the last ResponseRetrievalNumber received from the Paymentech Server. If LastRetrievalNumber is left blank, the contents of the ResponseRetrievalNumber property will be used instead.

Before sending a void, you must make sure that the CardNumber property contains the card number from the original transaction. For example:

control.CardNumber = "4444333322221111"
control.CardExpMonth = 1
control.CardExpYear = 2010
control.TransactionAmount = "1.00"
control.RedeemCard()

cnumToVoid = control.CardNumber
refNumToVoid = control.ResponseRetrievalNumber

...  more sale transactions ...

'All that's needed for a void:
control.SequenceNumber = control.SequenceNumber + 1
control.CardNumber = cnumToVoid 
control.VoidTransaction(refNumToVoid, control.ResponseRetrievalNumber) 

In the above void, if you use a new instance of the control or otherwise reset it's state, you must set the LastRetrievalNumber parameter as well.

Note: Voids cannot be performed on BalanceInquiry or Forced transactions.