====== 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 [[http://www.usaepay.com/topics/usa_epay_payment_module_2-0.zip|payment module]] uploaded to your Zen Cart payment modules directory. Our current version is: 2.0 and was updated: 05/27/2009.

  - Using your favorite web browser, pull up the administration page of your Zen Cart shopping cart. It will look something like the image below:
{{:merchant:support:carts:zencart01.gif|}}
  - Point your cursor to the link titled "Modules" and click on "Payment":
{{:merchant:support:carts:zencart02.gif|}}
  - 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.
{{:merchant:support:carts:zencart03.gif|}}
  - Click on the "Edit" button:
{{:merchant:support:carts:newzencartsetting.jpg|}}
  - Module Setup
    - **Enable USA ePay Module** Do you want to accept USA ePay credit card payments?
      - Select "True"
    - **USA ePay Source Key** Please enter your USA ePay Source Key
      - Input your [[http://wiki.usaepay.com/merchant/console/sources|source key]] generated from your USAePay merchant console
    - **USA ePay Source PIN** Enter a pin, if applicable
    - **Transaction Mode** Transaction mode used for processing orders
      - Select "Production" if you generated your key on the production server (secure.usaepay.com or www.usaepay.com). Select "Sandbox" if you generated your key on the sandbox server (sandbox.usaepay.com). 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."
    - **Authorization Type** Do you want submitted credit card transactions to be authorized only, or immediately charge?
      - 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.
    - **Email Customer** Do you want USA ePay to email the customer a copy of the order?
      - Select "True" or "False" based on your preference
    - **Enable Database Storage** Do you want to save the gateway data to the database? (Note: You must add a table first)
      - Select "True"
    - **Sort order of display.** Sort order of display. Lowest is displayed first.
      - Type 0 in the text box
    - **Payment Zone** If a zone is selected, only enable this payment method for that zone.
      - Select None
    - **Set Order Status** Set the status of orders made with this payment module to this value
      - Select the appropriate status you want displayed for orders coming through the module. 
{{:merchant:support:carts:newzencarteditsettings.gif|}}
  - 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.

===== Troubleshooting =====
==== GoDaddy Proxy issues ====

  * GoDaddy.com hosting providers might need to go through a proxy. Please download the following module files that have the proxy already built in. {{:merchant:support:carts:GoDaddy_zencart.zip|Download}}