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.
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.