MiParc Payment Portal – Installation & Setup



 Table of Contents

Introduction


This document describes how to install and set up the MiParc Payment Portal for iParc Pro+ PARCS sites

The MiParc Payment Portal is an outward-facing, internet-based web service and user account portal. It enables parking patrons with monthly contracts to remotely access, review and update their parking account information using a standard web browser.

Once a MiParc User Account is created, the account-holder can securely login to their MiParc Payment Portal account to pay monthly parking fees using a credit card (or using a Credit-Card-on-File for auto-recharge accounts). MiParc end-users can transfer funds into their debit accounts, change the method of payment, review charges and credit balances, and more.

The MiParc Payment Portal also allows site administrators and facility managers to remotely control and maintain patron access to parking facilities, to review revenue features, and to generate reports, using a standard web browser.

The different types of MiParc Payment Portal account access (e.g., ADMINISTRATOR, FACILITY MANAGER, USER, GROUP USER) is controlled by the access rights and credentials granted when the MiParc User Account is created.

Prerequisites


Before the MiParc Payment Portal can be successfully installed and set up, the following prerequisites must be in place: 

  • iParc Pro+ PARCS application server installed running Windows Server 2012 R2 or later
  • OPUSCharge UI application software installed on the site application server
  • SQL server with database running in Windows Server 2012 R2 or later
  • The site administrator's intended username and password (for creating new SA credentials)
  • If required, the filename and pathname of any 3rd Party SSL Certificate to be used
  • MiParc contract patrons must be currently enrolled in the iParc Professional Card Access system

MiParc Payment Portal – Home Page.

Install the MiParc Application Software


Important!

Make sure that the version of MiParc Application Software that you plan to install matches the version of iParc Pro+ Application Software that you are currently using (e.g., Greece 10). Running mismatched versions of MiParc and Pro+ application software can cause operating errors and other technical problems

To install the MiParc Application Software, perform the following steps:

  1. On the application server (or web server), navigate to the > Premium Features > MiParc folder on the Install CD.

MiParc Payment Portal – Install Application Software.


2. Double-click on the installation filename AMI.MiParc.Setup.msi to launch it. The Setup Wizard installation screen is displayed. Click Next.

MiParc Payment Portal – Setup Wizard screen.


3. The End User License Agreement (EULA) dialog screen is displayed. Click the checkbox to accept the terms and provide the site administrator with a printed copy (if desired). Click Next.

MiParc Payment Portal – EULA screen.


4. The Site Information screen is displayed. Type in the Site name:. Click Next.

MiParc Payment Portal – Site Information screen.


5. The Destination Folder screen is displayed. This is the folder where the MiParc Application Software will be installed. Either accept the default pathname (C://AmanoMcGann/MiParc/) or browse to a different location. Click Next.

MiParc Payment Portal – Destination Folder screen.


6. The SQL Server Information screen is displayed. Type in the Server Name:. Uncheck the Windows Authentication checkbox. Enter the site administrator's User name: and Password:. Click Next.

AMI Tip!

Disable Windows Authentication to prevent potential rights conflicts while you configure the MiParc Application Software.

MiParc Payment Portal – SQL Server Information screen.


7. The MiParc Installation splash screen is displayed. Click Install.

MiParc Payment Portal – MiParc Installation screen.


8. The MiParc Application Software files are installed in the Destination Folder that you selected in Step 5. When installation of the files is complete, a notification message box appears. Click Finish.

MiParc Payment Portal – Installation Complete screen.

How to Install and Bind a 3rd-Party SSL Certificate


Some sites require that the MiParc server use a 3rd-Party SSL Certificate to perform transactions with the OPUSCharge UI. The 3rd-Party SSL Certificate and access to it must be provided by the site administrator or IT department.

Note:

The site’s IT Staff may have completed some or all of the required tasks before you install the MiParc Application Software. Check with the site administrator.

Requirements

  • A Public IP address. While this can be a static IP address or a dynamic IP address, AMI recommends using a static IP address:

– The IP address doesn't change, which prevents temporary disconnects and intermittent suspension of service.

– Configuration of firewall access rules for IT staff is simpler.

Note:

AMI recommends as a best practice using the format shown here for the Public Host Name. However, site management can use any Public Host Name they prefer without loss of function.

  • A digitally-signed 3rd Party SSL Certificate for the Public Host Name.

Note:

The 3rd Party SSL Certificate must match the Public Host Name. If the Public Host Name is hostname.domain.com, the 3rd Party SSL Certificate must be for hostname.domain.com or *.domain.com.

  • Site Administrator / IT Staff requirements:

– Access to the site’s DNS server and ability to create DNS entries.

– Access to the site’s firewall and ability to create firewall access control rules.

Process

Installing and binding a 3rd-Party SSL Certificate on the MiParc server consists of four steps:

  • Install the 3rd-Party SSL Certificate.
  • Bind the 3rd-Party SSL Certificate to Port 443.
  • IT Staff – Create DNS entries in both the local and public DNS servers to link the Public Domain Name to the appropriate IP addresses.
  • IT Staff – Create the firewall access control rules to translate the public IP address to the MiParc server IP address.




Install the 3rd-Party SSL Certificate

To install a 3rd-Party SSL Certificate, perform the following steps:

Note:

To perform the procedure below, the site's IT department must make available the pathname and filename to the signed 3rd-party certificate, as well as provide access rights to install and bind the certificate to the MiParc server.

1. Launch the Windows Server Manager and select Internet Information Services (IIS) Manager from the Tools drop-down menu (or click Start, type 'IIS' and press Enter).

2. In the IIS Manager window, double-click on the MiParc server name and open the Home folder.

3. Click on the Server Certificates icon. This will be located either in the IIS section, or in the Security section, depending on how the client site groups the icons.

4. In the Actions menu, click Complete Certificate Request… to open the Complete Certificate Request screen.

5. In the text box provided, enter the pathname to the 3rd-Party SSL Certificate, as provided by the site administrator.

6. Type in the Friendly name: for the certificate in the text box. The Friendly name: is not part of the certificate, but is used to identify the certificate in the certificate list.

AMI Tip!

The Friendly name: allows the client to quickly identify an individual certificate from a list of certificates. AMI recommends a Friendly name: format of domain.expiry_date to help distinguish the certificate and its expiration date later on. However, those elements are not required and the client may specify any Friendly name: they prefer.

7. Use the drop-list to select the certificate store for the 3rd-Party SSL Certificate, as provided by the site administrator.

8. Once the information has been entered correctly, click OK to install the 3rd-Party SSL Certificate.

Note: Leave IIS Manager open to complete the binding process, as described below.

MiParc Payment Portal – SSL Certificate Installation screen.



Bind the 3rd-Party SSL Certificate

To bind a 3rd-Party SSL Certificate, perform the following steps:

Note: the 3rd-Party SSL Certificate must be bound to Port 443 for successful transactions with the OPUSCharge UI service.

1. In IIS Manager, expand the Sites connection.

2. Right-click on the Default Web Site for the MiParc server.

3. Click Edit Bindings… in the Actions window.

MiParc Payment Portal – Edit Certificate Bindings.

4. The Site Bindings window is displayed with a list of current bindings. For new installations with no current certifications, no bindings are shown. Click Add to add a new binding.

5. The Add Site Binding window is displayed.

6. In the Type drop-list, select https.

7. In the SSL certificate drop-list, select the 3rd-Party SSL Certificate you created in the previous section.

8. Click OK.

9. Click Close in the Site Bindings window.

MiParc Payment Portal – Site Bindings window.

MiParc Payment Portal – Add Site Binding window.

Create DNS Entries (Site Admin)

After the 3rd-Party SSL Certificate is installed and bound, the site administrator or IT staff will need to create a DNS entries on both the local and public DNS servers, as follows:

  • A DNS entry on the local DNS server that resolves the public Host Name (e.g., hostname.domain.com) to the local IP address of the MiParc server.
  • A DNS entry on the public DNS server that resolves the public Host Name (e.g., hostname.domain.com) to the public IP address.

Note:

The site administrator or IT staff may need to create a Network Address Translation (NAT) rule on the site’s firewall to redirect incoming connections to the right IP address.

Once the foregoing procedure is complete, proceed to the section below to activate and configure the MiParc Payment Portal.


Initial Login and Software Activation


Initial Login

Login the first time using the Windows Server login username and password.

AMI Tip!

The MiParc Payment Portal default login credentials may be the default Windows Server login credentials provided by AMI, or new credentials may have been created when the iParc Pro+ PARCS Software was installed.

1. Launch an up-to-date web browser and navigate to the /MiParc folder on the application server (e.g., https://[AppServer]/MiParc/Security/Logon). The MiParc Logon screen is displayed.

MiParc Payment Portal – Logon screen.


2. For the initial log-in:

  • User Name – use the AMI default Windows Server username, or the username created when the iParc Professional Pro+ software was installed.
  • Password – use the AMI default Windows Server password or the password created when the iParc Professional Pro+ software was installed.

The MiParc Home screen appears.

MiParc Payment Portal – Admin Home screen.


Activate the MiParc Software

Before you can configure the MiParc Payment Portal or set up MiParc user accounts, you must activate the application software.

1. Click the About tab as shown in the image above. The About MiParc information screen is displayed.

2. In the provided fields, enter the License ID and any other required site information, as provided by the site administrator.

3. Click the Activate button to activate the MiParc Payment Portal application software.

4. Once the MiParc Payment Portal application software is successfully activated, click on the Home tab to return to the Home screen.

MiParc Payment Portal – About MiParc screen.


To Create a New Site Administrator Account

Important!

Initial login to the MiParc Application Software is performed using the Windows Server or Pro+ username and password. However, to avoid rights violations and conflicts, all subsequent administrative actions must be done using the site administrator's credentials.

To set up the site administrator username and password, perform the following steps:

  1. In the MiParc Home screen, click on the Users tab. The Registered Users screen appears. Click on Add User.

MiParc Payment Portal – Registered Users screen.


2. The Add User set-up form is displayed. 

3. In the fields provided, type in the user information as provided by the site administrator and described below:

  • User Type – select Administrator (default selection)) for the user type
  • Email address – type in the MiParc host email address the site administrator plans to use for MiParc operations
  • User Name – type in the MiParc username the site administrator plans to use for MiParc operations
  • Password – type in the site administrator's password
  • Confirm password – re-enter the site administrator's password to confirm

4. Click Add to create the new site administrator account.

Creating a new account for the site administrator is now complete. Log out of MiParc and login again as the site administrator to configure the MiParc application settings, as described below.

MiParc Payment Portal – Add User setup form.


To Change the Site Administrator Password

1. Login to MiParc using the site administrator username and password.

2. Click on the Site Administrator username hotlink shown at the upper-right.

MiParc Payment Portal – Site Administrator hotlink.


3. The Profile screen for the site administrator (current user) is displayed. Enter the MiParc account email address for the site administrator. It must be the same as used in the previous section. Click on Change Password.

MiParc Payment Portal – User Profile screen.


4. The Profile password change form is displayed. Type in the Current password and the New password. Re-enter the new password in the Confirm new password field. Click on Change Password to confirm the change.

The site administrator password change is now complete.

MiParc Payment Portal – Change Password form.

Configure the MiParc Application Settings


The Settings tab allows you to set up or make changes to the MiParc Payment Portal's online appearance, contact information, and email message settings.

AMI Tip!

Note that the name of the currently selected site appears in the Site Name field at the top of the Settings screen, regardless of which tab is open.

General Site Settings

1. Click on the Settings tab. The Settings | Manage Site Settings screen is displayed and defaults to the |General| sub-menu tab. A general settings configuration is displayed.

The |General| sub-menu contains general information for the current site, including management options for what is displayed on customer-facing screens as seen by MiParc end-users when they log onto the system. Fields can be completed, viewed, or edited from this tab.

2. In the fields provided, type in the general site settings information, as provided by the site administrator and described below:

  • The Site Name appears on the receipt that is generated when an account-holder makes a monthly payment or transfers funds to a debit account.
  • The Welcome Text appears on the MiParc end-user's welcome screen when they login.
  • The information entered into the Address, City, Country, State/Province, Postal Code, Phone, Help, Fax and Email fields is the Site Management's contact information provided on the Contact Us screen.
  • The Site Icon image is shown in the browser tab of the MiParc Payment Portal window. The default image is the AMI logo (ipp.ico). A custom site icon provided by the site administrator can be configured for the site.
  • The Site Logo image is shown in the banner at the top of the screen in the MiParc Payment Portal window. The default image is the AMI Pro+ logo (prologo.png). A custom site logo provided by the site administrator can be configured for the site.

MiParc Payment Portal – Manage Site Settings screen.


Important!

To be visible on customer-facing web-pages, the Site Icon and Site Logo images must be saved to the folder C:\AmanoMcGann\MiParc\Images. Be aware that using an oversized image will distort the appearance of the customer's web-pages. Inform the site administrator that custom images should match the size and resolution of the original images.

  • The Verification Error Text appears on the MiParc end-user's home screen when a patron who attempts to register with an existing account fails to provide the correct account number and last name.
  • The Email field is the default primary email address to be used by the current site.
  • The EV Form Link is the URL address of an online Electric Vehicle Registration Form. The online form enables a patron who owns an electric vehicle (EV) to register it with the state for tax credits, rebates, and/or discounted parking fees. The EV Form Link URL address supports a Live Data Tag used to set up custom messages to MiParc account registration applicants, as described below in Setup Custom Account Status Messages for MiParc End Users.

3. When you have completed entering the general settings fields, click Save.

The general settings configuration is now complete.

MiParc Payment Portal – Site Icon & Site Logo filenames.


MiParc / OPUSCharge Credit Card Service Settings

Use the |Credit Card| sub-menu tab to set up credit card processing services using OPUSCharge UI.

1. Click on the Credit Card sub-tab. The credit card service settings sub-screen appears.

2. In the fields provided, enter the credit card service configuration information as provided by the site administrator and described below:

  • The Client GUID field is the 128-bit Globally Unique Identifier that uniquely identifies the MiParc Payment Portal to OPUSCharge UI as an API web client. A default GUID is auto-generated by the MiParc Payment Portal application software. A custom Client GUID provided by the site administrator can be configured for the site.
  • The Remote Address field is the URL address to the OPUSCharge UI server (i.e., the web address to the application server where OPUSCharge UI resides).

MiParc Payment Portal – Credit Card Settings screen.


3. Use the default Client GUID string provided, or enter a custom GUID. Be sure to enter the custom GUID exactly as it is provided, without any errors.

4. Type in the Remote Address URL to the OPUSCharge UI server.

           IMPORTANT: Be sure to include →  /api ← at the end of the URL address string or the API calls to the OPUSCharge UI server will fail.

5. Click Save. A Save Settings information box appears. Click OK.

6. Click the Test button to ping the OPUSCharge UI server. If the URL is valid and the OPUSCharge UI server is active and online, a Remote Address Test splash screen is displayed that confirms success.

MiParc Payment Portal – Remote Address Test splash screen.


7. Click on the Register button to register the MiParc Payment Portal as a web client of the OPUSCharge UI server. The Registration Successful splash screen is displayed.

The MiParc Payment Portal is now configured to enable end-users to securely use their credit card information to make payments from their MiParc accounts via OPUSCharge UI.

MiParc Payment Portal – Registration Successful splash screen.


Host Email Service Settings

1. Click on the |Email| sub-menu tab. The emails settings sub-screen appears.

2. In the fields provided, type in the host email configuration settings as provided by the site administrator and described below:

  • The Host Email Address is the main email address for the site. Using this address, the MiParc Payment Portal application software generates notification, status and auto-response email messages from the MiParc Payment Portal to account-holders.
  • The UserID is the username for the MiParc host email account. This is the descriptive name that appears in the Sender: address line of an email.
  • Type in a Password to limit access to the host email account to password holders.
  • Click the Login Required? checkbox to require login access to the host email account.
  • Enter the Port number. The default email port for non-encrypted, outgoing email messages using the SMTP protocol is 25.
  • Enter the email Server URL address. The MiParc host email account uses SMTP protocol, so the email server URL is smtp.[servername].com.
  • Click on the Use SSL? checkbox to use Secure Socket Layer protection.

The MiParc host email service is now configured to enable email communication with MiParc account-holders.

MiParc Payment Portal – Email Settings screen.


End-user Contract Payment Types

1. Click on the |Payments| sub-tab. The Settings sub-screen is displayed.

2. The payment settings control the payment options offered to MiParc end-users. If both checkboxes are checked, then both types of payment options – Contract Payment and Debit Payment – appear in the Payments drop-list in the MiParc end-user's interface (see second image at right). If only one checkbox is selected, then only that option is offered to the end-user. For more detailed information, refer to the MiParc Payment Portal – Operators Manual.

3. Choose the payment options that will be offered to MiParc end-users, as determined by the site administrator and described below:

  • The Contract Payment checkbox selects Contract Payment as an option for MiParc end-users. This option provides for contract payment with or without a credit card.
  • The Debit Payment checkbox selects Debit Payment as an option for MiParc end-users. This option provides for debit payment with or without a credit card.

The MiParc payment options are now configured for MiParc end-users.

The MiParc Payment Portal configuration settings are now complete.

MiParc Payment Portal – Payments Settings screen.

MiParc Payment Portal – Payments Drop-list screen.

Setup Custom Account Status Messages for MiParc End Users


The MiParc Payment Portal enables site administrators to create and manage custom email messages for selected sites based on provided templates. Templates include automatic text options for user approval, rejection, and wait-list emails.

To create or edit auto-response account status message email templates for use when approving, rejecting, or wait-listing customers, follow the procedure below.

1. On the MiParc homepage, click on the Messaging tab. The Messaging Email Templates screen is displayed.

2. In the Facility Structures selection bar, click on the desired facility group to expand it. The facilities assigned to that facility group are displayed. If any existing template text exists, it will also be displayed in the Edit [account status] Message pane.

  • If the message email template should apply to the entire facility group, leave the facility group selected.
  • To create or edit a message for a specific facility within the group, click again to select the appropriate facility. If any existing template text exists, it will also be displayed in the Edit [account status] Message pane.

3. Select the type of auto-response account status message template to create or edit by clicking on the appropriate tab. Tab options include:

  • Approve Account: The text in this email message template is automatically sent to a MiParc end-user who has applied for a registered account and been approved.
  • Reject Account: The text in this email message template is automatically sent to a MiParc end-user who has applied for a registered account and been rejected.
  • Waiting List: The text in this message email template is automatically sent to a MiParc end-user who has applied for a registered account and been assigned to a waiting list while further action is undertaken.

4. Click on the tab for the account status message you intend to create or edit.

5. In the Edit [account status] Message pane, enter or edit the message text. Use the Live Data Tags on the right to automatically generate text that personalizes the account status message for a specific MiParc end-user. Live Data Tags are used to create tags in the template text that will autofill with the correct text based on the user's account information the type of tag chosen.

6. To add Live Data Tags to the message, place the cursor in the location where you want the tag inserted. Then click on the button corresponding to the text you want entered. Options include:

  • First Name: This tag automatically populates the user’s first name in the selected location in the template text.
  • Last Name: This tag automatically populates the user’s last name in the selected location in the template text.
  • Facility Name: This tag automatically populates the currently selected facility name in the chosen location in the template text.
  • Application Link: This tag automatically populates an hot-link in the chosen location in the template text to a state government website where an Electronic Vehicle (EV) Registration Form can be accessed and filled-out by MiParc end user.

             Note: Adding the Application Link to an auto-response account status message is only appropriate for approval messages.

7. Click on Save to save changes to the message email template and place it into use. Or click on Reset to restore the pane to the last saved setting and reject all interim changes.

MiParc Payment Portal – Messaging Email Templates screen.