AuthOnly Method

Sends an AuthOnly transaction to the host.

Syntax

ptechecommerce.authOnly([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

An Auth Only transaction is used to verify and reserve the cardholder's open-to-buy funds available at that time. This transaction is NOT added to the open batch. In order to settle (be paid) for this transaction, the merchant must run a Capture transaction using the original ResponseApprovalCode obtained during this Auth Only transaction. This will add the transaction to the batch. The funds may then be captured by settling the batch with the BatchRelease method. Typically any funds blocked with a Sale or Auth Only transaction are reserved for approximately seven (7) to ten (10) days. This may vary from issuer to issuer. Sample transactions follow.

E-Commerce AuthOnly transaction:

class.IndustryType = itECommerce
class.CardEntryDataSource = dsManuallyEntered
class.GoodsIndicator = giPhysicalGoods
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.InvoiceNumber = "1234"
class.AuthOnly()

Retail AuthOnly transaction:

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

Retail manually keyed AuthOnly transaction:

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