Knowledgebase: Payment

How do I integrate the USA ePay Payment Gateway to my 3dcart Store?


This article assumes that you already have an account with the USA ePay gateweay. If you do not have a merchant account, please click here for information about 3dcart's Merchant Account integrated payment solution.

To integrate USA ePay with your 3dcart store, you will need to retrieve a source key from your USA ePay account. The following are the basic steps needed to retrieve this information.

  1. Log into your USA ePay Manager by going to:
  2. Once you log in, click on Settings
  3. Click on Source Keys
  4. Click on Add source
  5. Under name, enter "3dcart"
  6. Enter a Pin number for your Source Key if desired*

Additional Information
*The pin number provides added security for your payment module's source key, but it is optional for the most part. However if you plan to use USA ePay's tokenization system (where you can save the credit card details for future transactions) the Pin will be required.

  1. Leave all other settings as they are.
  2. Click apply.
  3. The KEY will be displayed under the source name.

The key will look similar to the following:


Once you have your USA ePay source key, you will use it to add the USA ePay Payment Module to your 3dcart store. The following are the basic steps for this process:

  1. Log into your 3dcart Online Store Manager
  2. Go to Settings >Payment and click on the "Select Payment" button under "Payment Methods"
  3. Click the "+Add New" button found along the top right of the page.
  4. Configure your payment method's ranges and limitations and choose USA ePAY in the Payment Method dropdown.
  5. Click +Add to add it.

The payment option is added to your store, but we still need to enter your credentials to it and enable it so that it works properly.

  1. Look for the newly inserted USA ePAY section under "Additional Gateways" and click on its "Settings' link found to the far right
  2. Type your Key into the SourceKey field.
  3. Enter your "Pin" if created (See step 6 above)
  4. Click Save at the top right.
  5. Repeat step 6, and click on the "Test" link to make sure the payment gateway is integrated properly.

Additional Information
If the payment gateway is integrated properly - upon clicking the "Test" link - you will see a declined transaction in your USA ePAY account.

Along with the settings shown above, you may also notice toggles for Payment module tokenization, and Authorize Only. These settings are only to be used when you have the feature available on your payment gateway account or through a separate service.

Use Client JS

If you have previously had USAePay enabled on your cart, you may see a new checkbox labeled "Use Client JS" on the payment method.

Enabling this checkbox will use USAePay's latest javascript library to collect payment information on the store. When used, the payment fields are displayed directly from USAePay rather than fields on the 3dcart template - offering a more secure checkout process.

If you are adding USAePay to your store for the first time, you will not see this checkbox as it is enabled by default. However, if USAePay is an existing module on your store, you have the option of enabling the (recommended) feature.

Also note that the Client JS will need specific HTML coding on the checkout pages to function correctly. If you see a message in the Payment Module telling you that your template is not compatible, please be sure to revert your checkout templates to their original formats from the common folder.

The JS option is only available on Core Theme Templates


Help Desk Software by Kayako fusion