Sale Method

Sends a Sale transaction to the host.

Syntax

ptechcharge.sale([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

A basic sale transaction. This transaction decrements the cardholder's open-to-buy funds for the sale amount. This transaction is automatically added to the current open batch, and will be settled after the current batch is released with the PTechHostSettle class. Sample transactions follow.

E-Commerce Sale transaction:

class.IndustryType = itECommerce
class.GoodsIndicator = giPhysicalGoods
class.CardEntryDataSource = dsManuallyEntered
class.CardNumber = "4444333322221111"
class.CardExpMonth = 1
class.CardExpYear = 2010
class.CustomerAddress = "123 Nowhere Ln." ' optional AVS data
class.CustomerZip = "90210" ' optional AVS data
class.TransactionAmount = "1.00"
class.Sale()

Retail Sale transaction:

class.IndustryType = itRetail
class.CardEntryDataSource = dsTrack1
class.CardMagneticStripe = "B4788250000028291^PAYMENTECH^05121015432112345678"
class.TransactionAmount = "1.00"
class.Sale()

Retail manually keyed Sale transaction:

class.IndustryType = itRetail
class.CardEntryDataSource = dsManuallyEntered
class.CardNumber = "4444333322221111"
class.CardExpMonth = 1
class.CardExpYear = 2010
class.TransactionAmount = "1.00"
class.Sale()