4D Payments SDK 2016 .NET Edition

Questions / Feedback?

VoidTransaction Method

Voids a transaction in the current batch.

Syntax

public void VoidTransaction(string retrievalNumberToVoid, string lastRetrievalNumber);
Public Sub VoidTransaction(ByVal RetrievalNumberToVoid As String, ByVal LastRetrievalNumber As String)

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 RetrievalNumber of the transaction you wish to void. LastRetrievalNumber should be set to the last RetrievalNumber received from the Paymentech Server. If LastRetrievalNumber is left blank, the contents of the RetrievalNumber field will be used instead.

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


component.Card = new CCCard("4444333322221111", 1, 2010);
component.TransactionAmount = "1.00";
component.RedeemCard();

cnumToVoid = component.Card.CardNumber;
refNumToVoid = component.Response.RetrievalNumber;

...  more sale transactions ...

'All that's needed for a void:
component.Card = new CCCard(cnumToVoid, -1, -1); // Expiration date will be ignored
component.SequenceNumber++;
component.VoidTransaction(refNumToVoid, component.Response.RetrievalNumber);

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

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

.NET Standard Notes

To call this method in an asynchronous manner call VoidTransactionAsync instead. When the method completes (or an error is encountered) the VoidTransactionCompleted event will fire.

 
 
Copyright (c) 2021 4D Payments Inc. - All rights reserved.
4D Payments SDK 2016 .NET Edition - Version 16.0 [Build 7809]