RequestCardRanges Method

Sends a Card Range Request message to the Directory Server.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int RequestCardRanges();

Unicode (Windows)
INT RequestCardRanges();

- (void)requestCardRanges;

#define MID_MPI_REQUESTCARDRANGES 7

IPWORKS3DS_EXTERNAL int IPWORKS3DS_CALL IPWorks3DS_MPI_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

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.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)