--- title: "Purolator" description: "This plugin integrates Purolator shipping API with the J2Commerce Joomla eCommerce solution." url: "https://docs.j2commerce.com/shipping-methods/purolator" markdown_url: "https://docs.j2commerce.com/shipping-methods/purolator.md" last_updated: "2026-10-23T02:33:38+00:00" version: "J2Store 4" breadcrumbs: - title: "Home" url: "https://docs.j2commerce.com/" - title: "Shipping Methods" url: "https://docs.j2commerce.com/shipping-methods" - title: "Purolator" url: "https://docs.j2commerce.com/shipping-methods/purolator" --- # Purolator This plugin integrates Purolator shipping API with the J2Commerce Joomla eCommerce solution. **Requirements** - with PHP 8.1.0 + - Joomla! 4.x/ Joomla! 5.x + - J2Commerce / J2Store 4.x + #### How to obtain your API Key: You will need this once you have installed the Purolator App on your website Go to and [www.purolator.com](https://www.purolator.com/en/services/technology-solutions/e-commerce-online-stores) register or login. ![Purolator E-Ship Web Services page with the Register now and Login buttons below the heading](https://docs.j2commerce.com/images/docs/shared/purolator-login.webp) To obtain your API Key on the Purolator website, you need to register for Purolator E-Ship Web Services. The process involves several steps: - **Register for an E-Ship Web Services Account:** - Visit the Purolator website and navigate to the E-Ship Resource Center. - Click on the "Register for Purolator E-Ship Web Services" button. - Choose the appropriate account type (e.g., Corporate Account Holder) and complete the profile information form. - Submit the registration. - You will receive an email from Purolator with a verification link; click this link to complete your registration. - **Obtain Development Key (Optional, for testing):** - Log in to your newly created E-Ship Web Services account. - Look for an option to "Obtain Development Key" or similar. - Complete the required form, providing details about your integration type and account. - Submit the form, and Purolator will email you the Development Key, Password, and Carrier Account Number. - **Request Production Key (for live use):** - Log in to your E-Ship Web Services account. - Find the option to "Request for Production Key" or similar. - Complete and submit the form, providing the necessary business account information. - Purolator will email you the Production Key, Password, and Carrier Account Number, which are essential for live API integration. Note: Depending on your specific integration needs and e-commerce platform (e.g., ShipStation, Shopify via Plugin Hive), there might be slightly different instructions or specific options to select during the key generation process. Always refer to the instructions provided by your chosen platform or the Purolator Developer's API Portal for the most accurate guidance. **Installation** **Step 1:** Go to our [J2Commerce website](https://www.j2commerce.com/extensions) > Extensions > Apps ![J2Commerce website Extensions > Shipping Plugins page with Extensions menu, Shipping tab and the Purolator Shipping card ($34.99) highlighted](https://docs.j2commerce.com/images/docs/shared/purolator-purchase-1.webp) **Step 2:** Locate the Purolator Shipping App > click View Details > Add to cart > Checkout. **Step 3:** Go to your My Download under your profile button at the top right corner and search for the app. Click Available Versions > View Files > Download Now ![J2Commerce website My Downloads page searching purolator, with the account icon, My Downloads, Search and the Available Versions button highlighted](https://docs.j2commerce.com/images/docs/shared/purolator-download.webp) If there is more than one version available, make sure you click View Files for the most current version. ![J2Commerce website My Downloads for Purolator listing versions 4.0.1 and 4.0.0, with My Downloads and the View Files button for 4.0.1 highlighted](https://docs.j2commerce.com/images/docs/shared/purolator-download1.webp) #### **Installation:** You can install this Purolater shipping plugin using the Joomla installer. The following steps help you for a successful installation. **Step 1:** In the Joomla admin, go to System > Install > Extensions ![Joomla System Dashboard with System in the sidebar and the Install > Extensions link highlighted](https://docs.j2commerce.com/images/docs/shared/purolator-ext-install.webp) **Step 2:** Click on the Browse button and select the Purolator Shipping zip file ![Joomla Extensions: Install, Upload Package File tab, with the Or browse for file button highlighted](https://docs.j2commerce.com/images/docs/shared/purolator-man-install1.webp) **Step 3:** In the Joomla admin, go to System > Manage > Extensions ![Joomla System Dashboard with System in the sidebar and the Manage > Extensions link highlighted](https://docs.j2commerce.com/images/docs/shared/purolator-man-install.webp) **Step 4:** Search for the app and enable it ![Joomla Extensions: Manage searched for purolator after an Extension enabled message, with the Purolator Shipping plugin status checkmark highlighted](https://docs.j2commerce.com/images/docs/shared/purolator-enable.webp) **Step 5:** Select J2Commerce >setup > shipping methods **Step 6:** Locate the Purolator Shipping App and click View to begin customizing it ![J2Commerce Shipping Methods with Components and Setup > Shipping Methods highlighted, and the Purolator Shipping for J2Commerce row](https://docs.j2commerce.com/images/docs/shared/purolator-setup.webp) #### **Basic Settings:** **API key:** Enter the valid API key provided by Purolator shipping **API password:** Enter your Purolator shipping account’s password **API account:** Enter the account number associated with your Purolator account ![purolator](https://docs.j2commerce.com/images/docs/shared/purolator-perameters.webp) **Origin zip code:** Enter the postal code from where the shipping is actually made. **Box List:** Purolator Shipping comes with a box packing feature. The box packing included with this shipping method lets you pack all the items into a single box for which you have to define height, width, length, weight, and max-weight. **Purolator Service:** Choose the shipping services that you would like to provide to the customers. > NOTE: Services are depend on the customer’s shipping address. Even if you choose many services here, Purolator will show only the services that are available to the customer’s shipping destination at the checkout. **Handling Fee:** If you would like to charge a handling fee, you can enter the amount here. **Length unit:** The valid length units are centimeters and inches. Make sure that you are using the same length unit for all your products. **Weight unit:** The valid weight units are kilogram and pound. Make sure that you are using the same length unit for all your products. **Display delivery date:** Choosing YES will display the delivery date. **Tax class:** Choose whether your shipping is taxable or not. If you would like to make your shipping taxable, you can choose your tax profile here. **Geozone:** You can select a geo-zone and restrict the availability of this shipping method to the countries/zones in that geozone. Choose 'All' to make this shipping method available to customers from all regions. **Debug:** If you set this to yes, then debug messages will be logged and saved in the cache folder in your Joomla root directory. ![purolator2](https://docs.j2commerce.com/images/docs/shared/purolator-perameters1.webp) ![purolator3](https://docs.j2commerce.com/images/docs/v4/doc-images/shipping-methods/purolator/purolator_03.jpg)