The UPS module for X-Cart 5 allows you to use online shipping rate calculation via UPS service.

This article assumes that the UPS module has already been installed and activated at your store.

To start using the module, you need to configure it. The module configuration settings can be accessed using one of the following methods:

  1. In the Shipping section of your X-Cart store’s Admin area (Store setup > Shipping)
    • click the Add shipping method button: shipping.png

    • and then choose the UPS shipping method in a pop-up: ups-method.png

  2. In the Installed Addons section of your X-Cart store’s Admin area (My addons > Installed addons), locate the entry for UPS module and click the Settings link below it: settings.png

The UPS settings page looks like the following:


To use UPS Rating API you need to register on with a User ID and Password. Once you have registered you would need to obtain an Access Key from that provides access to the Rating API. To obtain an Access Key an account number needs to be added or created in your profile.

So first of all you’ll need to fill in the following fields in accordance with your UPS account data:

  • User ID: Specify your UserID.
  • Password Specify your password.
  • Access key: Specify the access key you obtained from UPS.
  • UPS Account number: Specify the UPS account nember. A shipper’s UPS account number is required when requesting to receive the negotiated rates.
  • Test mode: Turn the test mode on if you want to check the UPS shipping processing before making it live.

Package Settings

These are the options that will be applied to both domestic and international shipments:


  • Package box type: Select the type of packaging that will be used for shipments.
  • Package dimensions (IN) (Length, Width, Height): Use these fields to define the default package size for USPS shipments in inches.
  • Maximum package weight (lbs): Specify the top limit of package’s weight in lbs.

Service Options

These are advanced options for shipments.


Turn them on or select the necessary values if applicable.

Cash on delivery

Here you can enable the cach on delivery option for your inetrnational and domestic shipments.


To enable the cash on delivery option for shippings you should first activate this option in the payments section (Store setup > Payment methods). Find UPS in the Offline methods section and turn the cash on delivery option on.


Follow the link from the Note to find the payments section note.png

Currency conversion options

Use this section to provide a currency convertion rate if your currency is other than the US dollar.


  • Shipping cost currency: If the shipping currency is other than USD, specify it in this field.
  • Currency rate: Set the currency conversion rate here. If your currency is the US dollar, leave this field set to 1.

Additional options

This is an option that is helpful, but do not affect shipping rates calculation:


This option enables logging of requests to the UPS server and responses from it. The logs are saved to UPS.log files in the <X-Cart>/var/log/ folder.

Don’t forget to save the changes when the USPS shipping configuration is complete.