MPS Server Configuration

From RPOWERWiki

Jump to: navigation, search

The RPOWER Mercury Gateway allows RPOWER to use a single computer running a Microsoft IIS Web host to communicate with Mercury Payment Systems via Datacap Systems' DSIClientX interface. This is necessary, for example, to use the Mercury/Datacap Dial-Up Bridge for dial backup.

Even though it does not use SSL, the link between RPOWER and the Gateway is secured with even stronger encryption than that used by standard SSL. Setting up SSL on a local server like this, while theoretically possible, requires significant time and money both now and periodically in the future.

Contents

Set Up Folders and Download Installation Files

  1. Create a folder on the C: drive called \RPOWER.Central if it is not there already. Then, create an RPM subfolder in the C:\RPOWER.Central directory.
  2. From the Guest FTP, copy the contents of RPOWER Auxiliary Installation Files\RPM - RPOWER to Datacap Web Service\RPM into C:\RPOWER.Central\RPM.

Install DSIClientX

  1. Install the DSIClient component, DSIClient250-380-Install20071008.exe, found in C:\RPOWER.Central\RPM\DSIClient directory. Accept any defaults and restart the system.

Install & Configure the Mercury Dial Backup Bridge

  1. Install the Dial Backup Bridge component, IPDialBridge-Mercury422-Install20080617.exe found in C:\RPOWER.Central\RPM\MPS Dial Backup Bridge Installer. Accept any defaults and restart the system.
  2. Go to the Datacap MPSBridge License Request Web page to get the proper activation codes and licensing for your Datacap Dial Backup modem device. Be sure to copy the files sent by Datacap for licensing the Dialup Backup Bridge and follow the instructions to properly licensing the Bridge.
    1. Close any Datacap programs that are running.
    2. Copy or save attached license file received from Datacap to \Program files\Datacap Systems\IP Dial Bridge.
    3. Restart IP DIAL BRIDGE FOR MERCURY 4.24 and push Activate.
    4. Navigate to the Datacap Software Activation Request Web page and fill in the Datacap Software Activation Request form using the information (Serial Number, Session Code, Machine ID) listed in the Dial Bridge software.

      Note: If you do not have Internet access at this time you can call Datacap Systems at 215-997-8989 to get the Activation Code by phone.

      Be sure to complete the form with the proper information and submit with an email address you have access to. Once the form is submitted you should immediately receive an email (to the email address just provided) with the Activation Code for your Dialup Bridge. Once you receive the Activation Code enter it into the Enter Code field of the Dialup Bridge Software and push Activate.

  3. Configure the Dialup Bridge software by selecting Setup->Setup Information.
    • Set the Transport Section to IP with DIAL Backup.
    • Set the Merchant Category to Restaurant.
    • Set the Comm Port to the proper serial port the physical modem is attached to.
    • Leave all other settings as defaulted.
  4. Copy a shortcut for the IP Dialup Bridge For Mercury into the Windows Startup folder.

Configuring IIS

Navigate to Control Panel\Administrative Tools\Computer Management.

Open Services and Applications, then Internet Information Services, then Web Sites. Right-click Default Web Site and select New | Virtual Directory... You will be presented with the Virtual Directory Creation Wizard. Click Next.

  • Enter RPM under Alias. Click Next.
  • Under Directory, browse to C:\RPOWER.Central\RPM (or just copy and paste the text from here). Click Next.
  • Under Access Permissions, leave Read and Run scripts (such as ASP) checked (and the others unchecked). Click Next.
  • Click Finish.
  • (Server 2003 only) Under IIS, there is another item called Web Extension Services. Click this and navigate through the list of services until you get to ASP.NET. Click the Allow link. By default, Windows Server 2003 does not enable ASP.NET services. If you don't do this step, the RPOWER MPS Dial-Up Bridge will throw a 404 error.

Configuring the Virtual Directory

Under Default Web Site, right-click RPM and select Properties.

Virtual Directory tab

Push Configuration.... Make sure .aspx is in the list of extensions. If it is not, then .NET Framework was installed before IIS, not after. Cancel out of here and reinstall the .NET 3.5 Framework, choosing the Repair option. Then come back here.

Push Cancel to go back to Virtual Directory. Everything should be set up correctly, but to make sure:

  • Local Path: is C:\RPOWER.Central\RPM.
  • Read, Log visits, and Index this resource are checked.
  • Application Name is RPM.
  • Execute Permissions is Scripts Only.
  • Application Pool is Medium (Pooled) /Server 2003 may have DefaultAppPool..

ASP.NET tab

Click on the ASP.NET tab. Make sure the ASP.NET version: is set to 2.0.50727.

Testing the Virtual Directory Installation

The easiest way to test the installation is to open a web browser and navigate to http://localhost/rpm/RPM.asmx. After 15-30 seconds you should see a webpage with the word DeepSICXService inside a blue banner.

Setting up User Permissions (Windows XP, 2003 Server)

(Windows XP Only) Open Windows Explorer and select Tools, Folder Options. Select the View tab, scroll to the bottom of the Advanced Setting window and deselect Simple File Sharing.

If you do not have a Security tab, your drive may formatted with FAT-32, not NTFS. If that is the case, skip the next paragraph.

(Windows XP and Server 2003) Navigate to C:\RPOWER.Central, right-click it, and select Properties. Select the Security tab. In the Group or user names: listbox, look for Everyone. If it does not appear, push Add..., type Everyone into the Enter the object names to select box, and push OK. Make sure Everyone is highlighted and check the Allow checkbox to the right of Full Control. Then push OK at the bottom.

Configuring service.ini

Navigate back to C:\RPOWER.Central\RPM. Inside that directory you will find a service.ini file. In that file:

Change only the Pepper line to equal the RPOWER site serial number (the first four digits of the "site code").

Example Service.ini file:

[Preferences]
;local LAN dialup bridge
MercCreditHosts=localhost ; name of the local computer
MercGiftHosts=localhost

;development servers
; MercCreditHosts=x1.mercurydev.net
; MercGiftHosts=g1.mercurypay.com|g2.backuppay.com

;production servers
; MercCreditHosts=x1.mercurypay.com|b2backuppay.com
; MercGiftHosts=g1.mercurypay.com|g2.backuppay.com

MercProcessControl=1
WriteReqResp=0 ; Set to 1 to log each request
Pepper=826 ; RPOWER serial number

Configuring credcnx.ini

Check the settings in the credcnx.ini (created by RPOWER) in F:\RPOWER\Winrun\INI to reflect the example below.

Example credcnx.ini utilizing the Mercury Dial back-up Bridge:

[Network VISA/MC]
Provider=MPS

[Network AMEX]
Provider=MPS

[Provider MPS]

HostIP=FILESVR:80 ; Where FILESVR is name of the hosting computer for the MPS Dialup-Backup Bridge
HostTarget=/RPM/RPM.asmx
HostHTTPS=0
DeepSICX=1
HostTimeout=30 ; dialup

; Site Name
MerchantID=AAFAC7E5EA94C7C4E245C7C4RTFGC6DA91E1A7BF81F8DEC6E29CC2CF9CE9A4D7

Testing a Transaction Using the Dial Backup Bridge

  1. Ensure the settings for the Service.INI file and the Credcnx.INI file are correct.
  2. Ensure the Dial Backup Bridge software is running.
  3. Startup RPOWER - Enter Manager Functions, Enter Miscellaneous Credit Card, Select Sale.
    1. In the Misc Charge Sale window, enter 1 for the Check Number and 1 for the Clerk ID. Using a keyboard with the cursor in the Card Number field, type ;40 in rapid succession to "swipe" the test Visa card number into the field, this will also fill in the Name/Comment field (or copy the number from this picture into the Card Number field). Enter a dollar amount of 1.00. Select Send. You should get back an INVLD_ACCT error.
    2. In the Misc Charge Sale window, enter 1 for the Check Number and 1 for the Clerk ID. Using a keyboard with the cursor in the Card Number field, type ;54 in rapid succession to "swipe" the test Visa card number into the field, this will also fill in the Name/Comment field (or copy the number from this picture into the Card Number field). Enter a dollar amount of 1.00. Select Send. You should get back a No test cards on live acct error.
    3. If you do the same with a live card, you should get a VALID SUCCESSFUL message back. Any other response means something is WRONG. Go back through the configuration settings to ensure everything is correct and attempt a transaction again. If need be, contact RPOWER directly for support help.
    4. After a successful test, simulate the Internet going down by unplugging the network cable between the network Router and DSL/Cable/T1 Modem (do NOT unplug the network cable from the workstation this will cause the IIS component to the Dialup Backup Bridge to fail and not allow you to properly simulate the Internet going down). Repeat Step 3, this time you should hear the modem dial out and still receive the response of PICUP. Any other response, something is WRONG, possibly the proper COM port setting on the Dial Backup Bridge Software. Go back through the configuration settings to ensure everything is correct and attempt a transaction again. If need be, contact RPOWER directly for support help.
  4. Congratulations on successfully installing the MPS Dial Backup Bridge. Please contact RPOWER directly if there are any additional questions regarding this installation.
Views
Personal tools