Installation of BluePay Payment Gateway

This topic contains the following sub-topics:

• Installation Procedure
• Default Parameters of BluePay
• Additional Parameters of BluePay
• Testing BluePay Payment Gateway
• Known Issues

 Installation Procedure

The following instructions provide a step-by-step guide for the installation of BluePay Payment Gateway component.

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.

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

   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.

   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.

   

   
   

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.

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

   

9. Click Finish to begin the installation process.

10. Click OK once the installation has been completed successfully.
    
11. Launch the 'Aptify Object Repository Synchronizer'.
12. Browse and select the object cache folder to '<site direcotry>/wwwroot/AptifyServicesAPI/bin'.
    

13. Select the 'Repository User' as a System Administrator user.
    
    
    

14. Select the 'Select Objects for Synchronization' option.
    
15. Click 'Next'.
16. Select the 'ElectronicPayment.BluePay' object.
     
    
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'.
       
    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.
       

    5. Click 'Next'.

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

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

       
    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.
    
25. Open the  'BluePay' merchant accounts record.

26. Checkmark the 'Is Active?' checkbox to activate the 'BluePay' merchant account.

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

    

    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).

    

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.)
       

28. Set the 'Currency Types' to 'US Dollar'.

    

     

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

    

    
    

29. In the 'Payment Types' tab, add the required payment types.
    
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.
    
    

Default Parameters of BluePay

The following are the default parameters sent by Aptify to BluePay while processing a payment (Auth/Sale):

1. MERCHANT

2. MODE

3. TRANSACTION_TYPE

4. TAMPER_PROOF_SEAL

5.  NAME1

6. NAME2

7. COMPANY_NAME (only for company Orders)

8. IS_CORPORATE (only for company Orders)

9. AMOUNT

10. ADDR1

11. ADDR2

12. CITY

13. STATE

14. ZIPCODE

15. RRNO
16. ORDER_ID (While tokenization of an order, the order ID value is associated with the transaction ID value.)
17. TPS_HASH_TYPE
18. RESPONSEVERSION
19. ACH_ROUTING
20. ACH_ACCOUNT
21. ACH_ACCOUNT_TYPE
    
    

Aditional Parameters of BluePay

The BluePay also provides the user with an ability to add the additional parameters to the default request which is sent while processing an order. If you wish to add any additional parameters other than mentioned in the Default Parameters in BluePay, see https://www.bluepay.com/sites/default/files/documentation/BluePay_bp10emu/BluePay%201-0%20Emulator.txt

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

Testing BluePay Payment Gateway

• Transactions are approved where the dollar amount is odd (e.g., $11 or $13.20)
• Transactions are declined where the dollar amount is even (e.g., $10 or $20.11)

To simulate a CVV check, you must use the Address Line 2 (ADDR2 field) - When a transaction is processed with MODE=TEST if the first character of ADDR2 (in the transaction request) is one of the possible CVV2 response codes, that value will be returned as the CVV2 response value.
 
_ = Unsupported on this network or transaction type
M = CVV2 Match
N = CVV2 did not match
P = CVV2 was not processed
S = CVV2 exists but was not input
U = Card issuer does not provide CVV2 service
X = No response from association 

Known Issues