Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

This page will walk you through on how to install the set up changes for Aptify e-Business Bluepay hosted payment on e-Business 6.


The following prerequisites must be satisfied in order to install Aptify e-Business HPP successfully.

  • Aptify 6.1 is installed
  • E-Business 6.0 is installed.



  1. Before starting the installation, take a backup copy of your existing Aptify Db and e-Business 6 website + related SOA folder.
  2. Copy the setup folder to the destination server and make sure that ‘Read only’ property is unchecked for setup folder.
  3. After this setup installation is completed, please take necessary steps to merge the custom changes on the newly installed environment.

Install the Aptify e-Business Bluepay Hosted Payment Page (HPP)

To install Aptify e-Business Bluepay Hosted Payment Page (HPP), perform the following steps:

  1. Confirm that the database server is running Aptify 6.1. Please note that Aptify e-Business HPP is supported only on the Aptify 6.1 version.
  2. Identify the web server that will host Aptify e-Business HPP. It should be the same web server where e-Business was hosted originally. This server must meet the required hardware and software requirements: (see Server requirements for e-Business 6.0)


    For web servers that will be available on the public Internet, you must secure the site using HTTP over a Secure Socket Layer (SSL) to create an HTTPS site. The default installation of the Aptify site requires SSL. The site will not load successfully unless the site is configured to use SSL. For more information on how to secure the site will SSL, see Securing the Aptify Web Site Using SSL.

  3. Create a new domain account or identify an existing domain with a valid end user license account to use on the Aptify e-Business HPP web server. If you have Aptify Web installed on the Web server, then you can use the same SOA App Pool user for e-Business HPP and Aptify Web. For more information on how to create a user, see Creating User Accounts.

    • The SOA user must be a trusted user with a valid end user license (elevated permissions are not required) with the appropriate privileges to conduct the e-Business HPP activity. The SOA user should also be in the Users group.

    • The SOA user should also be added to the IIS_IUSRS group.

    • During the setup process, the SOA user is added to the AptifySOAAppPoolGroup. This group is only intended for the SOA user and ensure user tokens are secure.

  4. Log into the web server using an account with administrative privileges.


    It is highly recommended that the user account used for the SOA layer is not used to log into the Aptify web server.

  5. Take a backup of the originally installed e-Business 6 Website and SOA folder and delete the related e-Business site and the respective virtual folder. Please note that the setup will internally reinstall the core e-Business 6.0 website changes along with Bluepay HPP on running this setup.
  6. Download the Aptify e-Business HPP Installation ZIP file to a folder on the web server and unzip its contents.  
  7. Right-click the Setup application file, and select the Run As Administrator option to launch the installation program. 
  8. When prompted, enter login information for the database server, specifying an installation account with system administrator privileges to both the Aptify database and SQL Server. The installation user should also be tied to a Developer license to ensure that the setup can perform such tasks as entity creation when needed.


    Selecting the System Administrator option when creating a user in the Aptify database (through the Aptify User Administration wizard) sets the user to a dbowner in SQL Server. It does not add the user to the sysadmin role. You will need to manually add the user to the sysadmin role in SQL Server through SQL Management Studio. If in doubt, check the user's permissions in the Security > Logins area of SQL Management Studio before proceeding with the installation.

  9. Click OK to continue. On the Welcome page, review the set of requirements to install. If your environment does not meet one or more of the specified requirements, click Cancel to abort the installation.  See Server requirements for e-Business 6.0 for more information on the pre-requisites.

  10. On the Web services Details page, enter the Web services Installation information as detailed below:

  11. In the Website field, select the name under which the e-Business HPP site will be hosted. The recommended deployment for Aptify Web and e-Business HPP  is on separate servers or at least separate domains under different websites on the same web server.


    Default Website is selected by default for e-Business installation. However, you should host the e-Business website under another site and not on the same site where Aptify Web is installed.

    If Aptify Web has been installed on a different website other than the default, then e-Business HPP can be installed on the 'Default Website'. The new site must be manually created through the IIS Manager prior to running the e-Business website setup. A valid port should be assigned to the Website which will be different for Aptify Web as well as for e-Business site. For additional steps to be followed on Aptify Web 6.0 after the e-Business HPP installation, see Installation of Aptify Web 6.0 and e-Business 6.0 on same DB instance.

  12. In the Application Pool EbusinessWeb field, enter the application pool name to be used for the Aptify e-Business website.
    • The default application pool name is Aptify_EbusinessWeb
  13. In the Application Pool SOA field, enter the application pool name to be used for the Aptify e-Business SOA site.
    • The default application pool name is Aptify_EbusinessSOAWeb 
  14. In the SOA Pool User Name field, specify the trusted user account that you want to use as the SOA App Pool user for the Aptify e-Business website.
    • This is the user identified in Step 4.
  15. In the Password field, enter the password for this user.


    The setup program, at this step, is unable to validate the user credentials entered. Make sure that the username and password entered are correct.

  16. In the Website Location field, specify the location where the Aptify e-Business website files should be installed on the web server.
    • The default path is c:\inetpub\wwwroot.

    • For example, if you have selected  'Website' of a non-default path then the same path should be mentioned in the Website location as well. 

  17. In the Site Name field, enter the name of the website to be used in creating URLs.
    • It is not necessary to include the protocol prefix (https://) in the site name as Aptify appends it automatically.
    • This is the site name for the website that user will enter to browse this site. For example, enter, if users will browse to to connect to the server.
    • This field can be left blank, and the setup program uses the server hostname and domain name to create URLs.


      Additional configuration needs to be done to support the site name entered. Microsoft IIS must be updated with the new site name, and the host file at c:\windows\system 32\Drivers\etc\host must be updated to include the web server’s IP address and the site name.

  18. To install the e-Business Database server components, ensure that the Install Database Component option is selected.

    • This option installs the e-Business specific necessary entities and metadata on your database server.

    • While you can run the installer multiple times to create multiple Aptify sites that communicate with the same database server, you should only install the necessary entities and metadata on your database server once.

  19. To install only the Aptify e-business site, ensure that the Install Database Component option is cleared. This option is only applicable if you have previously installed the e-Business Database Components on the Aptify database server.

  20. Click Next to continue and review your installation options. The Installer automatically selects the options in the box(es) for the installation(s) not currently installed. 

  21. Click Finish to begin the installation process.
  22. Click OK when prompted that setup has been successfully installed to close the installer.
    • If a problem occurs during the installation, the Aptify Installer will notify you that an error occurred.
  23. Once Aptify e-Business HPP is installed successfully, check the bindings for the site in IIS. A site should be bound with HTTPS as per the screenshot below. A valid SSL certificate should be associated with the bindings.
  24. Restart the IIS service.
    • Although technically not required, restarting the IIS service will ensure that all existing sessions connected to the web server are terminated before the website is used.
    • You can restart the IIS service from either the Internet Information Service (IIS) Manager or from the Windows Services dialog.
  25. Now Connect to Aptify e-Business SOA to confirm that it loads correctly.
    You can access the e-Business SOA site by typing the below URL and confirm that SOA help displays correctly on the browser.
  26. Connect to the Aptify e-Business website to confirm that it loads properly using a supported web browser. 
    • You can access the e-Business site using the below URL where servername is the name of your web server and is your organization's domain:
      If e-Business is installed on Default Website, below would be the URL to access:
      If e-Business is installed on the non-Default Website, then find the port on which the non-default website is linked and below would be the URL to access:

Post Installation Configurations

This section provides the instructions to carry out Bluepay configurations to make sure that the e-Business HPP website works as expected.

Please refer the Installing e-Business 6.0 for the various post installation Configurations needed post e-Business install.

  1. Client Custom Configuration:
    In case if there are custom changes done on existing e-Business, merge the custom changes on the newly installed environment. Restart the IIS and browse the application.

  2. Bluepay Payment Hosting Configurations:

Please refer Setting up BluePay Hosted Payment Configurations for configuring Bluepay Hosted Payment Page.

Once the configurations are completed, restart the IIS and browse the e-Business 6 website. You will observe Bluepay Hosted Payment Option under the payment section. Click on the payment option will redirect the user to Bluepay Hosted payment page configured.

To get more information on Bluepay hosted Payment Page , please click here.