Enhanced Professional

Simulator
Quick Start Guide
15 Dec 2022
 Contents

Contents
Contents ......................................................................................................... 2

Chapter 1 Introduction and Scope ............................................................. 4

Chapter 2 Basic Comparison between the Legacy Simulator and

Enhanced Professional Simulator ............................................................... 5
Test Mode........................................................................................................................................ 6
Naming Difference ....................................................................................................................... 7
Similar Tabs ................................................................................................................................... 8

Chapter 3 How to configure license for Enhanced Professional

Simulator ..................................................................................................... 11
Procedure......................................................................................................................................11

Chapter 4 How to connect the Simulator to your host machine for

Acquirer Host Testing ................................................................................ 13
Procedure............................................................................................................................................ 13

Chapter 5 How to connect the Simulator to your host machine for

Issuer Host Testing .................................................................................... 18
Procedure............................................................................................................................................ 18

Chapter 6 New updated version installation of Enhanced Professional

simulator ..................................................................................................... 22
Procedure............................................................................................................................................ 22

Chapter 7 How to add and set up a test Card for Issuer Testing ........ 24
Adding a card in CardList .............................................................................................................. 25
Procedure............................................................................................................................................ 25
Link card to the transaction ......................................................................................................... 28
Procedure............................................................................................................................................ 28

Chapter 8 How to set up PIN keys .......................................................... 32

PIN key setup for Acquirer Host Testing ................................................................................... 33
Procedure............................................................................................................................................ 33
PIN key setup for Issuer Host Testing ........................................................................................ 36
Procedure............................................................................................................................................ 36

Chapter 9 How to set up EMV keys ........................................................ 40

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 2
 Contents

EMV setup at BIN level ................................................................................................................... 41

Procedure............................................................................................................................................ 41
EMV setup at card level ................................................................................................................. 44
Procedure............................................................................................................................................ 44

Chapter 10 How to set up CVC3 (Card Verification Cryptogram) ..... 48

CVC3 setup at card level ............................................................................................................... 49
Procedure to configure CVC3 ...................................................................................................... 49
Open Discretionary Data Wizard ............................................................................................... 50
CVC3 setup at BIN level ................................................................................................................. 52
Procedure to configure CVC3 ...................................................................................................... 52
Open Discretionary Data Wizard ............................................................................................... 54

Chapter 11 How to setup a transaction for Issuer Testing ................. 57

Create a new test case transaction (issuer)............................................................................ 58
Procedure............................................................................................................................................ 58
Edit data elements to test case .................................................................................................. 60
Procedure............................................................................................................................................ 60
Add data elements to test case .................................................................................................. 62
Procedure............................................................................................................................................ 62

Chapter 12 How to execute a test case for Issuer Testing................... 64

Procedure............................................................................................................................................ 64

Chapter 13 How to setup an ‘Issuer response profiles’ for Acquirer

Testing. ........................................................................................................ 65
How to unlock the AcquireSwitch.tclx (IssuerResponseProfile_MAS/MDFS) test case
library. .................................................................................................................................................. 66
Procedure............................................................................................................................................ 66
Create a new local test library to allow modifications......................................................... 66
Procedure............................................................................................................................................ 66
How to create/trigger an ‘Issuer Response Profile’/Test Case and Add/edit data
element into it ................................................................................................................................... 69
Procedure............................................................................................................................................ 69

Chapter 14 Log data ................................................................................. 73

How to enable crypto Logging ..................................................................................................... 74
About this task.................................................................................................................................. 74
Procedure............................................................................................................................................ 74
How to find the transaction logs ................................................................................................ 74
Procedure............................................................................................................................................ 74
How to export and save the logs................................................................................................. 77
Procedure............................................................................................................................................ 77
How to import/open saved logs .................................................................................................. 78

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 3
 Contents

Procedure............................................................................................................................................ 78

Chapter 15 How to generate a report .................................................... 79

Procedure............................................................................................................................................ 79

Chapter 16 How to perform multi-streams .......................................... 79

Procedure............................................................................................................................................ 79

Chapter 17 Mastercard Terminal Simulator Connectivity For Card

Based Issuer Testing .................................................................................. 81
Card Based Issuer Testing ............................................................................................................. 81
1. ................................................................................................... Prerequisites
............................................................................................................................................................... 81
2. ............................................................................................................ Project
............................................................................................................................................................... 81
3. ................................................. Connectivity in Enhanced Professional Simulator
............................................................................................................................................................... 82
4. ................................................... Connectivity in Mastercard Terminal Simulator
............................................................................................................................................................... 83
5. ........................................................................................................ Execution
............................................................................................................................................................... 84
6. ........................................................................................ Supported Messages
............................................................................................................................................................... 84

Chapter 18 Mastercard Migration Utility and its limitations............. 86

Mastercard Migration Utility User Guide.................................................................................. 86
Migration Utility Limitations ........................................................................................................ 86

Chapter 19 FAQ’s...................................................................................... 91
SQL Data Base Usage and Purpose........................................................................................... 91
How to set a delay in an Acquirer Testing in Response Profiles ........................................ 92
What is difference between Pause command and Delay option ...................................... 93
How can we resolve, if facing issue with Simulator tool alignment or how to
configure the simulator application alignments correctly (right-handed to left-
handed setting) ................................................................................................................................ 93

Notices ......................................................................................................... 96

Proprietary Rights ...................................................................................... 96

Trademarks ................................................................................................. 96

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 4
 Contents

Disclaimer .................................................................................................... 96

Translation .................................................................................................. 96

Information Available Online .................................................................... 97

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 5
 Introduction and Scope

Chapter 1 Introduction and Scope

Mastercard® is introducing new enhanced professional versions of Mastercard
Authorization Simulator (MAS) and Mastercard Debit Financial Simulator (MDFS)
software to provide faster performance and an enhanced offline testing experience to
customers. The document is useful for customers of Mastercard to work and
understand the migration steps to the Enhanced Professional Simulator (known
throughout as the Simulator).

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 4
 Basic Comparison between the Legacy Simulator and Enhanced Professional Simulator

Chapter 2 Basic Comparison between the Legacy

Simulator and Enhanced Professional Simulator

Test Mode ............................................................................................................................................ 6

Naming Difference .................................................................................................................................. 6
Similar Tabs............................................................................................................................................... 7

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 5
 Basic Comparison between the Legacy Simulator and Enhanced Professional Simulator
Test Mode

Test Mode

Enhanced
Legacy MAS/MDFS Professional
Simulator Test Mode Simulator Project Description
APS Host Testing Acquirer Switch Simulator will act as Issuer|Network for
Mode Acquirer Host
IPS Host Testing Issuer Switch Simulator will act as Acquirer|Network for
Mode Issuer Host
APS Stand Alone Acquirer Processor Simulator will act as Acquirer only (Not
recommended for customers)
IPS Stand Alone Issuer Processor Simulator will act as Issuer only (Not
recommended for customers)
APSTERMINALSTREA Card Based (This is only for internal testing and Not
MTCPIP Acquirer Testing recommended for customers)
Allows the user to connect the Enhanced
Simulator to the MasterCard Terminal
Simulator. Refer link for more information
(accessible to Mastercard Internal only)
APSTERMINALSTREA Card Based Issuer (This is for Customers Issuer Testing) Allows
MTCPIP Testing the user (Issuers) to connect the Enhanced
Simulator to the MasterCard Terminal
Simulator.
Refer Chapter “Mastercard Terminal
Simulator Connectivity For Card Based Issuer
Testing" for more information.

NOTE:
• Acquirer customer should use Acquirer Switch Project for Acquirer testing.
• Issuer customer should use Issuer Switch Project for Issuer testing.
• Customers are not recommended to use ‘Acquirer Processor’, ‘Issuer Processor’ and ‘Card
Based Acquirer Testing’ Projects.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 6
 Basic Comparison between the Legacy Simulator and Enhanced Professional Simulator

Naming Difference

Legacy MAS/MDFS Simulator Enhanced Professional Simulator

KEK {Eg. PINKeySet > (Group ID) > KEK} ZMK
PEK {Eg. PINKeySet > (Group ID) > PEK} ZPK
AC {Eg. MChipKeySet > (Group ID) > AC} AC_MDK {Eg. Card List/BIN Table > AC_MDK}
SMI {Eg. MChipKeySet > (Group ID) > SMI} MAC_MDK {Eg. BIN Table > Crypto > MAC_MDK}
SMC {Eg. MChipKeySet > (Group ID) > SMC} AC_MDK {Eg. Card List/BIN Table > AC_MDK}
IMK {Eg. CVCKeySet > (Group ID) > IMK} CVC3_MDK (Eg. Card List/BIN Table > CVC3_MDK)
Merchant Profiles Terminals (TerminalListInstances)
Card Profiles CardList (CardListInstances)
BIN Table CustomBINTable (CustomBINTable)
Acquirer Table Acquirers (AcquirerListInstances)

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 7
 Basic Comparison between the Legacy Simulator and Enhanced Professional Simulator
Similar Tabs

Similar Tabs

Legacy MAS/MDFS Simulator Enhanced Professional Simulator

Test Mode > Select Test Mode Similar to: File > New (Project Template)

‘Test Preparation’, ‘Test Monitor’, and ‘Test Similar to: ‘Test Preparation’, ‘Test
Results’ Execution’, and ‘Log Data’ respectively

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 8
 Basic Comparison between the Legacy Simulator and Enhanced Professional Simulator
Similar Tabs

MAS/MDFS Simulator Enhanced Professional Simulator

Test Options > ‘Bin Table’, ‘Crypto Keys’ and Similar to: Simulators > Simulation Data >
‘Acquirer Table’ ‘CustomBINTable’, ‘Crypto Keys’ and
‘Acquirers’ respectively

Test Preparation > Transaction Profiles Similar to: Test Preparation > TRIC > Select Specific
Test Case > Right pane ‘Messages’ > Send Messages

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 9
 Basic Comparison between the Legacy Simulator and Enhanced Professional Simulator
Similar Tabs

MAS/MDFS Simulator Enhanced Professional Simulator

Test Options > ‘Test Mode Options’ and Similar to: ‘Configuration’
‘Currency Rates’

User Manual Similar to: Help

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 10
Chapter 3 How to configure license for Enhanced
Professional Simulator
Procedure
1. Save provided license to your local path.
2. Search and open ‘license client config’ from your windows search.

3. Uncheck ‘Use License server’ and click on ‘Apply’.

4. Then click on ‘Install local license’.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 11
5. Browse saved license (.xml file) from your local and click on Open.
6. Make sure you get following popup after successful configuration.

7. Try creating/opening project after successful configuration.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 12
Chapter 4 How to connect the Simulator to your host
machine for Acquirer Host Testing
Procedure
1. After successful installation, open the Simulator using the Desktop shortcut.

2. Create a project with the Acquirer Switch Template.

3. Navigate to File > New and click on “MAS / MDFS Acquirer Switch” Project and click on
'Create'.

for

MAS

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 13
4. Once the project is created, user can any time open it from File > Open and click on “MAS /
MDFS Acquirer Switch” project. If the project is not in the ‘Open’ list, then click on

and open the .xts(e.g. ‘MAS Acquirer Switch MAS 22Q4.xts’) file from your created
project.

5. Navigate to Simulators > Maintain Simulators, then expand Connection Details and
select the communication node within the tree:

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 14
6. The right of the display should show the details for connection.

NOTE: Parameters are shown as read-only if the Simulator is connected. To edit these values,

you must first disconnect the Simulator via the toolbar controls.
7. Connecting your host to the Simulator ‘MAS / MDFS Acquirer Switch’ uses the IP of
the machine on which the Simulator is running (localhost) and port 2000. Note that
you can modify the Port to match with your host to build a connection. The Acquirer
Switch is the server, and your host is the client. You will need to configure the same
IP and Port to the Host to build a connection.

NOTE: The port should be unique or different in each instance of the simulator (legacy simulator as
well as enhanced simulator). It is recommended that MAS Acquirer Switch should use a
different port than MDFS Acquirer Switch. Please note that Simulator always holds the port
(e.g. 2222), so if you are using the same port (2222) in Enhanced simulator as used in legacy
simulator (2222), then you may face connection issue. To resolve this, give any different port
(e.g. 3333) in the legacy simulator and try connecting, this will unhold/free the previous port (2222)
and now user can use port (2222) in Enhanced simulator as the port (2222) is available to use.
8. Clicking on the connection icon

on the Switch toolbar will establish the connection between the ‘MAS / MDFS
Acquirer Switch’ and your Host.
©2022 Mastercard. Proprietary. All rights reserved.
Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 15
9. To view basic information about connection toolbar.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 16
10. To view simulator details, go to Simulators > Maintain Simulators > Simulator
Details. An example of the interface is shown below.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 17
Chapter 5 How to connect the Simulator to your host
machine for Issuer Host Testing
Procedure
1. After successful installation, open the Simulator using the desktop shortcut.

2. Create a project with the Issuer Switch Template.

3. Navigate to File > New and click on “MAS / MDFS Issuer Switch” Project and click on
'Create'.

4. Once the project is created, user can any time open it from File > Open and click on “MAS /
MDFS Issuer Switch” project. If the project is not listed in the ‘Open’ list, then click on

and open the .xts(e.g. ‘MAS Issuer Switch MAS 22Q4.xts’) file from your created project.
©2022 Mastercard. Proprietary. All rights reserved.
Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 18
5. Navigate to Simulators > Maintain Simulators, then expand Connection Details and
select the communication node within the tree:

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 19
6. The right of the display should show the details for connection.

7. Connecting your host to the Simulator ‘MAS / MDFS Issuer Switch’ uses the IP of
the machine on which Simulator is running (localhost) and port 2000. Note that you
can modify the Port to match with your host to build connection. The Issuer Switch
is the server, and your host is the client. You will need to configure the same IP and
Port to the Host to build a connection.

NOTE: The port should be unique or different in each instance of the simulator (legacy simulator as
well as enhanced simulator). It is recommended that MAS Acquirer Switch should use a
different port than MDFS Acquirer Switch. Please note that Simulator always holds the port
(e.g. 2222), so if you are using the same port (2222) in Enhanced simulator as used in legacy
simulator (2222), then you may face connection issue. To resolve this, give any different port
(e.g. 3333) in the legacy simulator and try connecting, this will unhold/free the previous port (2222)
and now user can use port (2222) in Enhanced simulator as the port (2222) is available to use.
8. Clicking on the connection icon

on the Switch toolbar will establish the connection between the ‘MAS / MDFS Issuer
Switch’ and your Host.
9. Basic information about connection toolbar.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 20
10. To view simulator details, go to Simulators > Maintain Simulators > Simulator
Details. An example of the interface is shown below.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 21
Chapter 6 New updated version installation of Enhanced
Professional simulator
Procedure

1. Download latest version from Simulator-Suite page on MC connect.

2. Install and open the ‘Mastercard MAS/MDFS <version>’ shortcut.
3. Navigate to the ‘New’ tab and select template of the project as per your preference.

4. Customer can use the ‘Copy details from selected project’ option to copy/migrate their
existing project data from the selected project to new project.

5. The ‘Copy details from selected project’ option will copy/migrate the following data from
their selected project to this new project.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 22
6. Click on ‘Create’ button to create project.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 23
Chapter 7 How to add and set up a test Card for Issuer
Testing

Adding a card in CardList....................................................................................................................17

Link card to the transaction ...............................................................................................................20

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 24
Adding a card in CardList

Procedure
1. In an Issuer Switch project, navigate to the Simulators > Simulation Data.

2. Select a folder in ‘CardList’ or create a new folder by clicking on the 'New

Folder' option .

3. Then click on 'New Item' and you will get a popup to choose card type.

NOTE: User also can copy the existing card and modify the details.
4. Choose a card type and click on OK.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 25
 For example, ‘Mastercard ChipCard’ is selected and the fields are available on
the right panel to enter the card details.

5. Right click to edit/modify card details, such as making the card default.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 26
©2022 Mastercard. Proprietary. All rights reserved.
Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 27
Link card to the transaction

Procedure
1. Navigate to ‘Test Preparation’ tab and select an exsisting folder or create a

new folder by clicking the 'New Folder' option .

2. Click on 'New Test Case' to create a new test case or select the
exsisting test case in which you want to link the card.
3. If a new test case iss created using step two, then add the transaction message
of your choice from the ‘Send Message’ list.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 28
 NOTE: If you are using an existing test case, the transaction message should already
present in the transaction.
4. Once the test case is created, it will auto select the default card set up in
CardList (refer to step five in "Adding a card in CardList").
5. To link other cards than the default card, for example an
0100_Authorization_Request, select Send > Edit message > Models > Cards >
Expand.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 29
 6. Choose a card from the cards list and click on 'Link to Message' to link the
selected card to the transaction.
7. After adding a card to the transaction, view the data elements and data added
from card (highlighted).

8. Modify the data element and its values from ‘Edit Message’ section shown in
above screen.
9. Execute the transaction by navigating to the ‘Test Execution’ tab and select the

test case you intend to execute, then click Run Selected Test Case(s) .

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 30
©2022 Mastercard. Proprietary. All rights reserved.
Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 31
Chapter 8 How to set up PIN keys

PIN key setup for Acquirer Host Testing ................................................................................... 25

PIN key setup for Issuer Host Testing ........................................................................................ 27

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 32
PIN key setup for Acquirer Host Testing

Procedure
1. Navigate to Simulators > Simulation Data.
2. Expand the ‘Crypto Keys (CryptoListInstances)’ folder.

3. Follow steps four through six to create a new crypto key or go to directly to
step seven to use any existing crypto keys.
4. Select a folder in ‘Crypto Keys’ or create a new folder by clicking on 'New

Folder' option .

5. Then click on 'New Item' and choose PIN key set length.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 33
 NOTE: You can copy the existing Crypto Key and modify the keys.
6. The right panel should show the ‘ZPK’ and ‘ZMK’ to configure the keys in it.

7. Once the Crypto Key is completed, you'll need to configure the same to
acquirer profile ‘Acquirers (AcquirerListInstances)’.
NOTE: Acquirer Profile will be picked up on the biases of ‘Acquirer ID’
which belongs to DE 32 in request message. So, here if DE 32 in MTI
0100 message is ‘123456’ then the respective Acquirer profile with
Acquirer ID match with DE 32 will be used in transaction.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 34
 8. Expand ‘Acquirers (AcquirerListInstances)’ and select the acquirers profile you
are using.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 35
 9. The right panel should show the ‘PINKeySetReference’ option where you'll need
to configure the Crypto Key from the drop-down list and the same key will be
used for performing PIN encryption/decryption operation.

10. You'll need to configure the same keys in your host system to perform the
encryption decryption with matching keys.

PIN key setup for Issuer Host Testing

Procedure
1. Navigate to the Simulators > Simulation Data.
2. Expand the ‘Crypto Keys (CryptoListInstances)’.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 36
 3. Follow steps four through six to create a new crypto key or go to directly to
step seven to use any existing crypto keys.
4. Select a folder in ‘Crypto Keys’ or create a new folder by clicking on 'New

Folder' option .

5. Then click on 'New Item' and choose PIN key set length.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 37
 NOTE: You can copy the exsisting Crypto Key and modify the keys.
6. The right panel should show the ‘ZPK’ and ‘ZMK’ to configure the keys in it.

7. Once the Crypto Key is completed, you'll need to configure the same to ‘Issuers
(IssuerListInstances)’.
8. Expand ‘Issuers (IssuerListInstances)’ and select the issuer profile you are using.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 38
 9. The right panel should show the ‘PINKeySetReference’ option where you need
to configure the Crypto Key from the drop-down list and the same key will be
used for performing PIN encryption/decryption operation.

10. You'll need to configure the same keys in your host system to perform the
encryption decryption with matching keys.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 39
Chapter 9 How to set up EMV keys

EMV setup at BIN level .................................................................................................................. 32

EMV setup at card level................................................................................................................. 34

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 40
EMV setup at BIN level

Procedure
1. Navigate to Simulators > Simulation Data > Expand CustomBINTable.
2. Click on a BIN table from the list or create a new BIN table by clicking on 'New

Item' .

3. The right pane of the display should show the BIN details.
4. Setup the BIN range with RangeMin and RangeMax in ‘Criteria’. The cards categories
under the defined BIN range will pick up the data from the respective Bin table.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 41
 5. Select the Card Type from the dropdown.

6. Currency conversion fees ICCR and CBFM can be set here.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 42
 7. Setup the data into the other field as per requirement.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 43
EMV setup at card level

Procedure
1. Navigate to Simulators > Simulation Data > Expand CardList
2. Click on a chip card from the list or create a new chip card by referring to
Chapter 7: "Adding a card in CardList."
3. The right of the display should show the card details.

4. Expand the EMV to set up the data.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 44
 5. Enter the data into the respective field.
6. To open 9F10 Wizard, right click on IAD (Issuer Application Data (EMV Tag 9F10))
and click on Open Wizard.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 45
 7. Set up the M/Chip 9F10 values in wizard below.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 46
 8. Once done, link the card to the transaction by referring to Chapter 7: "Link card
to the transaction" or make it default.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 47
Chapter 10 How to set up CVC3 (Card Verification
Cryptogram)

CVC3 setup at card level............................................................................................................... 37

CVC3 setup at BIN level ................................................................................................................ 38

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 48
CVC3 setup at card level

Procedure to configure CVC3

1. Navigate to the Simulators > Simulation Data > Expand CardList
2. Click on a card profile from the list or create a new card by referring to Chapter
"Adding a card in CardList."
3. The right of the display should show the card details.

4. Expand the CVC3 to set up the data.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 49
 5. Enter the data into the respective field.
6. You can set the ‘Use_Dynamic_IVCVC3’ to ‘Yes’ for performing Dynamic
IVCVC3.
7. Once done, link the card to the transaction by referring to Chapter "Link card
to the transaction" or make it default.

Open Discretionary Data Wizard

1. To Open Discretionary Data Wizard
2. Expand CVC3  Discretionary DataLayout

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 50
 3. Right click on Track1 / Track2 Discretionary DataLayout and click on Open
Wizard

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 51
CVC3 setup at BIN level

Procedure to configure CVC3

1. Navigate to the Simulators > Simulation Data > Expand CustomBINTable.
2. Click on a BIN table from the list or create a new BIN table by clicking on 'New

Item' .

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 52
 3. The right of the display should show the BIN details.

4. Expand the CVC3 to set up the data.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 53
 5. Enter the data into the respective field.
6. You can set the ‘Use_Dynamic_IVCVC3’ to ‘Yes’ for performing Dynamic
IVCVC3.

Open Discretionary Data Wizard

4. To Open Discretionary Data Wizard
5. Expand CVC3  Discretionary DataLayout

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 54
 6. Right click on Track1 / Track2 Discretionary DataLayout and click on Open
Wizard

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 55
©2022 Mastercard. Proprietary. All rights reserved.
Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 56
Chapter 11 How to setup a transaction for Issuer Testing

Create a new test case transaction (issuer) .................................................................................43

Edit data elements to test case ........................................................................................................ 45
Add data elements to test case ........................................................................................................ 47

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 57
Create a new test case transaction (issuer)

Procedure
1. In an “Issuer Switch” project, navigate to Test Preparation > Expand 'MAS/
MDFS Test Cases' folder or create a new folder by clicking on 'New Folder'

option .

2. Then click on 'New Test Case' and give it a name and enter.
3. From the right of the screen, select any transaction profile from the Messages
> Send Message and add it to the test case by clicking on ‘Add Transaction’.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 58
 4. Make sure the transaction profile gets added and must be visible on the right
panel of the screen as shown below.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 59
Edit data elements to test case

Procedure
1. Select a test case you want to edit its data elements.
2. Click to the ‘Send’ message of the selected transaction.

3. Click ‘Edit Message’ and see the data elements and its values in the
transaction.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 60
 4. You can click on the Data Element and its value to modify it. For example, in the
screen below, DE 004 was clicked and the value was modified to
000000012345. You can see the modification in the transaction.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 61
Add data elements to test case

Procedure
1. Select a test case to add the data elements.
2. Click ‘Send’ of the selected transaction.

3. Click ‘Edit Message.' The lower right panel of the screen shows the option for
‘Valid Elements.’

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 62
 4. Select a data element from the list to add to the transaction and click on ‘Add
to Message.’
5. Refer to "Edit data elements to test case" to edit the data element value.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 63
Chapter 12 How to execute a test case for Issuer Testing
Procedure
1. In an “Issuer Switch” project, navigate to the Test Execution > Expand MAS / MDFS
Test Cases.
2. Click on a folder or select test case(s) which you want to execute.
3. Click on ‘Run Selected Test Case(s)’ to execute.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 64
Chapter 13 How to setup an ‘Issuer response profiles’ for
Acquirer Testing.

Create a new local test library to allow modification ....................................................................43

How to create/trigger an ‘Issuer Response Profile’/Test Case and Add/edit data element into
it.................................................................................................................................................................. 45

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 65
How to unlock the AcquireSwitch.tclx
(IssuerResponseProfile_MAS/MDFS) test case library.

Note: The ‘Issuer response profiles’ are locked initially and restricted for modification. If
customer wants to do any modification in Mastercard provided test case library
‘IssuerResponseProfile_MAS/MDFS (AcquirerSwitch.tclx)’ then please follow the steps below.

Procedure

1. Navigate to the ‘Test Preparation’ in Acquirer Switch project.

2. Select ‘IssuerResponseProfile_MAS/MDFS (AcquirerSwitch.tclx)’ test case library and click

on export and save the file with different name.

3. Once the file is saved, open the same file by clicking on Open Library option. Now the
file is unlocked and will be available with all the modification option enabled.

Create a new local test library to allow modifications

Note: The ‘Issuer response profiles’ are locked initially and restricted for modification. If
customer want to create their own ‘Issuer response profiles’, please follow the steps below.

Procedure

4. Navigate to the ‘Test Preparation’ in Acquirer Switch project.

5. Click on ‘New local library’ on your system and give it a name. E.g. ‘User_IRP.tclx’

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 66
6. Now user can create/modify their own Issuer Response Profiles.
7. Also, can use all the following highlighted option like – new test case/new
folder/copy/cut/past/delete/import/export/etc..

8. To get back to the original ‘IssuerResponseProfile_MAS / MDFS’ library, user can use ‘Open

Library’ or import option and select the original library.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 67
©2022 Mastercard. Proprietary. All rights reserved.
Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 68
How to create/trigger an ‘Issuer Response Profile’/Test Case and
Add/edit data element into it

Procedure

1. Once the local library is created by using above steps, click on 'New Folder' option

and then click on ‘New Test Case (Insert)’ and give it name.

2. Then click on ‘Receive Messages’ and see the messages that are expected to receive on
Acquirer Switch project.

3. Select the receive message for which you want to create/trigger an Issuer Response

Profile. For e.g. select ‘100_Authorization_Request’ and click on .

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 69
4. Once the receive message is added, you able to see the ‘Receive’ message and
corresponding ‘Send’ message.

5. Select on ‘Receive’ message (E.g. ‘100_Authorization_Request’) and click on ‘Trigger Test

Case’  ‘Incoming Element’.
6. In the ‘Incoming Element’ tab, choose the data element you want to use to trigger the test

case and click on . For e.g. choose DE002(PAN) and DE004(Amount)

7. Set the values in the added Data Element field which you are expecting in the ‘Receive
message’(E.g. 0100 message)

8. Users need to send the same DE values as above, in transaction request message (E.g.
0100 message) from their Acquirer Host to trigger this Issuer Response Profile/Test case.
9. Now, to add Data Element into the Issuer response profile/Response message. Users need
to click on ‘Send’ Message (E.g. 0110_Authorization_Request_Response)  Edit Message.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 70
10. Here user can add/edit the value in Data Element (E.g. Set DE039 to value 05). Chose the
data element from the ‘Edit Message’ and set the expected value in response message
and ‘Enter’. The updated value will be added into the response message.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 71
11. Additional data element can be added from the set and can modify its
values.
NOTE: In the above mentioned E.g. The created Issuer Response profile (TestCase1) will
only trigger if user send the MTI_0100 request message from their Acquirer Host with
having the values DE002 equal to 5204730000000013 and DE004 equal to
000000001234 to Acquirer Switch. When the values are matched with the Trigger test
case criteria the Issuer response profile will triggered and DE039 value 05 will be added
into the MTI_0110 response message as set in test case.

12. Also, user can just execute the Issuer response profile from tab by clicking
on ‘Run Selected Test Case(s)' button and then the ‘Acquirer Switch’ simulator will
wait for the request message to execute the Issuer response profile and send the
appropriate message in response.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 72
Chapter 14 Log data

How to enable crypto Logging ..........................................................................................................51

How to find the transaction logs ......................................................................................................51
How to export and save the logs ......................................................................................................54
How to import/open saved logs ........................................................................................................55

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 73
 How to enable crypto Logging

How to enable crypto Logging

About this task

This task is to view additional data regarding crypto activities (like PIN encryption/
decryption, ARQC calculations and other crypto activities) and will be included in
the logs.

Procedure
1. Navigate to File > Options
2. Click 'On' in 'Crypto Logging' and all crypto activities will be included in the log
data.

How to find the transaction logs

Procedure
1. Navigate to ‘Log Data’.
2. Expand ‘Sending Message’ to see the message sending from the Simulator.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 74
 3. Expand ‘Message Received’ to see the message received to the Simulator.

4. Expand ‘Parsed Content’ to see the data elements and values parsed in the
transaction message.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 75
 5. Expand the same from logs to see the crypto logs like PIN encryption, PIN
decryption, ARQC, ARPC, and so on.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 76
 NOTE: You can hide the crypto logs by clicking on ‘Hide Crypto’ option above.

How to export and save the logs

Procedure
1. Navigate to ‘Log Data’.
2. Click on 'Export Log' in .xlog format and save it to your local machine.

3. To export the selected logs, select the rows you intend to export.
4. Right click and choose the option in the format you want to export to the logs.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 77
 How to import/open saved logs

How to import/open saved logs

Procedure
1. Navigate to ''Log Data.'
2. Click on 'Open Saved Log,' browse the .xlog file and open.

3. To go back to current live log, click on 'View Live Log.'

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide • 15 Dec 2022 78
Chapter 15 How to generate a report
Procedure
1. Navigate to 'Report' tab.

2. Apply the configuration of your choice and click on ‘Generate Report.’

3. Save the report by clicking on HTML.

Chapter 16 How to perform multi-streams

Procedure

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide 15 Dec 2022
1. Open the Two different instances of ‘Mastercard MAS/MDFS 22Q4’ from shortcut and
create/open the project you want to work on.

2.

3. Navigate to the Maintain Simulators  Issuer Switch Tcp Server Com Module  Port.
Then give a different Port Number to both the instances. Make sure that both the
simulator instances have different port number than each other.
4. Now, user can connect the two different instances from their same or different host
machines by configuring the Ip and port.
5. Please note that same project cannot be open in two different instances.
6. If user wants to use same project (E.g. MAS Issuer Switch MAS 22.Q4) in two different
instance then user can make a copy of the same project from where the project is
saved on their local machine (E.g. Path- C:\Users\<user>\OneDrive -
Mastercard\Documents\Mastercard\MAS 22Q4\Projects) and give it a different
name(E.g MAS Issuer Switch MAS 22Q4 - Copy).

7. In your other instance Navigate to ‘Open’ tab  click on and open the
.xts file from your copied project.

8. Also, user can create new project with different name to connect with another host

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide 15 Dec 2022
Chapter 17 Mastercard Terminal Simulator Connectivity
For Card Based Issuer Testing
The ‘Card Based Issuer Testing’ Project allows the user to connect the Enhanced Professional MAS / MDFS
Simulators to the Mastercard Terminal Simulator. The Enhanced MAS / MDFS simulator is able to receive
transactions from the Terminal Simulator and send them to an issuer host via the Enhanced MAS/MDFS
Simulator.

Card Based Issuer Testing

This section explains the steps needed to conduct Card Based Issuer Testing.

1. Prerequisites

The following must be in place before testing can begin:

 Installation of the Mastercard Terminal Simulator utility provided by Mastercard.

 Card reader and test physical or contactless cards.

 Installation of MAS or MDFS Enhanced Version 23Q2 and above.
 Creation of the MAS or MDFS Card Based Issuer Testing project

2. Project

A new project will need to be created before testing can begin.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide 15 Dec 2022
  Navigate to File > New
 Select “Card Based Issuer Testing” template to create a new project. As below:

 Select “Create” a new Card Based Issuer testing project will be created.

3. Connectivity in Enhanced Professional Simulator

Once the project is created (MAS or MDFS), two simulators will be available for the user.

 CAD2HOST:
 CAD 2 HOST TCP Server COM Module
 Issuer Switch
 Issuer Switch TCP Client Com Module

Connection
MAS

1. The ‘CAD 2 HOST TCP Server COM Module’ is in a wait state for incoming CAD2Host
messages from the Terminal Simulator on Port 3331
2. The ‘Issuer Switch TCP Client COM Module’ needs to connect with User’s Issuer host and
set to Port 2004 (Please refer Chapter ‘How to connect the Simulator to your host
machine for Issuer Host testing’ for connection)

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide 15 Dec 2022 82
MDFS

1. The ‘CAD 2 HOST TCP Server COM Module’ is in a wait state for incoming messages
from the Terminal Simulator the default Port set to 3431 (customers can change the
port to 3331 in MDFS in order to connect to the default Terminal Simulator port)
2. The ‘Issuer Switch TCP Client COM Module’ needs to connect with User’s Issuer host and
set to Port 3001 (Please refer Chapter ‘How to connect the Simulator to your host
machine for Issuer Host testing’ for connection)

Click the Connect option to connect the ‘CAD 2 HOST TCP Server COM Module’ to
Mastercard Terminal Simulator and to connect ‘Issuer Switch TCP Client COM Module’ to
your Issuer Host. The connections should look like the below to begin:

Note: The CAD 2 Host TCP Server Com Module channel will be spinning – waiting on incoming
message from the Terminal Simulator.

4. Connectivity in Mastercard Terminal Simulator

The Mastercard Authorization (MAS) or Debit (MDFS) simulators are normally pre-configured
to accept transactions from the Mastercard Terminal Simulator on port 3331(for MAS) and
3431(For MDFS - (customers can change the port to 3331 in MDFS in order to connect to the
default Terminal Simulator port)).
• Open the terminal.txt file stored in the installation\scripts folder
(C:\MasterCard\Terminal Simulator\Scripts by default).
• Under ‘TCPIP Settings’ section change the following values to the IP address of the
©2022 Mastercard. Proprietary. All rights reserved.
Enhanced Professional Simulator —Quick Start Guide 15 Dec 2022 83
 machine on which MAS/MDFS is running, and port 3331(for connecting to MAS) and
3431(For connecting to MDFS (customers can change the port to 3331 in MDFS in
order to connect to the default Terminal Simulator port)) unless Enhanced MAS/MDFS
settings have been changed to another value. If the Terminal Simulator is on the same
machine as MAS/MDFS then the IP address can remain at 127.0.0.1

5. Execution

At this stage the user can begin to send messages into the project and running simulators
using the Mastercard Terminal Simulator. Please see the user guide that is provided with the
Terminal Simulator for more details.

Once messages are exchanged, detail of the exchanges can be viewed on the following
interfaces:

 Terminal Simulator <> Issuer Switch <> User’s Issuer Host message exchanges can be
viewed on the Log Details tab.
 Results of send and received message can be viewed on Log Details tab.

6. Supported Messages

Only messages mentioned in the below tables are in scope for the Card Based Issuer testing
feature:

For MAS

Mastercard Terminal Card Based Issuer User’s Issuer Host

Simulator Testing Simulator
Sends 1100 >> Receives 1100 >> Receives 0100
Translated to 0100 >>
Receives 1110 << Receives 0110 << Responds with 0110
<< Translates to 1110
Sends 1420 >> Receives 1420 >> Receives 0400
Translates to 0400 >>
Sends 1421 >> Receives 1421 >> Receives 0400
Reversal Advice Repeat Translates to 0400 >>
Request

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide 15 Dec 2022 84
 Receives 1430 << Receives 0410 << Responds with 0410
<< Translates to 1430

For MDFS

Mastercard Terminal Card Based Issuer User’s Issuer Host

Simulator Testing Simulator
Sends 1100 >> Receives 1100 >> Receives 0200
Translated to 0200 >>
Receives 1110 << Receives 0210 << Responds with 0210
<< Translates to 1110
Sends 1420 >> Receives 1420 >> Receives 0420
Translates to 0420 >>
Sends 1421 >> Receives 1421 >> Receives 0420
Reversal Advice Repeat Translates to 0420 >>
Request
Receives 1430 << Receives 0430 << Responds with 0430
<< Translates to 1430

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide 15 Dec 2022 85
Chapter 18 Mastercard Migration Utility and its limitations

Mastercard Migration Utility User Guide

The Migration Utility is available to users to allow them to migrate their legacy MAS/MDFS
user(customized) files/libraries to new Enhanced Simulator supported format. Clients moving
onto the new Enhanced Professional Version of MAS and MDFS will need a utility to convert
their files (Card Profiles, Merchant Profiles, Bin Tables, Response Profiles and Issuer Test
cases) so their custom data can be used on the new platform. The 'Migration Utility User
Guide' is embedded in 'Help' section in the Migration Utility tool to help users to use the tool.
To install the utility simply unzip the downloaded file and open the folder. Right click on the
setup.exe file and select Run as administrator. Open the ‘Mastercard Migration Utility v10’
shortcut.

Migration Utility Limitations

Issuer Test Case Conversion Limitations

The known limitations are:

 The Migration Utility does not handle the Semicolon ‘;’ (special character) present in
field value. So, this causes an error when the Semicolon present in field value.
 Test cases belonging to 'IssuerTest' folder are skipped
 Test cases which do not match Issuer testing are skipped
 Test cases not referencing any transaction profile are skipped
 Test cases referencing a transaction profile for which the migration tool cannot
determine the right message template are skipped
 Test instructions are skipped
 DE/SE modifiers applying to the following DE048 SE are skipped: 048.TLV.01,
048.TLV.02, 048.TLV.03, 048.TLV.04
 DE/SE modifiers applying to DE048, 052 or 125 are skipped
 DE/SE modifiers whose value is set to "(donotsend)" and applying to DE043, DE043 SE
or DE052 are skipped
 DE/SE modifiers whose value is set to "(default)" in the legacy tcx file are skipped when
no default value for this DE/SE is defined in the migration tool.
 Expected results with inconsistent settings are skipped

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide 15 Dec 2022 86
 BIN Table Limitations

At the end , only 11 fields (out of 75 possible fields) from the legacy model can be migrated to
Enhanced Simulator - this means that for some bin table entries, 85% of the data may not be
migrated

1. The utility does not handle ‘Null’ condition in BIN table.

2. The following fields from the legacy model do not have any equivalent in the newly created
model:

 Account Category, Account Level Management Participation

 ADC Event Messaging Info
 Adjusted Score 1, Adjusted Score 2
 AVS Service Type
 BIN Participates as Token Service Provider
 Canadian Non Face-to-Face Participation
 Cardholder Authentication Service
 Chip CVC Key Set
 Co-Branded with Canadian Brand
 CVC Key Set, CVC1 Start Position, CVC2 Registered, CVC3 Key Index
 ECB Conversion Rate
 Expired Card Indicator
 Fraud Scoring Service Rules
 High ATC Discrepancy Limit
 Forward Message to Issuer if CVC3 Validation Fails
 Issuer Participates in ATM PIN Change For Magstripe Cards,
 Issuer Participates in PIN Management,
 Issuer Receives Card Seq Number (DE23) for MDES,
 Issuer Receives Cryptographic Data for MDES,
 Issuer Receives Settlement Amount,
 Issuer Supports ATM Transactions,
 Issuer Supports HealthCare,
 Issuer Supports HealthCare PWCB with PIN,
 Low ATC Discrepancy Limit,
 M/Chip Key Index,

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide 15 Dec 2022 87
  MasterCard is BIN Controller,
 Maximal amount for Gaming Payment Transactions,
 MDES Additional Transaction Analysis,
 MDES Additional Transaction Analysis Test Results 07 or 09,
 MDES Additional Transaction Analysis Test Results 81,
 MDES Additional Transaction Analysis Test Results 91,
 MDES Additional Transaction Analysis Transaction Disposition 07 or 09,
 MDES Additional Transaction Analysis Transaction Disposition 81,
 MDES Additional Transaction Analysis Transaction Disposition 91,
 MDS Validates PIN on Behalf Of Issuer,
 MoneySend Blocking Service Result,
 MoneySend Sanction Screening Score,
 MPG Auth Block Participant,
 OBS, OBS 50 Sub OBS Selection, OBS 54 TRCV,
 Particapates in Cross-border Commodities Trade Program,
 Pay With Points On-Behalf Result,
 PIN Verification Test in Stand-In Processing,
 POS Rewards Service,
 Private Label Support,
 PWCB Option,
 RPCS,
 Score Reason Code 1, Score Reason Code 2, Score Reason Code 3,
 Security Services Additional Data for Issuers,
 Set UN length to zero for IVCVC3 calculation,
 STIP,
 Storage Technology,
 Third Party Processor ID Participant,
 Token Requestor ID
 Wallet Identifier.

Response Profile Limitations

 The Migration Utility does not handle the Semicolon ‘;’ (special character) present in
field value. So, this causes an error when the Semicolon present in field value.
©2022 Mastercard. Proprietary. All rights reserved.
Enhanced Professional Simulator —Quick Start Guide 15 Dec 2022 88
  All the ‘Add New Instruction’ from legacy simulator Issuer response profile will not
be able to migrate by Migration Utility.

All fields but request/response instructions are supposed to be converted. Here are
examples of such skipped instructions (Note: the following is copied from the log file
generated when migrating
C:\ProgramData\Mastercard\OTP\Data_MAS_22_4_0\Reference\Credit\IssuerResponse
Profiles_Reference.tre – some other instructions may be skipped):
WARNING : Seqtype reqinstruction is not supported: 'ARQCValidate': 'ARQCValidate' is
skipped.
WARNING : Seqtype reqinstruction is not supported: 'DoNotRespond': 'DoNotRespond' is
skipped.
WARNING : Seqtype reqinstruction is not supported: 'Log': 'Log' is skipped.
©2022 Mastercard. Proprietary. All rights reserved.
Enhanced Professional Simulator —Quick Start Guide 15 Dec 2022 89
 WARNING : Seqtype reqinstruction is not supported: 'PINValidate': 'PINValidate' is
skipped.
WARNING : Seqtype reqinstruction is not supported: 'SetMchipKeySetReq':
'SetMchipKeySetReq' is skipped.
WARNING : Seqtype reqinstruction is not supported: 'ValidateCVC3Track1':
'ValidateCVC3Track1' is skipped.
WARNING : Seqtype reqinstruction is not supported: 'ValidateCVC3Track2':
'ValidateCVC3Track2' is skipped.
WARNING : Seqtype respinstruction is not supported: 'ARPCGenerate': 'ARPCGenerate'
is skipped.
WARNING : Seqtype respinstruction is not supported: 'AddCommand': 'AddCommand' is
skipped.
WARNING : Seqtype respinstruction is not supported: 'AddCommand[1]':
'AddCommand[1]' is skipped.
WARNING : Seqtype respinstruction is not supported: 'AddCommand[2]':
'AddCommand[2]' is skipped.
WARNING : Seqtype respinstruction is not supported: 'AddCommand[3]':
'AddCommand[3]' is skipped.
WARNING : Seqtype respinstruction is not supported: 'AddCommand[4]':
'AddCommand[4]' is skipped.
WARNING : Seqtype respinstruction is not supported: 'AddCommand[5]':
'AddCommand[5]' is skipped.
WARNING : Seqtype respinstruction is not supported: 'AddCommand[6]':
'AddCommand[6]' is skipped.
WARNING : Seqtype respinstruction is not supported: 'AddCommand[7]':
'AddCommand[7]' is skipped.
WARNING : Seqtype respinstruction is not supported: 'AddTag': 'AddTag' is skipped

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide 15 Dec 2022 90
Chapter 19 FAQ’s

SQL Data Base Usage and Purpose

The purpose of using SQL local dB is to store test logs data and recall this data in a
performant manner versus XML stored on disk. As you are aware, log files can be huge, and
this was a conscious design decision in the best interest of system performance. SQL localdb is
program embedded and cannot be split, removed nor called from an API.

1. Is the “SQL Express Local DB” an embedded database?

Yes, Its embedded within application
2. Can anyone connect to this database and make DDL/DML changes?
A. Files are currently stored in a user-specific location:
<user>\AppData\Local\FIS\Integri.ICL.Log.Serialization.SqlLocalDb (thus not a shared
location) Access is thus limited to that user.
B. Read the following explanation from Microsoft documentation:
An instance of SQL Server Express Local DB is an instance created by a user for
their use. Any user on the computer can create a database using an instance of Local
DB, store files under their user profile, and run the process under their credentials. By
default, access to the instance of Local DB is limited to its owner. The data contained in
the Local DB is protected by file system access to the database files. If user database
files are stored in a shared location, the database can be opened by anyone with file
system access to that location by using an instance of Local DB that they own. If the
database files are in a protected location, such as the user’s data folder, only that user,
and any administrators with access to that folder, can open the database. The Local DB
files can only be opened by one instance of Local DB at a time.

3. Can anyone outside of the DB host connect to this SQL database using connection
string/auth?
1. No, Local DB does not accept remote connections
2. Additionally
The answer to question two, explains why we are getting SQL issues, where Admin is
installing this on behalf the other user
This also means that it is more secure as only the user on that profile can connect to the
specific DB, which makes it more secure.

4. What is the data used for & should this DB be backed up?
It used for logging and no need for backup.
5. Can you tell whether the SQL Server required?
Yes, this uses SQL Server Express (local DB). This is a cut down version of SQL server (a
light database)
©2022 Mastercard. Proprietary. All rights reserved.
Enhanced Professional Simulator —Quick Start Guide 15 Dec 2022 91
6. if Yes, then - can it be deployed outside the local system?
No, Is this required???
7. If it can be deployed outside the local system, then can we use the most recent version of
SQL Server instead of the outdated 2014 version?
8. Can a SQL server Enterprise Edition be used instead of LocalDB?
No- the version or product of database can not be changed or selected by the person
installing the application.
9. Can the latest version of SQL server be used?
The customer / installer cannot choose the version. It is on the roadmap for FIS to update
the version used, but dates are unavailable at this time for this work.
The database installed does not permanently hold any important information – it only is
there to hold temporary data that we parse from the log to then have faster access and
fast query capabilities. If this explains to the client how it’s used and that it doesn’t hold
any permanent information.
10. Will this be upgraded to SQL 2019?
Yes, we are in the process of upgrading it to the latest version of SQL and will be available
soon.

How to set a delay in an Acquirer Testing in Response Profiles

1. Open Acquirer Switch project and Navigate to Test Preparation

2. Select the Test case (Response Profile) and click on ‘Send’
3. Please use the "Delay" command you can find on the toolbar. Select the message
to delay and click on the hourglass:

4. Once selected, this appears:

5. Once you add a delay you will see this in your test:

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide 15 Dec 2022 92
 Then the delay will take place when executed.

What is difference between Pause command and Delay option

Pause command in ‘Commands’

Delay option in toolbar

To understand the difference:

The Pause command pauses the test execution for the duration of the delay, while the Delay
option when sending messages does not, it puts the message to send on hold for the duration
of the delay but the test execution continues.
Typically Pause is used in non-sequential test cases, or if needed between operations to halt
execution.

How can we resolve, if facing issue with Simulator tool alignment or how to configure the
simulator application alignments correctly (right-handed to left-handed setting)

The example of incompatible configuration for Enhanced Simulator as is as below

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide 15 Dec 2022 93
Solution:

Try the following steps:

• Click WINDOWS button +R to pop up the run dialogue on windows

• Enter this text - %windir%\explorer.exe shell:::{80F3F1D5-FECA-45F3-BC32-
752C152E456E}

• A dialogue called "Tablet PC Settings" will appear.

• Observe the settings on the "Other" tab - does it appear as below with Right Handed
selected?

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide 15 Dec 2022 94
 • Select "Left Handed", Click "Apply" and try the application again.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide 15 Dec 2022 95
Notices
Following are policies pertaining to proprietary rights, trademarks, translations,
and details about the availability of additional information online.

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 document reflect the registration
status of Mastercard trademarks in the United States. Consult with the Global
Customer Service 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.

Disclaimer
Mastercard makes no representations or warranties of any kind, express or implied,
with respect to the contents of this document. Without limitation, Mastercard
specifically disclaims all representations and warranties with respect to this
document and any intellectual property rights subsisting therein or any part
thereof, including but not limited to any and all implied warranties of title, non-
infringement, or suitability for any purpose (whether or not Mastercard has been
advised, has reason to know, or is otherwise in fact aware of any information) or
achievement of any particular result.

Translation
A translation of any Mastercard manual, bulletin, release, or other Mastercard
document into a language other than English is intended solely as a convenience to
Mastercard customers. Mastercard provides any translated document to its
customers “AS IS” and makes no representations or warranties of any kind with
respect to the translated document, including, but not limited to, its accuracy or
reliability. In no event shall Mastercard be liable for any damages resulting from
reliance on any translated document. The English version of any Mastercard
document will take precedence over any translated version in any legal proceeding.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide 15 Dec 2022 96
 Information Available Online
Mastercard provides details about the standards used for this document, including
times expressed, language use, and contact information, on the Technical Resource
Center (TRC). Go to the Rules collection of the References section for centralized
information.

©2022 Mastercard. Proprietary. All rights reserved.

Enhanced Professional Simulator —Quick Start Guide 15 Dec 2022 97