ActivateCard Method

Activates a Gift Card.

Syntax

ptechgiftcard.activateCard([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

Stored value Activation transactions provide merchants the ability to activate a new stored value card on the Chase Paymentech stored value host. Activation transactions can only be performed on cards that have not been previously activated. Activation transactions are usually used by merchants who wish to identify how many new stored value cards have been issued, from the previously activated stored value cards that have had additional value issued. Merchants have the ability to activate stored value cards with a host configured pre-denominated TransactionAmount or activate the cards with a flexible TransactionAmount. With pre-denominated cards, dependent on host configurations, the stored value host will either approve the transaction for the amount that the pre-denominated card is setup for (regardless of the amount keyed), or decline the transaction if the amount keyed at the Point-of-Sale if the amount doesn't match the amount identified on the card.

This transaction is automatically added to the current open batch, and will be settled when the PTechHostSettle class's BatchRelease method is called.

The gift card may be specified by either a CardMagneticStripe returned by a card reader, (Track2 only), or manually entered through the CardNumber, CardExpMonth, and CardExpYear.A 3-digit Card Verification Value code may also be supplied in the CardCVVData property.

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

Note: Activation transactions will fail at the stored value host if the card has been previously activated or has previously had value issued to it. Also, ActivateCard cannot be used to activate a card that has been deactivated via the DeactivateCard method. You must use the ReactivateCard method instead.