Page tree

Versions Compared

Key

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

The below page details down the step by step guide to deploy Bluepay Hosted Payment on classic e-Business 5.5.3 running on Aptify 6.1 or 6.2

Pre-requisites

The following prerequisites must be satisfied in order to install the Bluepay Remote Hosted Payment feature on classic e-Business 5.5.3 (CMS and NON CMS):

...

Info
titleInstruction

Before starting the installation, take a backup copy of your existing Aptify Db and classic e-Business 5.5.3 website + related SOA folder.

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

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

Note

Aptify 6.1 and 6.2 core setup installs the Bluepay Hosted Payment framework automatically with the setup and hence the below instructions are specific to additional steps needed other than the Bluepay Framework which is already installed by default.

Step 1: Create a new stores procedures spIsHostedPaymentActive

Info
Please refer Creating Database Objects topic for more information on how to create a new Database Object.
  1. Login as an administrator on the desktop application. Open a new record from the Database Objects service
  2. Enter the following details in each of the fields mentioned below:
    1. Name: spIsHostedPaymentActive
    2. Description: This Stored Procedure will check remote payment active OR de-active. SP will return 1, if Hosted Payment is active else returns 0. This stored procedure is used in e-Business.
    3. DB: Aptify (or Select the SQL Server database where the object is to reside in the DB field)
    4. Type: Stored Procedure
  3. Enter the SQL statements for the database object in the SQL tab.

    Code Block
    languagesql
    collapsetrue
    CREATE PROCEDURE spIsHostedPaymentActive
    AS
    BEGIN
                  SELECT Count(*) AS MerchantAccount
           FROM
           (
    SELECT DISTINCT  ma.ID
    FROM 
           	merchantaccount ma 
                  INNER JOIN merchantaccountpaytype mpt
                  INNER JOIN PaymentType pt
                  ON mpt.PaymentTypeID=pt.ID
                  ON ma.id = mpt.merchantid
                  INNER JOIN merchantaccountcurrencytype ct
                  ON ma.id = ct.merchantaccountid
    WHERE 
           		ma.isactive = 1 AND 
           		ma.UseHostedPaymentCheckout =1 AND
           		mpt.isactive = 1 AND
           		pt.IsRemotePayment=1 AND
           		pt.WebEnabled=1 AND
           		ct.isactive = 1 
                  ) As MerchantAccount
    
    END
    
    


  4. Click the Grant SQL tab and specify the user permissions as mentioned below:
    "GRANT EXECUTE ON spIsHostedPaymentActive To EndUsers"

Step 2 

Open the Utilities folder in the Aptify Setup and run the ‘Object Synchronizer’ Tool for the sync repository object as e-Business.

...

Note

We should not run the synchronizer for all the objects but only for ‘e-Business’. The below list of updated dll’s will be downloaded in the e-Business bin folder after the sync is completed successfully for e-Business sync repository object:

  1. ContributionPaymentObject.dll
  2. Pledge.dll
  3. StandingOrder.dll
  4. AptifyOrdersEntity.dll
  5. PaymentInfoObject.dll
  6. Payments.dll
  7. RemotePaymentEntityService.dll
  8. AptifyMarketplaceListingsEntity.dll
  9. ElectronicPayment.BluePay.dll
  10. AptifyPersonsEntity.dll
  11. RemotePayments.dll
  12. EBusinessShoppingCart.dll
  13. CompanyObject.dll
  14. PaymentInfoControl.dll

Step 3: Perform the below Config file changes

  1. Navigate to the e-Business installed folder and update the following in Aptify_UC_Navigation.config file. Please see the below screenshot for more details.

    Code Block
    collapsetrue
    <!-- Added for RemotePayment -->
        <UserControl type="RemotePayment" name="RemotePayment">
          <links>
             <!--Here we can add any links if required-->
          </links>
        </UserControl>
         <!--Added for RemotePaymentReciptControl -->
        <UserControl type="RemotePaymentReciptControl" name="RemotePaymentReciptControl">
           <links>
            <!--Here we can add any links if required-->
          </links>
        </UserControl>
  2. Open the web.config from the e-Business installed path and  add the below key:

    “ <add key="GenericErrorPageURL" value="SecurityErrorPage.aspx" />”

  3. Also update the web.config with a new Key to update the Remote payment URL . In the below example, replace the e-Business site URL with the actual site URL.

    <add key="Aptify.FrameWork.Payment.BluePay.RemoteUrl" value="<e-Business site-URL>/RemotePayment.aspx" />

    An Example:

    <add key="Aptify.FrameWork.Payment.BluePay.RemoteUrl" value="https://test-eBusiness.aptify.com/e-Business/RemotePayment.aspx" />

  4. Please note that the URL is case sensitive if you are building the page using CMS site. So mention the URL as it has been created in CMS site.
  5. Add below lines in web.config file as shown in the snapshot below:

    Code Block
    collapsetrue
    <security>
          		<requestFiltering>
            		<requestLimits maxAllowedContentLength="2147483648" maxQueryString="3500" />
         		 </requestFiltering>
    </security>

  6. Add below changes in the web.config file. Please refer the snapshot below. Save and close the Web.config file

    <httpRuntime maxRequestLength="32768"  maxQueryStringLength="3500" />


Step 4: Perform the below changes for User Controls

Please contact our Support Team for retrieving the updated classic e-Business User Controls with Bluepay Hosted Payment Changes that need to be run with Aptify 6.1 or Aptify 6.2

...