Introduction
The files included in this pack are designed to integrate the PaymentSense Gateway with ZenCart. This will enable you to connect your shopping cart to the PaymentSense gateway quickly and effectively.
NOTE: You must have installed ZenCart before working through the integration document.
Integration
NOTE: Using FTP, by uploading the two folders 'admin' and 'includes' to your ZenCart ROOT directory this will automatically place the files into the correct file path. ***YOU MAY NEED TO CHANGE THE NAME OF THE 'admin' FOLDER in the PaymentSense module to 'zc_admin' so the admin folder matches that which is in the ZenCart ROOT directory.***
You can check this by navigating from the root directory. Follow the below paths to test if the above folders are in the correct path locations.
- Firstly, The 'PaymentSense_database_tables.php' file path should read \ZenCart\admin\includes\extra_datafiles\
- Secondly, The 'tpl_PaymentSense_callback_default.php' file path should read \ZenCart\includes\templates\template_default\templates\
- Thirdly, The 'Common.php' file path should read \ZenCart\includes\modules\payment\paymentsense_redirect\
Once the files are in the correct place open the ZenCart admin section in your Web Browser
Enable and Configure the PaymentSense Gateway
NOTE: All Gateway configurations are carried out from within the admin section of your ZenCart account.
On the navigation bar select Modules -> Payment
Locate PaymentSense from the list it should have a red circle icon; this means that the paymentsense payment option is not installed and is therefore disabled. Click PaymentSense to bring up a side bar that will have the option 'install'
Click on Install' this will open a new sidebar and the circle icon should now have changed colour to orange, this means that PaymentSense payment option is installed but not enabled.
NOTE: make sure you have the GATEWAY MerchantID and Password NOT THE LOGIN DETAILS FOR THE MERCHANT MANAGEMENT SYSTEM.
Via the right-hand panel within the ZenCart 'Payment Modules' page
- Enable the PaymentSense Module by selecting True
- Enter the Merchants Gateway ID
- Enter the Merchants Gateway Password
- Enter your PreSharedKey
- Select your transaction currency
- Select the default order status that you want your customers to see in their account after they place an order
- Set the Display order
- Set the text that you want to be displayed to the customer when they are selecting the payment method.
- Click on update
The circle icon should now have changed colour to green, this means that PaymentSense is now enabled as a payment method.
Merchant Environment Design Section
NOTE: This section includes the file that the developer needs to configure in order to adapt the page to the merchants' environment. This section cannot be generalised.
The Developer needs to work their way through the file 'serverresult.php' in order to get the hosted payment page to redirect after the transaction has been processed.
This file is located at the path '\ZenCart\includes\modules\payment\PaymentSense\'
NOTE: If this file is not implemented then a default confirmation screen will be displayed to the customer.