QuickShipper Delivery — quick-start
Offer every QuickShipper courier — Glovo, Wolt, Go Delivery, OnWay, Easy Way, Georgian Post — as a real-time shipping option at WooCommerce checkout. The plugin queries QuickShipper for live rates as the customer enters their address, and creates the courier shipment automatically when the order moves to Processing.
quickshipper-deliveryBefore you begin
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.
Buy a QuickShipper Delivery license
Open the QuickShipper Delivery product page and click Buy license. License is ₾300 / year per domain with a 14-day no-questions refund window.
Download the plugin ZIP
Sign in and open codeon.ge/downloads. Find QuickShipper Delivery and click Download.
Install the plugin in WordPress
In your WordPress admin, go to Plugins → Add New → Upload Plugin. Select the ZIP, click Install Now, then Activate Plugin.
Once activated, a top-level QuickShipper menu appears in the WP admin sidebar. The yellow admin notice prompts for your license key — click Enter license key to land on the License tab.
Activate your license
Paste your license key into the License key field and click Save changes.
- A green Active badge with your expiry date (one year from purchase).
- Your store's domain shown as the bound domain — license keys bind on first use.
- The Settings tab unlocks and the license-key text box hides itself; status, plan and renewal date stay visible.
Plug in your QuickShipper credentials and pickup address
The Settings tab is split into sub-tabs: API credentials, Pickup address, Shipping rules, and Provider visibility. The first two are required; the others have sensible defaults.
- API credentials → Username
- Your QuickShipper username, issued when your merchant account was approved.
- API credentials → Password
- The password QuickShipper issued. Stored encrypted on your WordPress install.
- API credentials → Environment
- Sandbox or Production. Sandbox hits
delivery.quickshipper.appwith a test merchant context — fees come back but no real courier is dispatched. Switch to Production once your test order goes through end-to-end. - Pickup address → Street / City
- Where the courier collects the parcel. Doesn't have to match your billing address — use your warehouse / storefront pickup point.
- Pickup address → Latitude / Longitude
- Decimal coordinates (six decimal places is plenty). Couriers route by lat/lng, not the human-readable address — get this from Google Maps' right- click menu so it matches what their navigation uses.
Click Save changes. The plugin pings QuickShipper's status endpoint with the credentials and shows a green Connectedbadge if the handshake succeeds. A red badge means QuickShipper rejected the credentials — usually a typo in the password, or you're hitting Production with sandbox creds (or vice versa).
Attach QuickShipper to a WooCommerce shipping zone
Even with credentials saved, customers won't see QuickShipper rates until you add the method to a shipping zone. WooCommerce shipping zones are the standard mechanism for "which methods are available where".
- Open WooCommerce → Settings → Shipping → Shipping zones.
- Pick the zone that covers your delivery area (e.g. Tbilisi, or all of Georgia).
- Click Add shipping method and pick QuickShipper from the dropdown.
- Save. Repeat for any other zones.
Place a test order and verify the shipment
Open your storefront in an incognito window. Add a product to cart, enter a delivery address inside the zone you just configured, and proceed to checkout. The Shipping section should populate with one rate per provider × speed:
Pick a rate, place the order, and pay. When the WooCommerce order moves to Processing(default trigger), the plugin calls QuickShipper's order-create endpoint and you should see:
- A new QuickShipper shipment metabox on the order edit screen with the shipment id, the courier (e.g. Georgian Post), and a tracking link.
- An order note: QuickShipper shipment created with id #N — Georgian Post.
- A row appears in QuickShipper → Dashboard → Recent shipments within seconds.
- A row also appears in your QuickShipper merchant dashboard at delivery.quickshipper.app.
Day-to-day operations
- 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.
Common errors and what they mean
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.
Next steps
- 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.