Zen Cart

Zen Cart Payment Module Tutorial

Before starting this tutorial, please ensure that you have the most current version of the USAePay Zen Cart payment module uploaded to your Zen Cart payment modules directory. Our current version is: 2.0 and was updated: 05/27/2009.

  1. Using your favorite web browser, pull up the administration page of your Zen Cart shopping cart. It will look something like the image below:

  1. Point your cursor to the link titled “Modules” and click on “Payment”:

  1. At the bottom of the “Payment Modules” list click on USAePay. The payment module should appear on the right side of the screen. If you do not see it, double-check to make sure that the files were uploaded correctly.

  1. Click on the “Edit” button:

  1. Module Setup
    1. Enable USA ePay Module Do you want to accept USA ePay credit card payments?
      1. Select “True”
    2. USA ePay Source Key Please enter your USA ePay Source Key
      1. Input your source key generated from your USAePay merchant console
    3. USA ePay Source PIN Enter a pin, if applicable
    4. Transaction Mode Transaction mode used for processing orders
      1. Select “Production” if you generated your key on the production server ( or Select “Sandbox” if you generated your key on the sandbox server ( Keep in mind that if you use a sandbox key in Production mode, or vice versa, you will receive an error that says “Specified Source Key not found.”
    5. Authorization Type Do you want submitted credit card transactions to be authorized only, or immediately charge?
      1. Select “Authorize” if you want to authorize credit cards not charge them immediately and see the charges in the queued transactions list of your USA ePay Merchant Console. Select “Immediate Charge” for your charges to be immediate and appear in the “Batches” area of your USA ePay merchant console.
    6. Email Customer Do you want USA ePay to email the customer a copy of the order?
      1. Select “True” or “False” based on your preference
    7. Enable Database Storage Do you want to save the gateway data to the database? (Note: You must add a table first)
      1. Select “True”
    8. Sort order of display. Sort order of display. Lowest is displayed first.
      1. Type 0 in the text box
    9. Payment Zone If a zone is selected, only enable this payment method for that zone.
      1. Select None
    10. Set Order Status Set the status of orders made with this payment module to this value
      1. Select the appropriate status you want displayed for orders coming through the module.

  1. Click “Update” to save your changes. Log out of admin, or pull up another tab, and enter your store to purchase a product. Select a product that is small in price and purchase it. When you receive a confirmation from your cart that the order was successful, log into your USAePay account and view your batch to ensure that the order came in successfully.


GoDaddy Proxy issues

Proxy servers are not required for outbound shared hosting connections as of September 10, 2008. In case of the connection problems, make sure that you have the following settings:

Go to Admin→Configuration→My Store

cURL Proxy Status - FALSE

Error reading from card processing gateway. - Your card has been declined

Go to /includes/modules/payment/usaepay_api.php, line 818 and add


If the above step works, then it means your server is not setup correctly to validate SSL certificates. Please contact support for assistance. You do not want to leave the above setting in place for production use.

PHP Fatal error: Call to a member function add_session() on a non-object in includes/modules/payment/usaepay_api.php

Go to /includes/modules/payment/usaepay_api.php Find the following:

function pre_confirmation_check() {

and make is this:

function pre_confirmation_check() {
global $messageStack; 
merchant/support/carts/zencart.txt · Last modified: 2015/05/29 08:52 by kat

Page Tools