/n software 3-D Secure V2 C++ Edition

Questions / Feedback?

CardRange Event

Fired when the response to a Preparation Request Message (PReq) is received.

Syntax

virtual int FireCardRange(ServerCardRangeEventParams *e);
typedef struct {
const char *RangeStart;
const char *RangeEnd;
const char *RangeAction;
const char *ACSStartProtocolVersion;
const char *ACSEndProtocolVersion;
const char *DSStartProtocolVersion;
const char *DSEndProtocolVersion;
const char *ThreeDSMethodURL;
const char *ACSInformationIndicator;
int Valid; int reserved; } ServerCardRangeEventParams;
virtual INT FireCardRange(ServerCardRangeEventParams *e);
typedef struct {
LPCWSTR RangeStart;
LPCWSTR RangeEnd;
LPCWSTR RangeAction;
LPCWSTR ACSStartProtocolVersion;
LPCWSTR ACSEndProtocolVersion;
LPCWSTR DSStartProtocolVersion;
LPCWSTR DSEndProtocolVersion;
LPCWSTR ThreeDSMethodURL;
LPCWSTR ACSInformationIndicator;
BOOL Valid; INT reserved; } ServerCardRangeEventParams;
- (void)onCardRange:(NSString*)rangeStart :(NSString*)rangeEnd :(NSString*)rangeAction :(NSString*)ACSStartProtocolVersion :(NSString*)ACSEndProtocolVersion :(NSString*)DSStartProtocolVersion :(NSString*)DSEndProtocolVersion :(NSString*)threeDSMethodURL :(NSString*)ACSInformationIndicator :(int*)valid;
func onCardRange(_ rangeStart: String, _ rangeEnd: String, _ rangeAction: String, _ ACSStartProtocolVersion: String, _ ACSEndProtocolVersion: String, _ DSStartProtocolVersion: String, _ DSEndProtocolVersion: String, _ threeDSMethodURL: String, _ ACSInformationIndicator: String, _ valid: inout Int32)

Remarks

The CardRange event fires for each range of card numbers to be added or removed from the cache. The RangeAction parameter indicates whether the range specified by the RangeStart and RangeEnd arguments is to be added or deleted from the current cache.

RangeStart13-19 digit account number from the Directory indicating the first number in a range of account numbers to be added or deleted from the current cache.
RangeEnd13-19 digit account number from the Directory indicating the last number in a range of account numbers to be added or deleted from the current cache. This End number must be the same length as the Start number.
RangeActionIndicates the action to be taken with the card range specified by the RangeStart and RangeEnd parameters. A indicates that the range is to be added to the cache, while D indicates that the range is to be deleted from the current cache. If the SerialNumber was not included in the Card Range Request, the RangeAction will be A (add) for all ranges returned.
ACSStartProtocolVersionThe earliest (i.e. oldest) active protocol version that is supported by the ACS.
ACSEndProtocolVersionThe most recent active protocol version that is supported by the ACS URL.
DSStartProtocolVersionThe earliest (i.e. oldest) active protocol version that is supported by the DS.
DSEndProtocolVersionThe most recent active protocol version that is supported by the DS.
ThreeDSMethodURLThe fully qualified ACS URL that will be used by the 3DS method.
ACSInformationIndicatorAdditional information on the card range as supplied by the ACS. This field is a comma separate list of values returned from the server; possible values are:
  • 01 - Authentication Available at ACS
  • 02 - Attempts Supported by ACS or DS
  • 03 - Decoupled Authentication Supported
  • 04 - Whitelisting Supported
  • 80-99 - Reserved for DS Use
ValidWhether or not the card range data is valid. If an issue is found with the card range data, this can be set to false to cause a 203 error to be returned to the directory server.

Note that the card ranges must be processed in the order returned.

These card ranges are also returned outside this event in the CardRangeStart, CardRangeEnd, CardRangeAction, CardRangeACSStartProtocolVersion, CardRangeACSEndProtocolVersion, and CardRangeMethodURL properties.

 
 
Copyright (c) 2021 /n software inc. - All rights reserved.
/n software 3-D Secure V2 C++ Edition - Version 2.0 [Build 7722]