Sale Method

Sends a Sale transaction to the host.

Syntax

globalcharge.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 settled. The batch settlement may be set up to occur automatically, or you can control when the batch settles with the GlobalBatchMgr class. Sample transactions follow.

Sale transaction with Track 1 data:

class.CardEntryDataSource = edsMagneticStripe
class.CardMagneticStripe = "5499990123456781=15125025432198712345"
class.TransactionAmount = "1.00"
class.Sale()

class.CardEntryDataSource = edsManuallyEntered
class.CardNumber = "4444333322221111"
class.CardExpMonth = 1
class.CardExpYear = 2015
class.TransactionAmount = "1.00"
class.Sale()