VoidTransaction Method

Used to void a debit sale or credit transaction.

Syntax

fdmsdebit.voidTransaction([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

This method can be used to void a Sale or Credit transaction that was previously made using this class. A Debit Void is a specialized transaction that corrects the impact of an approved Financial Transaction (Sale or Credit) because an error was discovered in the transaction or the customer changed his or her mind. A Debit Void is not used by the merchant as a way to credit a customer for returned merchandise.

The ReceiptNumber, KSN, TransactionAmount, CashBack, TransactionNumber, and all Card properties must be identical to the values submitted in the original sale, and the ApprovalCode parameter should contain the ResponseApprovalCode received in the original Response.

First Data will always send an ResponseApprovalCode of "AP888888" or "AP868686" as a response to a debit void, regardless of whether the original transaction occurred or not.

Important Note: You must ping your list of service provider URLs and update the URL property to the service provider with the shortest response time every 100 transactions, as well as when your application initially starts. This is not a normal ICMP ping - to determine the fastest transaction URL you must use the special Ping method inside the FDMSRegister class. (You may update your list of service provider URLs with the FDMSRegister class's ServiceDiscovery method).