RequestCardRanges Method

Sends a Card Range Request message to the Directory Server.

Syntax

mpi.requestCardRanges([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

RequestCardRanges sends a Card Range Request (CRReq) message to the Directory Server specified by the DirectoryServerURL property. The resulting ranges can then be accessed by the CardRangeBegin, CardRangeEnd, and CardRangeAction properties. The SerialNumber property will be updated with a serial number that reflects the state of the current cache. If you call RequestCardRanges with a non- empty SerialNumber, the directory server will only return the changes to the cache since that SerialNumber was issued.

Card ranges returned by a Card Range Request are for credit cards that support 3-D Secure. If the customer's credit card number is not within one of these ranges, you cannot use 3-D Secure for that card. If the customer's credit card number is within the range, then you can check to see if the customer has enrolled for 3-D Secure services with VerifyEnrollment. Examples of card numbers that may not be eligible for 3-D Secure are check cards, corporate cards, and gift cards.