- Published on Monday, 19 May 2014 02:25
BP-Sim is very easy to install, setup and run, however sometimes it might be a bit confusing to do so when seeing it for a first time. Assisting our clients with BP-Sim initial setup we have compiled this step-by-step guide to provide generic a assistance and answers related to all collected FAQ.
This article is to speed-up BP-Sim's basic configuration and demonstrate how first payment transaction can be send in less then five minutes.
Part 1 – Installation
No, we don't support Windows XP anymore. Microsoft announced the End-of-Life of Windows XP few years ago and majority of payments companies already migrated their systems away from this OS. The same we did on our side, taking an advantage of some advanced features which were not supported in Windows XP. If you are still running Windows XP, there might be an optionto use BP-Sim in some virtualized environment with some Windows OS successor, or with some live distribution based on the Debian Linux (e.g. Ubuntu, Mint …).
Windows installation is really straightforward. All you have to do is to confirm the license conditions, select your installation path (for the executables) and follow the installation wizard with clicking the “Next” button.
Part 2 – First run
Installation ended up successfully. Now open the Start menu and locate BP-Sim launcher. Double clicking on its icon with run BP-Sim Framework.
Part 3 – Transaction Header Settings
Seeing the BP-Sim Framework main screen in front of you, there is one single most important configuration step you have to do, to make the BP-Sim running. You need to tell which transaction network header will be used in your environment. As we do not have this information we cannot pre-configure this for you and BP-Sim comes with “None” setting by default. So check your interface documentation now and match your setting with one of following values:
- None – no transaction header is used
- 2B – length excluded – first two bytes contains the message length without the header length (length indicator). Most common header.
- 2B – length included – first two bytes contains the message length inclusive the header length
- 4B – type 1 – same as "2B – length excluded" followed by "00 00"
- 4B – type 2 - "00 00" followed by "2B – length excluded"
- 4B – type 3 – contains the length of the message in ASCII "%04d" with length indicatoe excluded
- 6B header – contains length of the message in ASCII "%05d" followed by the character 0x20 with length indicator excluded
Note that setting your network header with invalid value will result in parser failures on BP-Sim side as well as on the destination system's side. To set this setting navigate through the main tree view, open the Sources and/or Host nodes and change it on Interface tab under Transaction header.
After changing value to appropriate selection, click "Apply" button located in the upper right corner.
Part 4 – Address and Port
Second most important setting is the network connection. IP address (domain name) and port number tells a communication route to be opened. Ask your administrator for valid values and check if there are no network devices or restrictions between a server with BP-Sim installation and a destination. Make sure the endpoint is reachable and alive, you may find useful the Telnet application (part of the Windows) to check this.
To set Host address and port values navigate through the main tree view and open the Sources and/or Host nodes. Update appropriate values located on the Interface tab under Host address and Host port and click "Apply".
Part 5 – Configuration selection
All basic settings are set so we can continue with seting up the Source. In the Source control node in the main tree view see the Main tab. You have to pick up the defined Source (from Sources node).
There are three testing modes available:
- POS – basic payment device emulator
- Load Test – for performance tests
- Batches – for extended scripting and batch execution
Select the POS mode tab.
- Select the configured Terminal from Terminal list
- Select the message type from Formats
- Select the Card group from Cards list. Each Card can be assigned to a single group.
- Select the single Card from Cards list or select Random, which will take any randomly picked card regardless a group selected.
- Set up the transaction amount expressed in cents (e.g. 1 AUD = 100).
Click on the Start button.
In the log output window you see the basic statistics of the executed messages. Let's have a look on look on transaction details.
Part 6 – Transaction Query
In the main tree view click on the Transaction Query node.
Click on the Get data button.
In the table below you will see 10 last message records.
Double-clicking on any record will pop-up a message detail, parsed fields and binary message form.
Part 7 – Traces
Not enough? Open the main tree view node Traces. Select the folder named as the Transaction format you tested. There you can see the folder with Terminal name and Host. The Terminal holds the log from the terminal point of view and the Host from it's point.
Right after the timestamp you see that the Terminal XXX sending message to <ip_address>: (online delivery) followed by the parsed message and it's binary interpretation.
If Terminal receives response then you see also the timestamp of the received response message and Terminal XXX received message from <ip_address>: (online delivery) followed by the parsed message and it's binary interpretation.
Similary to the terminal, after the timestamp you see that there was Message receivedfrom <ip_address>: followed by the parsed message and it's binary interpretation.
And if the Host was able to respond you'll see the Message to <ip_address>: followed by the parsed message and it's binary interpretation.
And that's it! It didn't take more than five minutes, or?
Obviously there is a lot more to discover as:
- card settings
- terminal settings
Hope you enjoyed this brief introduction into the BP-Sim and this tiny tutorial will save you time when exploring all the interesting features of our products.
More about BP-Sim: show
Have a look at our BP-Sim flyer: get PDF