---
title: Troubleshooting common issues
description: "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…"
url: "https://wpruby.com/knowledgebase/canada-post-troubleshooting/"
updated: "2026-11-21"
category: WooCommerce Canada Post Extension PRO
---

# Troubleshooting common issues

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](#No_Canada_Post_rates_at_checkout)
- [A service is missing at checkout](#A_service_is_missing_at_checkout)
- [“No price returned” in the Label printer (Test API mode)](#%E2%80%9CNo_price_returned%E2%80%9D_in_the_Label_printer_Test_API_mode)
- [Test connection fails](#Test_connection_fails)
- [Credentials show “Not configured” after a site migration](#Credentials_show_%E2%80%9CNot_configured%E2%80%9D_after_a_site_migration)
- [Canada Post rejected the options](#Canada_Post_rejected_the_options)
- [The international shipment cannot be created](#The_international_shipment_cannot_be_created)
- [A shipment cannot be voided](#A_shipment_cannot_be_voided)
- [A manifest stays pending](#A_manifest_stays_pending)
- [Tracking never updates](#Tracking_never_updates)
- [Customers cannot create a return](#Customers_cannot_create_a_return)
- [A pickup cannot be booked](#A_pickup_cannot_be_booked)
- [The licence will not activate](#The_licence_will_not_activate)
- [Label files on nginx](#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](https://wpruby.com/submit-ticket/) and attach the report from API Diagnostics → Export sanitized report.
