WPRuby Logo WPRuby
Log in Get started
  • Plugins
  • Themes
  • Docs
  • Blog
    • eCommerce
    • Plugins
    • How to
    • Coding
  • Affiliate Area
  • Contact Us
  • About Us
  • Plugins
  • Themes
  • Docs
  • Blog
    • eCommerce
    • Plugins
    • How to
    • Coding
  • Affiliate Area
  • Contact Us
  • About Us

WPRuby Account

4
  • How to upgrade your license
  • How to renew your license
  • How to change your plugin’s license domain
  • How to cancel your subscription.

WooCommerce Australia Post Shipping Method Pro

14
  • Installation
  • How to activate your Australia Post Pro license
  • How to Upgrade from Free to Pro
  • Australia Post Zone Settings
  • Australia Post Global Settings
  • Australia Post Tracking
  • Pre-Paid Satchels
  • How to Mark a Product to be Shipped Individually?
  • TroubleShooting and Common issues
  • Available WordPress Actions and Filters
  • [Labels Pro] How to connect the plugin with your MyPost Business account
  • [Labels Pro] How to connect Labels Pro with your eParcel account
  • [Labels Pro] How to print labels and create shipping orders.
  • [Labels Pro] How to Mark a Product as Containing Hazardous Materials?

WooCommerce Custom Payment Gateway Pro

11
  • Getting Started
  • Custom Payment Gateway Settings
  • Custom Checkout Field Builder
  • Conditional Display Rules
  • Sending Payment Data to an External API
  • How to Create a Pay by Invoice Payment Method
  • How to Create a Manual Payment Link or Review-Based Payment Method
  • Troubleshooting
  • Frequently Asked Questions
  • Security and Sensitive Payment Data
  • How to Upgrade from Free to Pro

WooCommerce Royal Mail Shipping Calculator Pro

4
  • Installation
  • Settings
  • TroubleShooting and Common issues
  • How to activate your plugin license

Controlled Admin Access Pro

3
  • Available Actions for a Restricted Admin
  • Installation
  • Settings

WooCommerce Address Guard Pro

7
  • Get Started
  • Configuring Address Providers
  • Configuring Checkout Validation
  • Creating Address Rules
  • Customizing Customer Messages
  • Using the Address Tester
  • Reviewing Address Quality Inside WooCommerce Orders

WooCommerce Simple Table Rates Pro

8
  • Installation
  • Settings
  • Rules and Actions
  • How to Setup Weight Based Shipping
  • How To Setup Shipping By Shipping Class
  • How to Setup Shipping by Cart Total
  • How to Setup Shipping by Product
  • How to Setup Shipping by Product Category

WooCommerce Pack IQ

5
  • Installation
  • How to activate your plugin license
  • How to add a new box
  • How to change the boxes weight and dimensions units
  • How to view the packing results

WooCommerce Restricted Shipping and Payment Pro

4
  • Installation
  • Setting Up Shipping Methods Conditions
  • Available Shipping & Payment Rules
  • Setting Up Payment Gateways Conditions

Affiliate Butler PRO

11
  • Installation and Upgrade
  • Quick Start Guide
  • Managing Auto Links
  • Link Types
  • Short Links
  • Auto Link in the Block Editor
  • Statistics
  • Import and Export
  • Settings
  • Frequently Asked Questions
  • Developers

WooCommerce Adyen Payment Gateway

2
  • Setup the Adyen payment gateway
  • How to configure Adyen Webhook notifications? 

WooCommerce Free Shipping Per Product

2
  • Installation
  • How to setup free shipping for a certain product

WooCommerce UPS Shipping Method Pro

10
  • Installation
  • How to get your UPS Client ID and Client Secret
  • UPS Center Settings
  • UPS Zone Settings
  • How to ship an order and print UPS labels
  • Managing UPS shipments
  • UPS tracking numbers and order completion
  • Shipping Health checks
  • How to activate your UPS license
  • Troubleshooting common issues

Delivery Promise for WooCommerce

9
  • Getting Started
  • Understanding Processing Time vs Transit Time
  • Setting the Cutoff Countdown
  • Configuring Default Delivery Estimates
  • Creating Delivery Rules
  • Setting Working Days and Holidays
  • Using Rule Presets
  • Product-Level Lead Times
  • Why the “Order Within” Countdown Is Not Showing

Cartavera

16
  • Cartavera documentation
  • Install Cartavera
  • Activate your licence
  • Import a starter site
  • Styles, colours and fonts
  • Headers and footers
  • The homepage
  • Catalog and filters
  • The product page
  • Cart and checkout
  • Translation and right-to-left languages
  • Child themes
  • Hooks and filters reference
  • Troubleshooting
  • FAQ
  • Changelog

Candy Shop

14
  • Candy Shop documentation
  • Install Candy Shop
  • Activate your licence
  • Import a starter site
  • Set up your products
  • Food information and allergens
  • Shop pages and filters
  • Styles, colors and fonts
  • Headers, footers and menus
  • The homepage
  • Child theme
  • Hooks and filters
  • FAQ
  • Changelog

Foliowick

16
  • Foliowick documentation
  • Install Foliowick
  • Activate your licence
  • Import a demo store
  • Authors and author pages
  • Book details and editions
  • Genres, reading lists and the Editor’s Pick
  • Secondhand copies and forthcoming books
  • Shop pages, search and book pages
  • Styles, colors and fonts
  • Headers, footers and menus
  • The homepage
  • The journal and editorial pages
  • Hooks and filters
  • FAQ
  • Changelog

Gemelune

14
  • Gemelune documentation
  • Install Gemelune
  • Activate your licence
  • Import a starter site
  • Metals, sizes and swatches
  • Size guide, delivery and care pages
  • Shop pages, product cards and product pages
  • Styles, colors and fonts
  • Headers, footers and menus
  • The homepage
  • Child theme
  • Hooks and filters
  • FAQ
  • Changelog

Formafern

15
  • Formafern documentation
  • Install Formafern
  • Activate your licence
  • Import the demo store
  • Finishes and swatches
  • Dimensions, materials and care
  • Rooms and Shop the Room
  • Shop pages, product cards and product pages
  • Styles, colors and fonts
  • Headers, footers and menus
  • The homepage and editorial pages
  • Child theme
  • Hooks and filters
  • FAQ
  • Changelog

Pawtani

15
  • Pawtani documentation
  • Install Pawtani
  • Activate your licence
  • Install a starter site
  • Pets, sizes, flavours and product facts
  • Size & fit guides
  • Shop pages, filters and product pages
  • Repeat purchases, subscriptions and wishlists
  • Styles, colors and fonts
  • Headers, footers and menus
  • The homepage
  • Child theme
  • Hooks and filters
  • FAQ
  • Changelog

Deep Insights for WooCommerce

19
  • Getting Started with Deep Insights for WooCommerce
  • Upgrading from Woo Insights
  • Importing Your Order History
  • Dates, Comparisons and Filters
  • Revenue Report
  • Products Reports
  • Customer Reports
  • RFM Customer Segments
  • Retention and Cohorts
  • Profitability and Cost of Goods
  • Subscriptions Analytics
  • Inventory Intelligence
  • Shipping, Discounts and Refunds
  • Automated Insights
  • Settings Reference
  • Why Numbers Can Differ from WooCommerce Analytics
  • Troubleshooting
  • Privacy, Security and Updates
  • Developer Hooks
WooCommerce GLS Canada Shipping Pro

WooCommerce GLS Canada Shipping Pro

11
  • Installation
  • How to get your GLS Canada API access
  • GLS Canada Centre settings
  • Adding GLS Canada to a shipping zone
  • How to create a GLS shipment and print the label
  • Creating GLS labels in bulk
  • Requesting GLS pickups
  • GLS tracking for you and your customers
  • Shipping Health checks
  • How to activate your GLS Canada license
  • Troubleshooting common issues
WooCommerce Canada Post Extension PRO

WooCommerce Canada Post Extension PRO

17
  • Installation
  • Demo mode, Test API mode and going live
  • How to connect your Canada Post account
  • Canada Post settings
  • Adding Canada Post to a shipping zone
  • Boxes, packing and product shipping options
  • Canada Post at checkout: rates, Deliver to Post Office and address lookup
  • How to create a Canada Post shipment and print the label
  • International shipments and customs
  • Creating Canada Post labels in bulk
  • Manifests: closing out the day
  • Canada Post tracking for you and your customers
  • Canada Post returns
  • Requesting Canada Post pickups
  • Dashboard, Shipments, Rate Calculator and Post Offices
  • How to activate your Canada Post licence
  • Troubleshooting common issues
View Categories
  • Home
  • Knowledge Base
  • WooCommerce Canada Post Extension PRO
  • Troubleshooting common issues

Troubleshooting common issues

Waseem
Updated on November 21, 2026

2 min read

0:00 / 3:48
  • View as Markdown Open this page as plain Markdown (opens in a new tab)
  • Open in ChatGPT Ask questions about this page (opens in a new tab)
  • Open in Claude Ask questions about this page (opens in a new tab)
  • Open in Google AI Studio Ask questions about this page (Google account required) (opens in a new tab)

Start with Canada Post → API Diagnostics: it shows the operating mode, whether your credentials and account are set up, which API products your app can use and the most recent failed requests. For more detail on rates, turn on Settings → Rates & advanced → Rate debug mode. The last Canada Post error for an order is shown in the Label printer.

Table of Contents

Toggle
  • No Canada Post rates at checkout
  • A service is missing at checkout
  • “No price returned” in the Label printer (Test API mode)
  • Test connection fails
  • Credentials show “Not configured” after a site migration
  • Canada Post rejected the options
  • The international shipment cannot be created
  • A shipment cannot be voided
  • A manifest stays pending
  • Tracking never updates
  • Customers cannot create a return
  • A pickup cannot be booked
  • The licence will not activate
  • Label files on nginx

No Canada Post rates at checkout

In Demo mode and Test API mode, rates are only shown to store managers, so log in as an administrator to test. Then check that Canada Post is in the shipping zone and has services enabled, the address has a valid postal code, the postal code is not excluded, and products have a weight and dimensions (or set defaults in Settings → Packing). Turn on Rate debug mode to log the reason.

A service is missing at checkout

A service is only offered when every parcel can use it. Check the parcel size and weight limits, the shipping options selected on the zone (only services that support all of them are offered), and the product’s Disallowed services. The Rate Calculator explains why a service is not eligible.

“No price returned” in the Label printer (Test API mode)

The Canada Post test environment returns sample prices and may only price some services. This does not happen with real prices. You can still create the shipment with Create without a quote.

Test connection fails

Check that you copied the API Key and Secret of your Test app, and that the app belongs to the customer number you entered. If the token works but an operation fails, open API Diagnostics → Check API products and add any product marked No access to your app in the Developer Portal.

Credentials show “Not configured” after a site migration

Saved credentials are encrypted with your site’s secret keys (salts). If the salts in wp-config.php changed, enter the API Key and Secret again. Defining WCPE_ENCRYPTION_KEY in wp-config.php avoids this.

Canada Post rejected the options

Some options cannot be combined (for example Leave at door and Signature) or are not available for the service or destination. The Label printer disables invalid combinations; choose another option or service.

The international shipment cannot be created

Complete the Customs tab: every item needs a description, value, weight and country of origin, and some services require a non-delivery instruction.

A shipment cannot be voided

Shipments can only be voided before they are transmitted on a manifest, and Solutions for Small Business shipments are paid when created. Use Request refund instead.

A manifest stays pending

Canada Post can take a few moments to prepare a manifest. Click Refresh. If the transmission was interrupted, use Recover interrupted on the Manifests screen; it never transmits twice.

Tracking never updates

Check that Refresh tracking automatically is on in Settings → Tracking, and that WP-Cron runs: WooCommerce → Status → Scheduled Actions should show completed actions in the wcpe group.

Customers cannot create a return

Self-service returns must be enabled in Settings → Returns, the order must be within the return window, shipped within Canada and delivered, and have items left to return.

A pickup cannot be booked

Canada Post only books weekday pickups within its booking window, with the closing time at least an hour after the preferred time and same-day requests before the cut-off. To change the location, cancel and book again.

The licence will not activate

“No activations left”: deactivate the licence on a site you no longer use, or upgrade it in your WPRuby account. “Invalid”: check that you used your Canada Post Extension PRO key. “Could not reach the WPRuby licence server”: your site cannot connect to wpruby.com; check your firewall or proxy. Shipping keeps working meanwhile.

Label files on nginx

Labels are stored in wp-content/uploads/wcpe-private/ with random file names and are only served to logged-in staff. nginx ignores .htaccess; add location ~* /wp-content/uploads/wcpe-private/ { deny all; } to your server configuration.

Still stuck? Contact WPRuby support and attach the report from API Diagnostics → Export sanitized report.

How to activate your Canada Post licenceInstallation
WPRuby Logo WPRuby

In 2015, WPRuby was established as an independent agency where we focus on producing and supporting many WordPress plugins. Each product we develop is simple to use and easy to customize and backed by awesome support and regular updates.

Resources

  • Knowledge Base
  • Affiliate Area
  • About Us
  • Nomad Jar
  • GarnerDocs
  • UnavailableToday

Legal

  • Privacy Policy
  • Terms of Use

Follow us

  • Github
  • X.com
  • LinkedIn
  • Facebook

© 2026 - WPRuby