QuickShipper Delivery — quick-start

Three things to gather. The first checkout rate fetch is much smoother when you don't have to leave mid-flow to chase a credential or look up your store's coordinates.

• An active QuickShipper merchant account (test or production). If you don't have one yet, sign up at quickshipper.app. You'll get a username + password by email once your contract is active.
• Your store's pickup address — street, city, plus a latitude / longitude. Couriers navigate by coordinates; even a one-block-off lat/lng causes failed pickups. The fastest way to get exact coordinates: open Google Maps, right-click your storefront, click the lat/lng to copy.
• WordPress admin access, WooCommerce installed and active, and at least one configured WooCommerce shipping zone(typically "Tbilisi" or "Georgia"). We'll attach QuickShipper to your zones in step 6.

• Where to see what's happening: QuickShipper → Dashboard. KPI tiles + the recent- shipments table show which orders shipped, which courier took them, and the current status (pulled live from QuickShipper when you open the page).
• Cancelling a shipment:from the order edit screen's QuickShipper metabox. Works only while QuickShipper hasn't assigned a courier yet — once a courier is on the way, cancellation goes through the courier's policy. Cancelling a WooCommerce order also cancels the linked shipment automatically (toggle in Settings → Shipping rules).
• Status auto-refresh:opening any order re-fetches the shipment status from QuickShipper before rendering. There's also an hourly background sweep for non-terminal shipments. So the WP-side metabox is always within an hour of the QuickShipper-side truth, and within seconds when you actually look at it.
• If the QuickShipper API is down: the checkout falls back to your configured flat-fee rate (set in Settings → Shipping rules) so the customer can still complete the order. Shipment creation also retries automatically when the API recovers — no manual intervention needed in 95% of cases.

License key doesn't cover this plugin

You pasted a payment-plugin license into the QuickShipper plugin. Each plugin has its own license; check /licenses for which key is which.

QuickShipper: 401 unauthorized

Wrong username or password, or you're hitting Production with sandbox credentials. Re-verify the Environment toggle matches the credentials you pasted.

No rates available for this address

Customer address is outside QuickShipper's coverage, or your pickup lat/lng is wrong / outside the courier's service zone. Verify store coordinates first in Settings → Pickup address.

Order delete is restricted

QuickShipper rejected the cancel because a courier has already been assigned. The plugin adds an order note with the reason; the shipment continues through the courier's normal policy.

requires PHP version 8.1 or higher

Your host is on PHP 7.4 / 8.0. Bump the PHP version from your hosting control panel and re-activate the plugin.

• Pair QuickShipper with a payment plugin — TBC Card, BoG Card, or Flitt — so the courier rate the customer picked is paid for at checkout in one flow.
• Building automation around shipment events? The integrator docs will cover the QuickShipper webhook contract once the integrator surface is published.