Page tree

Versions Compared

Key

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

...

  1. Backup your database before starting the installation process.
  2. Log into the Aptify database server with an account that has administrative privileges.
  3. If you have not already done so, back up your Aptify database server.
  4. Close the Aptify desktop application on the database server, if currently running.
  5. Download the BluePay Payment Gateway Installer ZIP file to a folder on the database server and unzip its contents.

    Note

    When using low-end hardware, Aptify recommends running the installation program locally on the database server; do not run it over the network.

    Note

    The Windows API requires that fully qualified file names are less than 260 characters. Aptify recommends that the BluePay Payment Gateway Installer ZIP file is unzipped in a folder close to the drive's root folder (for example C:\Downloads) in order to limit the possibility of exceeding the character limitation for fully qualified file names imposed by the operating system.

  6. Browse to the location of the installation files, right-click the Setup application file, and select the Run As Administrator option to launch the BluePay Payment Gateway installation program.

    • On Windows Server 2008, the Run as Administrator option bypasses the server's User Access Control (UAC) for the duration of the installation.
  7. Enter login information for your database server. Specify an account with system administrator privileges to both the Aptify database and SQL Server. The user should also be tied to a Developer license to ensure that the setup can perform such tasks as entity creation when needed.

    Note

    Selecting the System Administrator option when creating a user in the Aptify database 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 through SQL Server. If in doubt, check the user's permissions in the Security > Logins area of SQL Management Studio before proceeding with the installation.

    Aptify 6.0 Setup LoginImage RemovedImage Added


  8. Review the Installation welcome screen, the Aptify BluePay component Installer automatically identifies the current version of Aptify and components installed on the database server and displays them on your system.

    Note

    If the component Installer does not identify the correct Aptify Version installed on your system, please contact your System Administrator.

    Image RemovedImage Added

  9. Click Finish to begin the installation process.

  10. Click OK once the installation has been completed successfully.
    Image RemovedImage Added
  11. Launch the 'Aptify Object Repository Synchronizer'.
  12. Browse and select the object cache folder to '<site direcotry>/wwwroot/AptifyServicesAPI/bin'.
    Image RemovedImage Added
  13. Select the 'Repository User' as a System Administrator user.
    Image RemovedImage Added

  14. Select the 'Select Objects for Synchronization' option.
    Image RemovedImage Added
  15. Click 'Next'.
  16. Select the 'ElectronicPayment.BluePay' object.
     Image RemovedImage Added
  17. Click 'Next'.
  18. Click to 'Finish' to update the electronic BluePay dll in the AptifyServicesAPI/bin folder.
  19. To update the BluePay DLLs  in the e-Business bin folder, do the following:
    1. Launch the 'Aptify Object Repository Synchronizer'.
    2. Browse and select the object cache folder to '<site direcotry>/wwwroot/Ebiz553/bin'.
      Image RemovedImage Added
    3. Select the 'Repository User' as a System Administrator user.
    4. Select the 'Specify Sync Repository Object Record' option and select 'Object name' as 'e-Business' from the drop-down list.
      Image RemovedImage Added
    5. Click 'Next'.

      Note

      The Synchronizer will identify the list of required dlls that need to be synchronized.

    6. Select the ElectronicPayment.BluePay' and 'Payments' objects.

      Image RemovedImage RemovedImage AddedImage Added
    7. Click 'Next'.
    8. Click to 'Finish' to update the electronic BluePay dlls in the  Ebiz553/bin folder.
  20. Stop and Start the Application Pool Services of Aptify application.
  21. Log in to Aptify Smart Client with administrative privileges.
  22. Navigate to 'Order Entry Administration' application.
  23. Open 'Merchant Accounts' service.
  24. Find the 'BluePay' merchant accounts record.
    Image RemovedImage Added
  25. Open the  'BluePay' merchant accounts record.
  26. Checkmark the 'Is Active?' checkbox to activate the 'BluePay' merchant account.

    Note

    Make sure you use one active merchant account for one payment type to be aware of which merchant account is in use.

    Image RemovedImage Added

    Info

    The fields related to the Fraud check within the Merchant Account record are not considered for BluePay Payment Gateway. The 'Fraud Check' based on the Velocity, Threshold, AVS/CVV, Card Issuing Country, and Negative Database (excluding IP) must be enabled through the BluePay account (Path: BluePay login>Home>Fraud>Overview).

    Image RemovedImage Added

  27. Navigate to 'Attributes' tab and include the below attribute values:
    1. GatewayLocation (for example:https://secure.bluepay.com/interfaces)

    2. Username (Account ID of the user BluePay account)
    3. Password (Secret Key of the user BluePay account. The Secret Key can be found in the  BluePay site>Admin>Accounts>List>Account Information)
    4. OperationMode (By default, the value is set to 'TEST' for testing transactions in Gateway. If the value is set to 'LIVE', a real transaction is processed by overriding the default settings.)
      Image RemovedImage Added
  28. Set the 'Currency Types' to 'US Dollar'.

    Image RemovedImage Added

     

    Note

    Aptify also supports multiple currency types for BluePay payment gateway. Make sure you create a new Merchant Record for each currency type.

    Image RemovedImage Added


  29. In the 'Payment Types' tab, add the required payment types.
    Image RemovedImage Added
  30. Save and close the record.
  31. Log out from Aptify Smart Client.
  32. Log into Aptify Smart client again and make sure all the changes carried out are shown.

...

Make sure you checkmark the 'Use Additional Parameters' checkbox to enable this functionality in the Aptify Merchant Account Record.

Image RemovedImage Added

Anchor
_testingbp
_testingbp
Testing BluePay Payment Gateway

...

Anchor
_kwnis
_kwnis
Known Issues

IssueWorkaround

In Aptify, if multiple payments are associated with an order, the total payment refund cannot be processed through Aptify Order Cancellation Wizard.

For example, if a $150 product has been purchased with three multiple payments ($50, $50 and $50)., the total amount ($150) on the order cannot be refunded through the Aptify Order Cancellation Wizard. The below error is also seen:

Image Removed

Image Added

If an order associated with multiple payments needs to be refunded, the recommended approach is to cancel the order with the "keep on account" option on the Aptify Order Cancellation Wizard and then use the Aptify Payment Refund Wizard to refund the payments.