on_card_range Event
Fired when the response to a Preparation Request Message (PReq) is received.
Syntax
class ServerCardRangeEventParams(object): @property def range_start() -> str: ... @property def range_end() -> str: ... @property def range_action() -> str: ... @property def acs_start_protocol_version() -> str: ... @property def acs_end_protocol_version() -> str: ... @property def ds_start_protocol_version() -> str: ... @property def ds_end_protocol_version() -> str: ... @property def three_ds_method_url() -> str: ... @property def acs_information_indicator() -> str: ... @property def valid() -> bool: ... @valid.setter def valid(value) -> None: ... # In class Server: @property def on_card_range() -> Callable[[ServerCardRangeEventParams], None]: ... @on_card_range.setter def on_card_range(event_hook: Callable[[ServerCardRangeEventParams], None]) -> None: ...
Remarks
The on_card_range 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.
RangeStart | 13-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. |
RangeEnd | 13-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. |
RangeAction | Indicates the action to be taken with the card range specified by the RangeStart and RangeEnd parameters.
Possible values are:
|
ACSStartProtocolVersion | The earliest (i.e. oldest) active protocol version that is supported by the ACS. |
ACSEndProtocolVersion | The most recent active protocol version that is supported by the ACS URL. |
DSStartProtocolVersion | The earliest (i.e. oldest) active protocol version that is supported by the DS. |
DSEndProtocolVersion | The most recent active protocol version that is supported by the DS. |
ThreeDSMethodURL | The fully qualified ACS URL that will be used by the 3DS method. |
ACSInformationIndicator | Additional 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:
|
Valid | Whether 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 card_range_start, card_range_end, card_range_action, card_range_acs_start_protocol_version, card_range_acs_end_protocol_version, and card_range_method_url properties.