CubeCart Installation & Setup

CubeCart Payment Module Setup

1. Download and install CubeCart.

CubeCart Website.

2. Download

Download the Payment Module ZIP file. The file can be downloaded here.

3. Unzip

Unzip the Payment Module archive to the CubeCart root directory.
The ZIP file retains the correct directory structure if unzipped to the above directory.
If you are manually uploading each file, the archive structure is as follows:

modules/gateway/MeS/form.inc.php . . . . . . . . . . Main payment module file.
modules/gateway/MeS/form.tpl . . . . . . . . . . . . Payment template file.
modules/gateway/MeS/transfer.inc.php . . . . . . . . Required functionality file.
modules/gateway/MeS/trident_gateway.inc. . . . . . . Gateway class file.
modules/gateway/MeS/admin/index.inc.php. . . . . . . Admin setup page.

4. Log in and Setup

1. Log in as an administrator.
2. From the administrator tabs, click on Payment Methods.
3. If properly extracted, "Merchant e-Solutions" will be listed. Click Configure.
4. Configure the Gateway as follows:
   1. Status - Leave enabled.
   2. Description - What the card holder sees when selecting a payment method. Generally "Credit Card" works well.
   3. Card Validation - Verifies the card is valid before requesting an authorization.
   4. Require CVV2 - Force the card holder to enter their 3 or 4 digit CVV2. It is safer to require the CVV, lowering fraud.
   5. Profile ID - This is a 20 digit merchant identifier issued by a sales representative, certification manager, or from a VAR form.
   6. Profile Key - This is a 32 character encoded pass key issued by a sales representative, certification manager, or from a VAR form.
   7. Transaction Type
      • Sale - Payments are authorized and captured right away. No further action is required for funding.
      • Pre-Authorization - In this mode a Pre-Authorization is performed and must be captured via the Payment Gateway Back Office.
   8. Test Mode
      • No - Only use this mode when you intend to take live orders. Authorizations in this mode will obtain live and valid authorizations.
      • Yes - Use this mode when testing and configuring the shopping cart. For specific instructions on using the simulator (approving sales, valid AVS and CVV codes) see the simulator testing section of the Payment Gateway specification.
   9. Default - Leave as yes for this gateway to automatically be selected.
   10. Debug - For testing gateway response. This is a developer tool, and should be left as no unless testing functionality.
   11. Click Edit Config to save.

5. Test

1. Purchase a product from your storefront, and proceed to checkout.
2. Complete the purchase, and verify you are sent to the checkout success screen. If you left Test Mode enabled, be sure the cart total is over $1.00, and set the CVV code to 123. Any credit card number may be used, but will not be charged as all transactions in this mode are simulated.

6. Verify

CubeCart 4.x separates the orders from the Payment Gateway transaction details. You may view the order from the order screen, however the gateway details are within the side heading "Transaction Logs".

1. From the admin tabs, click Transaction Logs.
2. Click on your order number to view the transaction details.
3. If the options are set to Pre-Authorization, the transaction ID must be copied and settled via the Payment Gateway Back Office when you are ready to be funded.

   Transaction Listing

7. Go Live

1. From the main admin tabs, click Payment Methods, then Configure next to the MeS module.
2. Change the Test Mode option from Yes to No.
3. Click Edit Config at the bottom to finish.
4. You may now attempt a live transaction.