234
Information about this Replacement Replacement The January 2008 MasterCard Authorization Simulator replaces your existing manual. What is in the new version? This new version reflects changes effective with Banknet Release 08.1. Please refer to: Summary of Changes” for a comprehensive list of changes reflected in this update. Using this Manual” for a complete list of the contents of this manual. Questions? If you have questions about this manual, please contact the Customer Operations Services team or your regional help desk. Please refer to “Using this Manual” for more contact information. MasterCard is Listening… Please take a moment to provide us with your feedback about the material and usefulness of the MasterCard Authorization Simulator using the following e-mail address: [email protected] We continually strive to improve our publications. Your input will help us accomplish our goal of providing you with the information you need.

Credit Simulator User Manual.pdf

Embed Size (px)

DESCRIPTION

Master / visa simulator

Citation preview

  • Information about this Replacement

    Replacement The January 2008 MasterCard Authorization Simulator replaces your existing manual.

    What is in the new version?

    This new version reflects changes effective with Banknet Release 08.1.

    Please refer to:

    Summary of Changes for a comprehensive list of changes reflected in this update.

    Using this Manual for a complete list of the contents of this manual.

    Questions? If you have questions about this manual, please contact the Customer Operations Services team or your regional help desk. Please refer to Using this Manual for more contact information.

    MasterCard is Listening

    Please take a moment to provide us with your feedback about the material and usefulness of the MasterCard Authorization Simulator using the following e-mail address:

    [email protected]

    We continually strive to improve our publications. Your input will help us accomplish our goal of providing you with the information you need.

  • 1 of 1

    Summary of Changes MasterCard Authorization Simulator, January 2008

    The changes listed below are associated with the January 2008 version of this document. To locate these changes onlinesearch on the date next to the revision bar. On the Adobe Reader toolbar, click Search. In the Search pane, type Jan 2008, and then click Search.

    Description of Change Where to Look

    Updated screen images to reflect current version of the simulator where applicable.

    Entire document

    Removed Windows 2000 as an operating system option. Chapter 1

    Chapter 2

    Updated Test Preparation and Test Monitor toolbar options. Chapter 1

    Updated simulator version information to v.08.1. Chapter 2

    Updated Table 3.1Network Options, Table 4.2Network Options and Table 5.2Network Options to include the new Message Encoding Format option.

    Chapter 3

    Chapter 4

    Chapter 5

    Updated the Account Category options in the CVC Options section. Chapter 3

    Added a new Data Element and Subelement Validators section. Appendix A

  • MasterCard Authorization Simulator

    January 2008

  • 2008 MasterCard MasterCard Authorization Simulator January 2008 Publication Code: CS

    Proprietary Rights

    The information contained in this document is proprietary and confidential to MasterCard International Incorporated, one or more of its affiliated entities (collectively MasterCard), or both.

    This material may not be duplicated, published, or disclosed, in whole or in part, without the prior written permission of MasterCard.

    Trademarks

    Trademark notices and symbols used in this manual reflect the registration status of MasterCard trademarks in the United States. Please consult with the Customer Operations Services team or the MasterCard Law Department for the registration status of particular product, program, or service names outside the United States.

    All third-party product and service names are trademarks or registered trademarks of their respective owners.

    Media

    This document is available on MasterCard OnLine.

    MasterCard Worldwide 2200 MasterCard Boulevard OFallon MO 63368-7263 USA

    1-636-722-6100

    www.mastercard.com

  • Table of Contents

    2008 MasterCard MasterCard Authorization Simulator January 2008 i

    Using this Manual

    Purpose...................................................................................................................1

    Audience.................................................................................................................1

    Times Expressed.....................................................................................................1

    Excerpted Text .......................................................................................................2

    Language Use .........................................................................................................2

    Revisions.................................................................................................................2

    Organization ...........................................................................................................3

    Related Information................................................................................................3

    Contact Us ..............................................................................................................4 Contact Customer Operations Services ...........................................................4 Contact Your U.S. Member Relations Representative.....................................5 Contact Your Regional Representative............................................................5 Simulator Support ............................................................................................5

    Chapter 1 Simulator Overview

    Introduction .........................................................................................................1-1 Starting the MasterCard Authorization Simulator.........................................1-2

    Simulator Modules...............................................................................................1-7 Navigator .......................................................................................................1-7 Test Preparation ............................................................................................1-9 Test Monitor ................................................................................................1-19 Test Results..................................................................................................1-21

    Chapter 2 Installation Instructions

    Requirements.......................................................................................................2-1 Configuration Requirements .........................................................................2-1

    Simulator Software Distribution..........................................................................2-4 Distribution for New Users ...........................................................................2-4 CD-ROM Distribution....................................................................................2-6 Distribution for Upgrade Versions ...............................................................2-7

  • Table of Contents

    2008 MasterCard ii January 2008 MasterCard Authorization Simulator

    First Time Installation..........................................................................................2-8 Software Installation......................................................................................2-8 Hardware Installation..................................................................................2-12

    Simulator Installation Support...........................................................................2-13

    Simulator Upgrade Installation .........................................................................2-14 MasterCard Authorization Simulator Upgrade Installation ........................2-14

    Chapter 3 Simulator Configuration

    Configuration Options.........................................................................................3-1 Accessing Configuration Options .................................................................3-1

    Chapter 4 Issuer Testing

    Standard Issuer Testing .......................................................................................4-1 Setting the IPS Host Test Mode ....................................................................4-1 Configuring the Simulator.............................................................................4-2 Managing the History Log.............................................................................4-7 Starting an Issuer Test Session....................................................................4-10 Stopping a Test Session ..............................................................................4-11 Viewing the Test Session ............................................................................4-12 Viewing Test Results ...................................................................................4-12 Refining the Test Results View ...................................................................4-17

    Advanced Options and Specialized Testing.....................................................4-21 Setting Network Options ............................................................................4-21 PIN Key Sets................................................................................................4-24 MChip Key Sets ...........................................................................................4-27 User Category Card Profiles........................................................................4-32 User Category Merchant Profiles ................................................................4-39 Creating a Transaction File .........................................................................4-42 Modifying a Transaction .............................................................................4-43 Adding Control Instructions........................................................................4-52 Network Response Profiles.........................................................................4-55

  • Table of Contents

    2008 MasterCard MasterCard Authorization Simulator January 2008 iii

    Chapter 5 Acquirer Testing

    Standard Acquirer Testing...................................................................................5-1 Setting the APS Host Testing Mode..............................................................5-1 Adding an Instruction to Set a Future Settlement Date in the Simulator....5-2 Adding Acquirer IDs .....................................................................................5-3 Issuer Response Profiles ...............................................................................5-4 Starting an Acquirer Test Session .................................................................5-6 Viewing Test Results .....................................................................................5-8 Refining the Test Results View ...................................................................5-13 Managing the History Log...........................................................................5-16

    Advanced Options and Specialized Testing.....................................................5-19 Setting Network Options ............................................................................5-19 PIN Key Sets................................................................................................5-23 Issuer Response Profiles .............................................................................5-27

    Appendix A Professional Version

    Simulator Professional Features......................................................................... A-1 Navigator Options ........................................................................................ A-1 Test Preparation Module.............................................................................. A-7 Data Element and Subelement Validators................................................. A-23 Test Results Module ................................................................................... A-26 View Archived Logs ................................................................................... A-34

  • 2008 MasterCard MasterCard Authorization Simulator January 2008 i

    Using this Manual This chapter contains information that helps you understand and use this document.

    Purpose...................................................................................................................1

    Audience.................................................................................................................1

    Times Expressed.....................................................................................................1

    Excerpted Text .......................................................................................................2

    Language Use .........................................................................................................2

    Revisions.................................................................................................................2

    Organization ...........................................................................................................3

    Related Information................................................................................................3

    Contact Us ..............................................................................................................4 Contact Customer Operations Services ...........................................................4 Contact Your U.S. Member Relations Representative.....................................5 Contact Your Regional Representative............................................................5 Simulator Support ............................................................................................5

  • Using this ManualPurpose

    2008 MasterCard MasterCard Authorization Simulator January 2008 1

    Purpose The MasterCard Authorization Simulator documents how to use the MasterCard Authorization Simulator to conduct detailed offline testing of the member host. Members test their host to ensure correct message formats and compliance with processing requirements defined in the Customer Interface Specification manual and the Authorization System Manual.

    Audience MasterCard provides this document for members and their authorized agents. Specifically, the following personnel should find this document useful:

    Technical support staff Communications personnel Development personnel

    Times Expressed MasterCard is a global company with locations in many time zones. The MasterCard operations and business centers are in the United States. The operations center is in St. Louis, Missouri, and the business center is in Purchase, New York.

    For operational purposes, MasterCard refers to time frames in this manual as either St. Louis time or New York time. Coordinated Universal Time (UTC) is the basis for measuring time throughout the world. You can use the following table to convert any time used in this document into the correct time in another zone.

    St. Louis, Missouri USA

    Central Time

    Purchase, New York USA

    Eastern Time

    UTC

    Standard time

    (first Sunday in November to second Sunday in March a)

    09:00 10:00 15:00

    Daylight saving time

    (second Sunday in March to first Sunday in November b)

    09:00 10:00 14:00

    a For Central European Time, last Sunday in October to last Sunday in March.

    b For Central European Time, last Sunday in March to last Sunday in October.

  • Using this Manual Excerpted Text

    2008 MasterCard 2 January 2008 MasterCard Authorization Simulator

    Excerpted Text At times, this document may include text excerpted from another document. A note before the repeated text always identifies the source document. In such cases, we included the repeated text solely for the readers convenience. The original text in the source document always takes legal precedence.

    Language Use The spelling of English words in this manual follows the convention used for U.S. English as defined in Merriam-Websters Collegiate Dictionary. MasterCard is incorporated in the United States and publishes in the United States. Therefore, this publication uses U.S. English spelling and grammar rules.

    An exception to the above spelling rule concerns the spelling of proper nouns. In this case, we use the local English spelling.

    Revisions MasterCard periodically may issue revisions to this document to accommodate enhancements and changes, or as corrections are required.

    With each revision, a Summary of Changes describes how the text changed. Revision markers (vertical lines in the right margin) indicate where the text changed. The date of the revision appears at the right of each revision marker.

    MasterCard may publish revisions to this document in a MasterCard bulletin, another MasterCard publication, or on MasterCard OnLine. A subsequent revision is effective as of the date indicated in that publication or on MasterCard OnLine and has precedence over any previous edition. In the event of a conflict between this document and a subsequently published edition, the subsequently published edition shall have precedence.

  • Using this ManualOrganization

    2008 MasterCard MasterCard Authorization Simulator January 2008 3

    Organization The following table provides an overview of this document.

    Part Description

    Table of Contents A list of the manuals chapters and subsections. Each entry references a chapter and page number.

    Using this Manual A description of the manuals purpose and its contents.

    1 Overview An explanation of what you need to know about the MasterCard Authorization Simulator before you start testing.

    2 Installation Instructions

    A description of the steps necessary for setup and installation of the MasterCard Authorization Simulator.

    3 Simulator Configuration

    An explanation of how to configure the MasterCard Authorization Simulator.

    4 Issuer Testing An explanation of how to perform Issuer Testing using the MasterCard Authorization Simulator.

    5 Acquirer Testing An explanation of how to perform Acquirer Testing using the MasterCard Authorization Simulator.

    A Appendix A A description of the features available with the Professional version of the MasterCard Authorization Simulator.

    Related Information The following documents and resources provide information related to the subjects discussed in this document.

    Authorization System Manual Customer Interface Specification Data Communications Manual Descriptions of these documents are available in the List of Manuals in the Member Publications product on MasterCard OnLine.

    Definitions of key terms used in this document are available in the MasterCard Dictionary.

    To order MasterCard documents, please use the Ordering Publications tool, available in the Quick Links section on the Member Publications home page, or contact the Customer Operations Services team.

  • Using this Manual Contact Us

    2008 MasterCard 4 January 2008 MasterCard Authorization Simulator

    Contact Us Please take a moment to provide MasterCard with your feedback about the MasterCard Authorization Simulator.

    MasterCard continually strives to improve user documents. User feedback helps MasterCard accomplish this goal.

    Please provide feedback about this document to Manuals and Publications at [email protected].

    Contact Customer Operations Services

    Please address your questions about MasterCard programs and services to the Customer Operations Services team as follows.

    Phone: 1-800-999-0363 or 1-636-722-6176

    1-636-722-6292 (Spanish language support)

    Fax: 1-636-722-7192

    Telex: 434800 answerback: 434800 ITAC UI

    Address: MasterCard Worldwide Customer Operations Services 2200 MasterCard Boulevard OFallon MO 63368-7263 USA

    E-mail: Canada, Caribbean, Latin America, South Asia/Middle East/Africa, and United States

    [email protected]

    Asia/Pacific:

    Australia and New Zealand

    [email protected]

    China, Hong Kong, and Taiwan

    [email protected]

    Southeast Asia [email protected]

    Japan/Guam [email protected]

    Korea [email protected]

    Europe [email protected]

  • Using this ManualContact Us

    2008 MasterCard MasterCard Authorization Simulator January 2008 5

    Spanish language support [email protected]

    Vendor Relations, all regions [email protected]

    Contact Your U.S. Member Relations Representative

    Member Relations representatives assist U.S. members with marketing inquiries. They interpret member requests and requirements, analyze them, and if approved, monitor their progress through the various MasterCard departments. This does not cover support for day-to-day operational problems, which the Customer Operations Services team addresses.

    For the name of your U.S. Member Relations representative, contact your local Member Relations office:

    Atlanta 1-678-459-9000 Chicago 1-847-375-4000 Purchase 1-914-249-2000 San Francisco 1-925-866-7700

    Contact Your Regional Representative

    The regional representatives work out of the regional offices. Their role is to serve as intermediaries between the members and other departments in MasterCard. Members can inquire and receive responses in their own languages and during their offices hours of operation.

    For the name of the location of the regional office serving your area, call the Customer Operations Services team.

    Simulator Support

    For MasterCard Authorization Simulator support, contact your Simulator Support Specialist via e-mail:

    E-mail Address: [email protected]

  • 2008 MasterCard MasterCard Authorization Simulator January 2008 1-i

    1 Simulator Overview The MasterCard Authorization Simulator provides members with a powerful and full-featured offline test tool. Members can perform release or internal system testing at their own pace and convenience.

    Introduction .........................................................................................................1-1 Starting the MasterCard Authorization Simulator.........................................1-2

    License Profile Selection.........................................................................1-4 License Profile Dialog Box Options.................................................1-6

    Simulator Modules...............................................................................................1-7 Navigator .......................................................................................................1-7

    Setting the Test Mode .............................................................................1-8 Test Preparation ............................................................................................1-9

    Transaction File Pane (Issuer Testing).................................................1-10 Profiles Pane .........................................................................................1-11

    Transaction Profiles Pane...............................................................1-12 Card Profiles Pane ..........................................................................1-13 Merchant Profiles Pane...................................................................1-14

    Data Elements Pane..............................................................................1-14 Subelements Pane.................................................................................1-15 Test Preparation Toolbar ......................................................................1-16 Network Response Profile Pane...........................................................1-17 Issuer Response Profile Pane (Acquirer Testing) ................................1-18

    Test Monitor ................................................................................................1-19 Transaction Navigation .........................................................................1-20 Test Monitor Toolbar ............................................................................1-21

    Test Results..................................................................................................1-21 Table View ............................................................................................1-22 Log with Parsed Message Detail...........................................................1-23 Log with the Key Data..........................................................................1-24 Test Results Toolbar .............................................................................1-24

  • Simulator OverviewIntroduction

    2008 MasterCard MasterCard Authorization Simulator January 2008 1-1

    Introduction The MasterCard Authorization Simulator provides members the ability to conduct detailed offline testing. The simulator software is a 32-bit, Microsoft Windows application that runs on a PC with Microsoft Windows XP Professional with Service Pack 1 or higher. Members must install the simulator application software on a Pentium III 1GHz or compatible PC. Members establish the connection between the simulator PC and their host using a member provided network interface card (NIC) for TCP/IP connectivity. The resulting interface simulates the actual interface between the member host and the MasterCard interface processor (MIP).

    The MasterCard Authorization Simulator tests messages using the Customer Interface Specification message format. Refer to the Customer Interface Specification (CIS) manual for additional message format information.

    The simulator provides virtually all the testing capabilities that are available with online testing. With the simulator, members can conduct extensive preparations for online testing in an offline environment. By performing simulator testing, members can replicate the tests and procedures for scheduled online testing. This procedure will minimize the time required to perform online testing.

    MasterCard updates the simulator in accordance with the Banknet release cycle. Typically, the most current version of the simulator will be available three to four weeks before any online member testing facilities become available for the new release. The early availability of the simulator increases the amount of time that members will have to complete release testing. Using the simulator, members also are able to test internally developed systems or vendor-purchased systems. New members can use the simulator to test their systems for compliance with MasterCard processing requirements. The simulator provides an emulation tool for complete end-to-end application testing.

    The MasterCard Authorization Simulator allows members to test their system using one of two testing modes: IPS Host Testing (issuer) or APS Host Testing (acquirer).

    IPS Host Testing: The member host is the issuer. The simulator generates Authorization Request/0100 messages and sends them to the member host. The simulator will validate the Authorization Request Response/0110 messages returned by the member host (Figure 1.1).

    Jan 2008

  • Simulator Overview Introduction

    2008 MasterCard 1-2 January 2008 MasterCard Authorization Simulator

    Figure 1.1IPS Host Testing

    SimulatorAuthorization Request Response/0110

    Authorization Request/0100

    as IssuerHost

    APS Host Testing: The simulator responds to the Authorization Request/0100 messages sent by the member host. The simulator validates the received messages and then creates and returns to the member host, the appropriate Authorization Request Response/0110 messages (Figure 1.2).

    Figure 1.2APS Host Testing

    Authorization Request Response/0110

    Authorization Request/0100

    as AcquirerSimulatorHost

    Note Members cannot conduct IPS Host Testing and APS Host Testing simultaneously.

    Starting the MasterCard Authorization Simulator

    Use the following steps to start the simulator application:

    Step Action

    1. On the PC desktop, double-click the MasterCard Simulators folder icon to open the folder. You can also use the Start button to access the simulator.

  • Simulator OverviewIntroduction

    2008 MasterCard MasterCard Authorization Simulator January 2008 1-3

    Step Action

    2. Double-click the MasterCard Authorization Simulator icon to launch the application.

    3. If applicable, click the appropriate License Profile Name and then click Select.

    This dialog box displays only if more than one hardware token or simulator license file is detected on the simulator PC. The appropriate license file must be selected to continue the launching of the simulator application. See License Profile Selection for details concerning the License Profile dialog box.

    Jan 2008

  • Simulator Overview Introduction

    2008 MasterCard 1-4 January 2008 MasterCard Authorization Simulator

    Step Action

    4. Click OK to close the Simulator Bulletin window and continue opening the simulator.

    The Simulator Bulletin window is also available under the News tab in the Navigator window.

    Note The appearance of the desktop folder is dependent on the selected Windows display properties.

    License Profile Selection

    Some members may have both the MasterCard Debit Financial Simulator and the MasterCard Authorization Simulator installed on the same PC. Each simulator type requires an individual hardware token and license file for the operation of the corresponding simulator. Refer to Hardware Token Installation in Chapter 2 of this manual for more information concerning simulator hardware tokens and license files.

    Jan 2008

  • Simulator OverviewIntroduction

    2008 MasterCard MasterCard Authorization Simulator January 2008 1-5

    To manage the different license profiles and hardware tokens, the License Profile dialog allows user selection of the appropriate license file and hardware token for the corresponding simulator. Once you have initiated the launch of the MasterCard Authorization Simulator (by double-clicking the simulator icon), the system quickly scans the PC for hardware tokens and simulator license files. The License Profiles dialog box (Figure 1.3) lists all simulator license files and hardware tokens detected on the simulator PC. A detected license file and the corresponding hardware token will have a status indicator of available. Any license file detected on the simulator PC that does not have a corresponding hardware token detected will have a status indicator of Token not found.

    Members may select from only those license profiles that have a status of available in order start the simulator application.

    If multiple hardware tokens or license files are detected, you must select the appropriate and available license file name in the License Profile dialog box before the system will continue to open the simulator application.

    Note If only a single hardware token and license file are detected during the launch of the simulator application, the License Profiles dialog box does not display and the simulator application starts uninterrupted.

    Figure 1.3License Profiles

  • Simulator Overview Introduction

    2008 MasterCard 1-6 January 2008 MasterCard Authorization Simulator

    License Profile Dialog Box Options

    Members may customize the display of the License Profile dialog box by selecting from the following options:

    AutoselectThis option is set by default. If only one license file and the corresponding hardware token are installed on the simulator PC, the selection in the License Profile dialog box is automatic.

    Show DetailsThis option provides the license file detail in a dropdown pane (Figure 1.4).

    Show DemosThis option displays any demo license files detected on the simulator PC.

    Show unavailableThis option toggles on and off the display of all license files that are detected and unavailable.

    Figure 1.4License Profile Details

  • Simulator OverviewSimulator Modules

    2008 MasterCard MasterCard Authorization Simulator January 2008 1-7

    Simulator Modules The MasterCard Authorization Simulator consists of the following modules:

    Navigator A navigational pane that allows access of all the simulator modules from one central location. From here members: Set the testing mode Access configuration parameters Access main simulator modules Access documentation View the Simulator Bulletin Access System Administration View archived test logs

    Test Preparation From here, members may create and/or modify user profiles, user response profiles, and transaction files.

    Test Monitor Members run simulator testing of transaction files within this module.

    Test Results This module allows members to view and analyze test results and manage the test log.

    Navigator

    The simulators main window displays the Navigator pane. From here members may navigate to all the main modules of the simulator.

    The Navigator pane is organized using tabs and corresponding icons allowing members to navigate quickly and easily to the following:

    Simulator modules System administration Simulator Add-Ins Simulator News

    Jan 2008

  • Simulator Overview Simulator Modules

    2008 MasterCard 1-8 January 2008 MasterCard Authorization Simulator

    Figure 1.5Simulator Main Window

    Setting the Test Mode

    From the Navigator pane, members set the testing mode before beginning to test with the simulator. Use the following procedure to set the test mode:

    Step Action

    1. Double-click the MasterCard Authorization Simulator icon to launch the simulator application.

    2. Click the appropriate License Profile Name and then click Select.

    3. Click OK to close the Simulator Bulletin window and continue opening the simulator.

    Jan 2008

  • Simulator OverviewSimulator Modules

    2008 MasterCard MasterCard Authorization Simulator January 2008 1-9

    Step Action

    4. From the Navigator pane, select the Testing tab.

    5. Select a Test Mode from the drop-down list.

    Test Preparation

    The Test Preparation window is comprised of two individual panes; the Transaction File pane and the Profile pane (Figure 1.6). From the Test Preparation window members may:

    Create and modify test transaction files Create and modify individual test messages Create and modify User Card and Merchant Profiles Create and modify User Network Response Profiles

  • Simulator Overview Simulator Modules

    2008 MasterCard 1-10 January 2008 MasterCard Authorization Simulator

    Figure 1.6Test Preparation Window (Issuer Testing)

    Transaction File Pane (Issuer Testing)

    The Transaction File pane (Figure 1.7), of the Test Preparation module, provides a work area for creating or modifying transaction files. When creating a new transaction, members may use the standard Microsoft function of click and drag to move the Transaction Profiles from the Transaction Profile pane into the Transaction File pane.

    Figure 1.7Transaction File Pane - Issuer Testing

    Jan 2008

    Jan 2008

  • Simulator OverviewSimulator Modules

    2008 MasterCard MasterCard Authorization Simulator January 2008 1-11

    Profiles Pane

    Profiles are building blocks used by the simulator to create transaction messages. A transaction message is composed of different fields and tags which can be specified within a profile type. The Test Preparation module uses the profiles as a reference base when creating a transaction message.

    The profile categories are as follows:

    Transaction Profilethe member can select one of these pre-defined profiles as a basis for the composition of a message. These profiles may not be modified by the member.

    Card Profilethese profiles contain member specific card information which the Transaction Profile references to create a message. The Card Profiles are divided into Reference and User categories. The member may modify the data elements in both profile categories but may not modify the Profile Name or description in the Reference category. A Reference category profile may be copied and pasted into the User category to be used as a template.

    Merchant Profilethese profiles contain merchant information which the Transaction Profile references to create a message. The Merchant Profiles are divided into Reference and User categories. The member may modify only the User category in these profiles. A Reference category profile may be copied and pasted into the User category to be used as a template.

    The Profiles pane, located in the lower half of the Test Preparation window provides a work area for displaying and working with the Transaction, Card, and Merchant Profiles.

  • Simulator Overview Simulator Modules

    2008 MasterCard 1-12 January 2008 MasterCard Authorization Simulator

    Transaction Profiles Pane

    MasterCard provides pre-defined Transaction Profiles that are organized within the Transaction Profile pane by message type, card entry method, and services (Figure 1.8).

    Members may use the standard Microsoft function of click and drag or double-click a profile to move the Transaction Profiles into the Transaction File Pane to quickly create a transaction file.

    Figure 1.8Transaction Profiles Pane

    Jan 2008

  • Simulator OverviewSimulator Modules

    2008 MasterCard MasterCard Authorization Simulator January 2008 1-13

    Card Profiles Pane

    The Card Profiles pane contains a pre-defined Reference Card Profile category that is organized by Standard or Chip cards, product type, and U.S. or Non-U.S. region (Figure 1.9).

    MasterCard provides pre-defined Reference Card Profiles that members modify with their specific card information. However, the Reference Card Profiles may not be deleted or renamed.

    Members may create and modify Card Profiles in the User Card Profile category. The Transaction Profiles reference the Card Profiles to create transaction messages.

    Figure 1.9Card Profiles Pane

    Jan 2008

  • Simulator Overview Simulator Modules

    2008 MasterCard 1-14 January 2008 MasterCard Authorization Simulator

    Merchant Profiles Pane

    The Merchant Profiles pane contains a pre-defined Reference Merchant Profile category that is organized by transaction category code (TCC) and alphabetical order (Figure 1.10).

    MasterCard provides pre-defined Reference Merchant Profiles which may not be modified. However, members may create and modify Merchant Profiles in the User Merchant Profile category. The Transaction Profiles reference the Merchant Profiles to create transaction messages.

    Figure 1.10Merchant Profiles Pane

    Data Elements Pane

    The Data Elements pane lists and displays all ISO-specified data elements used in the MasterCard implementation of the ISO 8583-1987 message standard (Figure 1.11). Members may use the standard Microsoft function of click and drag to move data elements from this pane onto a transaction in the Transaction File pane thereby adding or overwriting existing data elements with a specified value.

    Jan 2008

  • Simulator OverviewSimulator Modules

    2008 MasterCard MasterCard Authorization Simulator January 2008 1-15

    Figure 1.11Data Elements Pane

    Subelements Pane

    The Subelements pane lists and displays all ISO-specified subelements for data elements 35, 43, 45, 48, 55, 112, 120 and 124 (Figure 1.12). Members may use the standard Microsoft function of click and drag to move subelements from this pane onto a transaction in the Transaction File pane thereby adding or overwriting existing subelements for the corresponding data elements with a specified value.

    Figure 1.12Subelements Pane

  • Simulator Overview Simulator Modules

    2008 MasterCard 1-16 January 2008 MasterCard Authorization Simulator

    Test Preparation Toolbar

    Within the Test Preparation window, members perform most functions through the use of the Test Preparation toolbar. Each toolbar button displays an accompanying tool tip, which describes the buttons function.

    Table 1.1 describes the Test Preparation Toolbar buttons and their function.

    Table 1.1Test Preparation Toolbar

    Button Description

    New transaction file.

    Opens an existing transaction file.

    Opens a reference transaction file.

    Appends an existing .trx file to a current one.

    Saves the transaction file.

    Saves the transaction file under a different name.

    Creates a new group.

    Adds an instruction.

    Edits the selected object.

    Outline view hides card and merchant profile information in the transaction file.

    Collapses all request messages in the transaction

    Expands all underlying objects.

    Moves object to the left.

    Moves object to the right.

    Moves object up.

    Moves object down.

    Views the composed message.

    Jan 2008

  • Simulator OverviewSimulator Modules

    2008 MasterCard MasterCard Authorization Simulator January 2008 1-17

    Button Description

    Selects some of the transactions.

    Launches the Search and Replace dialog box.

    Moves to the first selected transaction.

    Moves to the previous selected transaction.

    Moves to the next selected transaction.

    Moves to the last selected transaction.

    Network Response Profile Pane

    The Test Preparation window also contains a Network Response Profile pane (Figure 1.13), which may be accessed through a corresponding tab.

    MasterCard provides pre-defined Reference Network Response Profiles that contain the default response values for standard MasterCard testing. The Reference Network Response profiles may not be modified. However, members may create and modify User Network Response Profiles to meet their specific testing needs.

  • Simulator Overview Simulator Modules

    2008 MasterCard 1-18 January 2008 MasterCard Authorization Simulator

    Figure 1.13Network Response Profile Pane

    Issuer Response Profile Pane (Acquirer Testing)

    The Test Preparation window also contains an Issuer Response Profile pane (Figure 1.14), which may be accessed through a corresponding tab.

    For acquirer testing, MasterCard provides pre-defined Reference Issuer Response Profiles that contain default response values for standard MasterCard testing. The Reference Issuer Response Profiles may not be modified. However, acquirers may create and modify User Issuer Reference Profiles to meet their specific testing needs.

    Jan 2008

  • Simulator OverviewSimulator Modules

    2008 MasterCard MasterCard Authorization Simulator January 2008 1-19

    Figure 1.14Issuer Response Profile Pane (Acquirer Testing)

    Test Monitor

    The Test Monitor window is comprised of two individual panes, the Transaction File pane, and the Test Activity Log pane (Figure 1.15).

    These panes provide a workspace to execute test sessions and monitor the testing activity. The Transaction File pane displays the active transaction file, while the lower pane (Test Activity Log pane) displays the test session activity.

    Profile tabs allow members to access the different profile hits information.

    Jan 2008

  • Simulator Overview Simulator Modules

    2008 MasterCard 1-20 January 2008 MasterCard Authorization Simulator

    Transaction Navigation

    Members have the ability to navigate from a transaction within the two panes of the Test Monitor to the exact transaction in either the Test Preparation or Test Results module. This navigation ability is only allowed from the Test Monitor module outward to the Test Preparation or Test Results module. Members may not use the double-clicking transaction navigation to return to the Test Monitor from the other modules.

    By double-clicking a transaction in the Transaction File pane, members quickly navigate to the exact transaction in the Test Preparation module. The navigation to the specific transaction within the Test Preparation module provides the member the ability to quickly modify a specific transaction record during a test session.

    By double-clicking a transaction in the Test Activity Log pane, members quickly navigate to the exact transaction within the Test Results module. The navigation to the specific transaction within the Test Results module provides the member the ability to quickly analyze a specific transaction record during a test session.

    Figure 1.15Test Monitor Window

    Jan 2008

  • Simulator OverviewSimulator Modules

    2008 MasterCard MasterCard Authorization Simulator January 2008 1-21

    Test Monitor Toolbar

    Within the Test Monitor window, members perform most functions through the use of the Test Monitor toolbar. Each toolbar button displays an accompanying tool tip, which describes the buttons function.

    Table 1.2 describes the Test Monitor Toolbar buttons and their function.

    Table 1.2Test Monitor Toolbar (Issuer Testing)

    Button Description

    Opens an existing transaction file.

    Opens a reference transaction file.

    Reset the hits.

    Views the composed message.

    Starts the execution of the selected object(s).

    Stops the execution.

    Selects transactions in the transaction file base.

    Jumps to the first selected transaction.

    Jumps to the previous selected transaction.

    Jumps to the next selected transaction.

    Jumps to the last selected transaction.

    Clears the full transaction history log.

    (Professional version only) Halts a transaction mid script to allow the user to add or modify data elements, modify values, or to cancel a response.

    Test Results

    The Test Results window displays the Sequential and Historical logs for the simulator testing sessions. From here members may view the simulator log for test result analysis. Members also manage the simulator log from this window controlling the log data base organization.

    Jan 2008

  • Simulator Overview Simulator Modules

    2008 MasterCard 1-22 January 2008 MasterCard Authorization Simulator

    The Test Results window provides the following views to facilitate with the test results analysis:

    Table View Log with Parsed Message Detail (default) Log with the Key Data

    Table View

    The Table view (Figure 1.16) displays the test results information in dynamic columns that change with the selection of different records in the log. For example, when an information record is selected, the columns adjust accordingly, displaying the record name, a time stamp, and a description. However, when a message record is selected then the columns change to display the record name, a time stamp, and specific data elements.

    Figure 1.16Test ResultsTable View

    Jan 2008

  • Simulator OverviewSimulator Modules

    2008 MasterCard MasterCard Authorization Simulator January 2008 1-23

    Log with Parsed Message Detail

    The Log with Parsed Message Detail (default) view provides two synchronized panes displaying the log records and the accompanying information or data element detail.

    Figure 1.17Test ResultsLog with Parsed Message Detail

    Jan 2008

  • Simulator Overview Simulator Modules

    2008 MasterCard 1-24 January 2008 MasterCard Authorization Simulator

    Log with the Key Data

    The Log with the Key Data view provides a synchronized tri-pane that displays the log records, specific key data, and data element detail.

    Figure 1.18Test ResultsLog with the Key Data

    Test Results Toolbar

    Within the Test Results window, members perform most functions through the use of the Test Results toolbar. Each toolbar button displays an accompanying tool tip, which describes the buttons function.

    Jan 2008

  • Simulator OverviewSimulator Modules

    2008 MasterCard MasterCard Authorization Simulator January 2008 1-25

    Table 1.3 describes the Test Results Toolbar buttons and their function.

    Table 1.3Test Results Toolbar

    Button Description

    Shows the log in table view.

    Shows the log with parsed message detail.

    Shows the log with the key data.

    Shows the outgoing message profile construction.

    Views the data in its compiled form.

    Refreshes the sequential log.

    Filters some entries from the log.

    Select messages based on given data elements.

    Jumps to the first selected message.

    Jumps to the previous selected message.

    Jumps to the next selected message.

    Jumps to the last selected message.

    Clears the full transaction history log.

    Generates an ATH (text) file of the log detail.

    Exports log file to an HTML file.

    (Professional version only) Generates a .tre export directly from the current log. This file can be saved for reference and reloaded into the simulator.

  • 2008 MasterCard MasterCard Authorization Simulator January 2008 2-i

    2 Installation Instructions This chapter describes the steps necessary for installation and setup of the MasterCard Authorization Simulator.

    Requirements.......................................................................................................2-1 Configuration Requirements .........................................................................2-1

    Simulator Software Distribution..........................................................................2-4 Distribution for New Users ...........................................................................2-4

    Download MasterINQ Base Platform from MasterCard OnLine ...........2-4 Download the MasterCard Authorization Simulator from MasterCard OnLine .................................................................................2-5

    CD-ROM Distribution....................................................................................2-6 Distribution for Upgrade Versions ...............................................................2-7

    Download Upgrade from MasterCard OnLine.......................................2-7 CD-ROM Distribution..............................................................................2-7

    First Time Installation..........................................................................................2-8 Software Installation......................................................................................2-8

    Adobe Acrobat Reader Installation ........................................................2-8 MasterCard Authorization Simulator Installation ...................................2-8

    Installing the MasterCard Authorization Simulator..........................2-9 Hardware Installation..................................................................................2-12

    Hardware Token Installation................................................................2-12

    Simulator Installation Support...........................................................................2-13

    Simulator Upgrade Installation .........................................................................2-14 MasterCard Authorization Simulator Upgrade Installation ........................2-14

    Installing the MasterCard Authorization Simulator Upgrade...............2-15

  • Installation InstructionsRequirements

    2008 MasterCard MasterCard Authorization Simulator January 2008 2-1

    Requirements The MasterCard Authorization Simulator is an integral part of the MasterCard Test Program. The MasterCard Authorization Simulator is mandatory for all members and processors that connect directly to the Banknet telecommunications network.

    Configuration Requirements

    To install the MasterCard Authorization Simulator, the member or processor must provide the hardware and software identified in Table 2.1

    Table 2.1Hardware and Software Requirements

    Item Description

    Computer/Processor Pentium III 1 GHz CPU or compatible system minimum

    Pentium 4 2.0 GHz recommended Operating System Windows XP Professional with service pack 1 or higher

    Memory 256 MB minimum 512 MB recommended

    Hard Disk Available hard disk space:

    500 MB minimum 1.0 GB recommended

    Display Super VGA (1024 X 768) with 65,536 colors or higher-resolution display adapter

    Monitor 17 inch or larger color display

    Drive CD-ROM drive or access to CD-ROM over a computer network

    USB Port Active Universal Series Bus (USB) port or a USB hub

    Peripheral/Miscellaneous Microsoft mouse or compatible pointing device

    Jan 2008

  • Installation Instructions Requirements

    2008 MasterCard 2-2 January 2008 MasterCard Authorization Simulator

    Table 2.2 defines the MasterCard supplied hardware and software. Table 2.3 lists the software and documentation distributed via MasterCard OnLine.

    Table 2.2Installation Kit Hardware and Software Components

    Item Description Note

    Hardware token (Figure 2.1)

    Software licensing hardware token that attaches to the PCs USB port and provides the license protection for the MasterCard Authorization Simulator.

    The MasterCard Authorization Simulator will not operate without the hardware token. See Hardware Token Installation concerning an important warning about the hardware token access date.

    SecurID device

    (Figure 2.2)

    Physical device that provides a dynamic access code synchronized with the MasterCard OnLine server.

    You must use your PIN and the passcode from the SecurID device to access the MasterCard OnLine server.

    Adobe Acrobat Reader A document viewing application that supports a common documentation format.

    Available for download from http://www.adobe.com/.

    Figure 2.1Hardware Token

  • Installation InstructionsRequirements

    2008 MasterCard MasterCard Authorization Simulator January 2008 2-3

    Figure 2.2SecurID Device

    Table 2.3MasterCard OnLine Supplied Components

    Item Description

    MasterINQ software A baseline ISO 8583 message generation engine on which the MasterCard Authorization Simulator is installed as an add-on to the baseline platform.

    MasterCard Authorization Simulator software

    Windows XP Professional compatible 32bit applications

    MasterCard Authorization Simulator manuala

    Documentation provided in PDF format.

    a MasterCard OnLine is the distribution method for all updates and revisions.

  • Installation Instructions Simulator Software Distribution

    2008 MasterCard 2-4 January 2008 MasterCard Authorization Simulator

    Simulator Software Distribution Members can obtain the MasterINQ Base Platform and the MasterCard Authorization Simulator application software using either of the following methods:

    Download the application using MasterCard OnLine Request that MasterCard distribute the simulator application on CD-ROM

    Distribution for New Users

    Refer to the First Time Installation subsection for MasterCard Authorization Simulator software installation instructions.

    Download MasterINQ Base Platform from MasterCard OnLine

    The MasterINQ platform is a baseline ISO 8583 message generation engine. This baseline engine is common between the MasterCard Debit Financial and Authorization Simulators. Once the MasterINQ platform is installed, the MasterCard Authorization Simulator is customized and installed as an add-on to the baseline platform.

    Follow these steps to download the MasterINQ Base Platform application file from MasterCard OnLine:

    Step Action

    1. Start a MasterCard OnLine session.

    2. From the Featured Products & Services pane, select MasterCard Simulator Suite.

    3. For the MasterCard Authorization Simulator, click the corresponding Documentation link.

    4. Locate and click the MasterINQ Base Platform Install File link.

  • Installation InstructionsSimulator Software Distribution

    2008 MasterCard MasterCard Authorization Simulator January 2008 2-5

    Step Action

    5. Click Save in the File Download dialog box.

    6. Select a directory and click Save.

    Download the MasterCard Authorization Simulator from MasterCard OnLine

    Follow these steps to download the MasterCard Authorization Simulator application files from MasterCard OnLine:

    Step Action

    1. Start a MasterCard OnLine session.

    2. From the Featured Products & Services pane, select MasterCard Simulator Suite.

    3. For the MasterCard Authorization Simulator, click the corresponding Download link.

    4. Click Save in the download dialog box.

    5. Select a directory and click Save.

    6. Close your MasterCard OnLine browser session after completing the download.

  • Installation Instructions Simulator Software Distribution

    2008 MasterCard 2-6 January 2008 MasterCard Authorization Simulator

    For additional assistance with MasterCard OnLine installation or MasterCard Authorization Simulator application downloads, please contact the Online Solutions and Services Help Desk:

    Phone: 1-800-288-3381 or 1-636-722-6636 (option 3)

    Fax: 1-636-722-7994

    E-mail: [email protected]

    The Online Solutions and Services Help Desk is available 24 hours a day, seven days a week.

    CD-ROM Distribution

    As an alternate method for obtaining the MasterCard Authorization Simulator, members can request distribution of the application on a CD-ROM. However, members located outside the U.S. region can incur greater import or customs duties. When the MasterCard Authorization Simulator application software is included on the distribution CD-ROM, the declared value of the shipment will be USD 9,500.00. If the MasterCard Authorization Simulator application software is not provided on the CD-ROM, the declared value of the shipment is less than USD 600.00.

    To receive the MasterCard Authorization Simulator application software on the distribution CD-ROM, use the following procedures:

    Step Action

    1. If necessary, contact your MasterCard Regional Office Representative for MasterCard OnLine access.

    2. Initiate the dial or proxy process following the browser software manufacturers instructions.

    3. Start the selected browser and go to the MasterCard OnLine homepage (http://www.mastercardonline.com).

    4. From Featured Products & Services, select the MasterCard Simulator Suite link.

    5. From MasterCard Authorization Simulator, select Order/Upgrade.

    6. Complete the required information and submit the request.

  • Installation InstructionsSimulator Software Distribution

    2008 MasterCard MasterCard Authorization Simulator January 2008 2-7

    Distribution for Upgrade Versions

    Refer to Download the MasterCard Authorization Simulator from MasterCard OnLine section for upgrade version downloading instructions.

    Download Upgrade from MasterCard OnLine

    Members that have licensed a previous version of the MasterCard Authorization Simulator can download the current upgrade version from MasterCard OnLine at no additional charge.

    CD-ROM Distribution

    As an alternate method for obtaining the current MasterCard Authorization Simulator upgrade version, members can request distribution of the application on a CD-ROM using the following procedures:

    Step Action

    1. If necessary, contact your MasterCard Regional Office Representative for MasterCard OnLine access.

    2. Initiate the dial or proxy process following the browser software manufacturers instructions.

    3. Start the selected browser and go to the MasterCard OnLine homepage (http://www.mastercardonline.com).

    4. From Featured Products & Services, select the MasterCard Simulator Suite link.

    5. From MasterCard Authorization Simulator, select Order/Upgrade.

    6. Complete the required information and submit the request.

    MasterCard will bill members USD 395.00 plus shipping and handling, for the current MasterCard Authorization Simulator version application on CD-ROM. For members located outside the U.S. region, the declared value of the upgrade CD-ROM shipment will be USD 395.00.

  • Installation Instructions First Time Installation

    2008 MasterCard 2-8 January 2008 MasterCard Authorization Simulator

    First Time Installation New members or members that install the MasterCard Authorization Simulator on a new PC should follow the first time installation procedures.

    Software Installation

    You must have administrative privileges to install the MasterCard Authorization Simulator and associated software. The members Information Services/Information Technology (IS/IT) department or representative should review all procedures before installing the required MasterCard Authorization Simulator hardware and software.

    Adobe Acrobat Reader Installation

    The Adobe Acrobat Reader is provided to ensure that members will be able to view and use the support documentation included with the MasterCard Authorization Simulator. Use the following procedure to install Adobe Acrobat Reader software:

    Step Action

    1. Place the MasterCard Authorization Simulator CD in the CD-ROM drive.

    2. Click the Start button, and select Run.

    3. In the Open box, type C:\*\Acrobat\Setup.exe. (* equals the directory path the member selected when downloading the file from MasterCard Online.) (If necessary, modify the path)

    4. Click OK. Allow the Install Wizard to guide you through the installation process.

    Note If you did not receive a MasterCard Authorization Simulator CD, you may download the Adobe Acrobat Reader software from http://www.adobe.com/.

    MasterCard Authorization Simulator Installation

    This section describes the installation steps for the current version of the MasterCard Authorization Simulator for first time installation. The initial installation process performs the following actions:

    Installs the MasterINQ base platform Installs the Rainbow Sentinel Driver

  • Installation InstructionsFirst Time Installation

    2008 MasterCard MasterCard Authorization Simulator January 2008 2-9

    Creates a new folder: C:\Program Files\MasterCard\MasterINQ63\Data_Credit_xx_x (where xx_x equals the current version of the simulator)

    Creates a MasterCard Simulators folder icon on the PC desktop Adds application icons to the Start menu Installing the MasterCard Authorization Simulator

    Use the following procedure to launch the installation process:

    Step Action

    1. Click the Windows Desktop Start button, and select Run.

    2. Click Browse to locate the MasterCard Authorization Simulator executable file (crsimxx_x.exe).

    Select C:\*1\crsim_sim\crsimxx_x.exe2 if you downloaded the MasterCard Authorization Simulator applications using MasterCard OnLine. (If necessary, modify the path)

    Select D:\Simulator\crsimxx_x.exe if you received the MasterCard Authorization Simulator applications on CD-ROM. (If necessary, modify the path)

    3. Select crsimxx_x.exe and click OK to begin the MasterCard Authorization Simulator installation program. The system briefly displays the progress indicator.

    4. Click Next to continue.

    5. Read the MasterCard Test Simulator Software License Agreement carefully, and click the I accept the terms of the license agreement radio button to accept the terms of the agreement and click Next.

    1 * equals the directory selected by the member when downloading the file from MasterCard

    Online.

    2 xx_x equals the current version simulator.

  • Installation Instructions First Time Installation

    2008 MasterCard 2-10 January 2008 MasterCard Authorization Simulator

    Step Action

    6. Click the Anyone who uses this computer (all users) radio button and then click Next.

    7. Click Install to start copying the MasterINQ base platform files.

    8. Click OK in the message indicating the installation of the MasterINQ Platform.

    9. Select the folder/directory location where the MasterINQ installation file (MasterINQ63.exe) was downloaded and click OK.

    10. Click Next.

  • Installation InstructionsFirst Time Installation

    2008 MasterCard MasterCard Authorization Simulator January 2008 2-11

    Step Action

    11. Read the MasterINQ Software License Agreement carefully, and click the I accept the terms of the license agreement radio button to accept the terms of the agreement and then click Next.

    12. Click Next.

    13. Click Install to begin the installation of the MasterINQ base platform files.

    14. Click Finish.

    15. Click OK in the message indicating the installation of the USB Hardware Token Device Driver.

    16. Click Next.

    17. Read the Rainbow Sentinel Driver Software License Agreement carefully, and click the I accept the terms of the license agreement radio button and click Next.

    18. Click Next.

    19. Click the Complete radio button and then click Next.

    20. Click Install to begin the installation of the USB Hardware Token Device Driver.

    21. Click Finish.

    22. Click Finish when setup is complete.

    23. Continue with Hardware Installation.

  • Installation Instructions First Time Installation

    2008 MasterCard 2-12 January 2008 MasterCard Authorization Simulator

    Hardware Installation

    The members Information Services/Information Technology (IS/IT) department or representative should review all procedures before installing the required MasterCard Authorization Simulator hardware.

    Hardware Token Installation

    Connect the hardware token to the Universal Serial Bus (USB) port (Figure 2.3). The hardware token must be present to operate the MasterCard Authorization Simulator.

    Figure 2.3Hardware Token Installation

    MasterCard provides a hardware token license file via email to members. Members should detach the license file from their email message to the C:\Program Files\MasterCard\MasterINQ63\Bin directory. The license file must be present in the Bin folder of the MasterInq directory for the simulator to operate. Figure 2.4 is an example of a license file.

  • Installation InstructionsSimulator Installation Support

    2008 MasterCard MasterCard Authorization Simulator January 2008 2-13

    Warning Members should not change the simulators PC date to a future date as this will

    cause the simulators security hardware token license to update the token access date. As a result, when the PC date is reset to the current date the license date becomes expired. An expired license date in the license file causes the security token to deny member access to the simulator.

    In some instances, if the PC date is manually changed to a distant future date, a new hardware token may be required to operate the simulator. A hardware token replacement fee will apply.

    See Chapters 4 and 5 for details about adding an instruction to test with a future settlement date.

    Figure 2.4Hardware token license file example

    Simulator Installation Support MasterCard Authorization Simulator support specialists provide technical support for all member questions related to the MasterCard Authorization Simulator software installation process. For technical assistance, please contact Simulator Support:

    E-mail: [email protected]

    Web site: www.mastercardonline.com

  • Installation Instructions Simulator Upgrade Installation

    2008 MasterCard 2-14 January 2008 MasterCard Authorization Simulator

    Simulator Upgrade Installation This section presents the upgrade installation for existing users of the MasterCard Authorization Simulator.

    The MasterCard Authorization Simulator installation instructions described in this section assume that you are upgrading from a previous version of the simulator to the current version.

    If you are upgrading to the current version of the MasterCard Authorization Simulator but performing the installation on a PC on which a previous version is not currently installed, see First Time Installation.

    This section describes the upgrade installation steps for the MasterCard Authorization Simulator.

    MasterCard Authorization Simulator Upgrade Installation

    This section describes the installation steps for the current version of the MasterCard Authorization Simulator for upgrade installation. The initial installation process performs the following actions:

    Updates the MasterINQ base platform Creates a new folder:

    C:\Program Files\MasterCard\MasterINQ63\Data_Credit_xx_x3

    Creates a new icon in the MasterCard Simulators folder icon on the PC desktop for the current version of the simulator

    Creates a new icon for the previous version of the simulator Adds application icons to the Start menu Copies user files from C:\Program

    Files\MasterCard\MasterINQXX4\Data_Credit_XX.X5\User to C:\Program Files\MasterCard\MasterINQxx6\Data_Credit_xx.x\User

    Copies license files from C:\Program Files\MasterCard\MasterINQXX\Bin to C:\Program Files\MasterCard\MasterINQxx\Bin

    3 xx_x equals the current version of the simulator

    4 XX equals the previous version of MasterINQ.

    5 XX.X equals the previous simulator version.

    6 xx equals the current version of MasterINQ.

  • Installation InstructionsSimulator Upgrade Installation

    2008 MasterCard MasterCard Authorization Simulator January 2008 2-15

    Installing the MasterCard Authorization Simulator Upgrade

    Use the following procedure to launch the installation process:

    Step Action

    1. Click the Windows Desktop Start button, and select Run.

    2. Click Browse to locate the MasterCard Authorization Simulator executable file (crsimxx_x.exe).

    Select C:\*7\crsim_sim\crsimxx_x.exe8 if you downloaded the MasterCard Authorization Simulator applications using MasterCard OnLine. (If necessary, modify the path)

    Select D:\Simulator\crsimxx_x.exe if you received the MasterCard Authorization Simulator applications on CD-ROM. (If necessary, modify the path.)

    3. Select crsimxx_x.exe, and click OK to begin the MasterCard Authorization Simulator installation program. The system briefly displays the progress indicator.

    4. Click Next to continue.

    5. Read the MasterCard Test Simulator Software License Agreement carefully, and click the I accept the terms of the license agreement radio button to accept the terms of the agreement and click Next.

    6. Click Install to start copying files.

    7. Click OK in the message indicating the installation of the USB Hardware Token Device Driver.

    8. Click Next.

    7 * equals the directory selected by the member when downloading the file from MasterCard

    Online.

    8 xx_x equals the current version simulator.

  • Installation Instructions Simulator Upgrade Installation

    2008 MasterCard 2-16 January 2008 MasterCard Authorization Simulator

    Step Action

    9. Click the Repair radio button.

    10. Click Next.

    11. Click Install.

    12. Click Finish.

    13. Click Finish when setup is complete.

  • 2008 MasterCard MasterCard Authorization Simulator January 2008 3-i

    3 Simulator Configuration This chapter describes how members can configure, customize, and modify the MasterCard Authorization Simulator to perform advanced testing.

    Configuration Options.........................................................................................3-1 Accessing Configuration Options .................................................................3-1

    Test Mode Options .................................................................................3-3 Network Options ..............................................................................3-3 Timers ...............................................................................................3-5 Modifying Timer Values ...................................................................3-5 AID and FID .....................................................................................3-7

    Currency Rates ........................................................................................3-8 Modifying a Currency Rate...............................................................3-8 Deleting a Currency Rate .................................................................3-9

    BIN Table ................................................................................................3-9 General Options ...............................................................................3-9 M/Chip and Pin Options ................................................................3-10 CVC Options ...................................................................................3-11 Processing Options.........................................................................3-14

    Crypto Keys...........................................................................................3-16 MChip Key Sets...............................................................................3-17

    Adding an MChip Key Set........................................................3-18 Modifying Key Values in MChipKeySet_User .........................3-18 Modifying Parameters in MChipKeySet_User..........................3-20 Setting a MChip Key Set as the Default MChip Key Set .........3-21 Selecting MChip Key Logging..................................................3-21

    PIN Processing Methods.......................................................................3-22 Key Exchange Process....................................................................3-22 Triple DES Encryption....................................................................3-23

    Creating User PIN Key Sets......................................................3-24 Modifying User PIN Key Sets...................................................3-25 Creating User BankNet PIN Key Sets ......................................3-27 Modifying User BankNet PIN Key Sets ...................................3-28

    HMAC Keys.....................................................................................3-30 Creating User HMAC Keys .......................................................3-30 Modifying User HMAC Keys ....................................................3-31 Deleting User HMAC Keys.......................................................3-32

    CVC Keys ........................................................................................3-32

  • Simulator Configuration

    2008 MasterCard 3-ii January 2008 MasterCard Authorization Simulator

    Creating a User CVC Key Set ...................................................3-32 Modifying User CVC Keys........................................................3-33 Deleting User CVC Keys ..........................................................3-35

    CVC3 Keys ......................................................................................3-35 Creating a User CVC3 Key Set .................................................3-35 Modifying User CVC3 Key Values ...........................................3-38 Modifying Parameters in CVC3KeySet_User ...........................3-41 Selecting the CVC3 Crypto Log................................................3-42 Deleting User CVC3 Keys ........................................................3-43

    TCP/IP ...................................................................................................3-43 Configuring the Simulator as the Client.........................................3-43

    Acquirer Table ......................................................................................3-45 PayPass .................................................................................................3-46

    Adding PayPass Mapping File Data...............................................3-46 Modifying PayPass Mapping File Information ..............................3-47 Deleting PayPass Mapping File Information.................................3-47

  • Simulator ConfigurationConfiguration Options

    2008 MasterCard MasterCard Authorization Simulator January 2008 3-1

    Configuration Options Members may customize the MasterCard Authorization Simulator to their specific testing needs by configuring the various options described in this section before performing advanced testing. The MasterCard Authorization Simulator saves options configured through the Set Options function and references these defined options for simulator processing. Options are dynamic and may be changed during testing.

    Accessing Configuration Options

    Members control the configuration settings by first selecting a testing mode and then modifying the different options available in the Options dialog box.

    Testing Mode

    IPS Host Testing APS Host Testing Options

    Test Mode Options Currency Rates BIN Table Crypto Keys TCP/IP Acquirer Table PayPass

  • Simulator Configuration Configuration Options

    2008 MasterCard 3-2 January 2008 MasterCard Authorization Simulator

    Use the following procedure to select a testing mode and to access the simulator configuration options.

    Step Action

    1. Double-click the MasterCard Authorization Simulator desktop icon.

    2. From the Navigator pane, select a testing mode from the drop-down list.

    3. Click Set Options to launch the Options dialog box.

    4. Select a tab and modify the different options as needed.

  • Simulator ConfigurationConfiguration Options

    2008 MasterCard MasterCard Authorization Simulator January 2008 3-3

    Test Mode Options

    From the Test Mode Options tab of the Options dialog box, members may modify specific Network processing options, Data options and timer values.

    Network Options

    Use the following procedure to change the Network Options:

    Step Action

    1. From the Options dialog box, select the Test Mode Options tab.

    2. Expand the Options group by clicking the corresponding plus sign.

    3. Modify the network options as needed. Double-clicking a value toggles the option on or off by changing the value to True (on) or False (off) for the corresponding option. See Table 3.1 for details concerning Network Options.

  • Simulator Configuration Configuration Options

    2008 MasterCard 3-4 January 2008 MasterCard Authorization Simulator

    Table 3.1Network Options

    Option Description

    Treat Data Integrity Edits as Production Format Errors

    Performs data integrity edit and if error found, stops 0100 message processing and sends a 0110 message with a format error.

    0800 Group Sign-On Selects PIN Key Set

    Sign-on selects the active PIN key set as configured in the PIN Key set option.

    Network Always Forward Request Messages

    Ignores all errors and continues processing of 0100 message.

    Network Always Forward Response Messages

    Ignores all errors and continues processing of 0110 message.

    Always Return DE 48 to Acquirer

    When selected, the simulator always returns DE 48 to the acquirer.

    Logging of Zero Length Messages

    Allows logging of zero length messages in the simulators history log file.

    Show Information Messages for Unannounced DE 48 Subelements

    When this option is selected, each unannounced DE 48 subelement is identified in the history log file with a message Unannounced DE 48 subelements are present and are being passed through the network.

    Include Test Description into Test Logs

    When this option is selected, the simulator writes the transaction description in the history log providing an easier means of locating a specific transaction in either the Test Monitor or Test Results component.

    Issuer supports DE 48/SE 58 This option indicates that the issuer does or does not receive DE 48, subelement 58 in 0100 and 0400 messages.

    Issuer supports Refund transaction

    This option indicates that the issuer can or cannot process refund transactions where the value in DE 3, subfield 1 is equal to 20 in the 0100/110, 0120/0130, and 0400/0410 messages.

    Issuer supports Balance Inquiry transaction

    This option indicates whether the issuer can or cannot receive ATM Balance Inquiry transactions where the value in DE 3, subfield 1 is equal to 30 and DE 48, position 1 (TCC) is equal to Z in the 0100/0400 messages.

    Acquirer supports DE 123 This option indicates that the issuer can or cannot receive DE 123.

    Acquirer supports MSI (Maestro)

    This option indicates that the acquirer can or cannot acquire Maestro (MSI) branded transactions.

  • Simulator ConfigurationConfiguration Options

    2008 MasterCard MasterCard Authorization Simulator January 2008 3-5

    Option Description

    Acquirer supports CIR (Cirrus) This option indicates that the acquirer can or cannot acquire Cirrus (CIR) branded transactions.

    Issuer PIN Processing Method This option indicates the service platform at which an issuers PIN processing will be performed. Double-clicking the option toggles the value to either M MDS PIN Processing or B BANKNET PIN Processing. See PIN Processing Methods for details.

    Message Encoding Format Toggles from EBCDIC to ASCII message encoding format.

    Timers

    Timer values define the amount of time the simulator will wait for a response from the host computer before the transaction times out. The system automatically assigns each timer to a specific class of messages. The default configuration has timer values that mirror production needs. The member may adjust the timer values within the Timers option as needed.

    Note Timer values are represented in milliseconds.

    Modifying Timer Values

    Use the following procedure to modify any of the timer values:

    Step Action

    1. From the Navigator pane, select the testing mode.

    2. Click the Set Options icon to display the Options dialog box.

    3. Select the Test Mode Options tab.

    4. Expand the Data group by clicking the corresponding plus sign.

    Jan 2008

  • Simulator Configuration Configuration Options

    2008 MasterCard 3-6 January 2008 MasterCard Authorization Simulator

    Step Action

    5. Expand the Timers group by clicking the corresponding plus sign.

    6. Double-click a timer value to display the Edit Timer Value dialog box.

    7. Type over the existing value with a new value and click OK

    8. Repeat steps 5 and 6 for each timer value as needed.

    9. Close the Options dialog box when finished.

  • Simulator ConfigurationConfiguration Options

    2008 MasterCard MasterCard Authorization Simulator January 2008 3-7

    AID and FID

    The AID and FID data options allow the member to set the DE 32 (Acquiring Institution ID Code) and DE 33 (Forwarding Institution ID Code) default values for simulator processing.

    Use the following procedure to set the default value for DE 32 and DE 33:

    Step Action

    1. From the Navigator pane, select the testing mode.

    2. Click the Set Options icon to display the Options dialog box.

    3. Select the Test Mode Options tab.

    4. Expand the Network/Data group by clicking the corresponding plus sign.

    5. Double-click a value to display the Edit Value dialog box.

    6. Highlight and type over the value with a new value as needed.

    7. Click OK.

  • Simulator Configuration Configuration Options

    2008 MasterCard 3-8 January 2008 MasterCard Authorization Simulator

    Step Action

    8. Repeat steps 5 through 7 for each Data field as needed.

    9. Close the Options dialog box when finished.

    Currency Rates

    The MasterCard Authorization Simulator provides a pre-populated currency rates table in the Options dialog box. Members typically will not need to modify the table. However, members may modify currency rate entries in the currency table as needed.

    Members may sort and move data in the Currency Table using the following navigational buttons:

    - moves the selected group or item upward in the table

    - moves the item downward one line at a time

    - sorts the first column of the table in a descending order

    Modifying a Currency Rate

    Use the following procedure to modify a currency rate in the Currency Rates table:

    Step Action

    1. From the Navigator pane, select a testing mode.

    2. Click the Set Options icon to display the Options dialog box.

    3. Select the Currency Rates tab to display the Currency Rates table.

    4. Double-click an existing rate to display the Edit Rate dialog box.

    5. Enter the appropriate value in the corresponding field as needed.

    6. Click Change when finished.

  • Simulator ConfigurationConfiguration Options

    2008 MasterCard MasterCard Authorization Simulator January 2008 3-9

    Deleting a Currency Rate

    Use the following procedure to delete a currency rate.

    Step Action

    1. From the Navigator pane, select Set Options.

    2. Select the Currency Rates tab.

    3. Click a currency to highlight the entire row.

    4. Click the Delete button. Answer appropriately to a confirmation message validating the delete action.

    BIN Table

    From the BIN Table tab of the Options dialog box, issuers may add a BIN range and indicate the following options for the specified BIN account range.

    General Options

    The following options are available under the General tab in the Edit BIN Range dialog box.

    Minimum and Maximum Account Range Indicates the minimum and maximum account ranges.

    Financial Network Code The value entered here becomes the default value for Network Data (DE 63) for the specified account range only.

    Issuer Currency Code The value entered does not affect any AMCC processing as of the 06.2 release of the simulator. This field has been replaced by the Cardholder Billing Currency Code field.

    Cardholder Billing Currency The value entered in this field is used to calculate DE 6 (Amount, Cardholder Billing) allowing the issuer to settle in one currency and have the cardholder billing transmitted in another currency.

    Network performs Stand-In Processing When selected, the simulator stores Authorization Request/0100 messages for retrieval by the issuer using a Store and Forward request.

  • Simulator Configuration Configuration Options

    2008 MasterCard 3-10 January 2008 MasterCard Authorization Simulator

    M/Chip and Pin Options

    The following options are available under the M/Chip and PIN tab in the Edit BIN Range dialog box.

    M/Chip Key Index The M/Chip Key Index works in conjunction with the associated account range to provide a reference link between the corresponding M/Chip Key in the Crypto Keys table. The M/Chip Key in the Crypto Keys table determines the M/Chip Key Set parameters for M/Chip processing.

    For example, a transaction, using a PAN that is within the account range identified with the specific M/Chip Key Index in the BIN Table, contains M/Chip data; the simulator compares the M/Chip Key Index for that account range to a matching M/Chip Key in the Crypto Keys table. Once an M/Chip Key Index match is made between the two tables, the simulator uses the corresponding M/Chip Key Set parameters defined in the Crypto Keys table for M/Chip processing.

    M/Chip On Behalf When selected, the simulator performs the following M