Force Method

Sends a Force (Prior) transaction to the PaymenTech server.

Syntax

ptechbenefit.force(voiceAuthCode, voucherNum, [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

Force (Prior) transactions are typically used when a customer's EBT card was declined or referred, and the merchant has called the call center to receive an authorization code and voucher number. A Force transaction adds the transaction to the current open batch, and the transaction will be settled at the next call to the PTechHostSettle class's BatchRelease method.

The EBT card may be specified by either a CardMagneticStripe returned by a card reader, (Track2 only), or manually entered through the CardNumber. CardExpMonth, and CardExpYear.

The ResponseCode and ResponseText properties indicate whether this transaction was successful.

Manually keyed force:

class.CardNumber = "4444333322221111" 
class.CardExpMonth = 1 
class.CardExpYear = 2010
class.TransactionAmount = "1.00" 
class.Force("123456", "543210987654321") 'values received from the call center