# The Courier Guy

Floormode books The Courier Guy labels on your own Courier Guy account in South Africa: to the customer's door, or to a Pudo locker, a Courier Guy counter or a partner pickup point.

import DocUpdated from '~/components/DocUpdated.astro';

Floormode books The Courier Guy labels on your own Courier Guy account in South
Africa: to the customer's door, or to a Pudo locker, a Courier Guy counter or a
partner pickup point. Fastway runs on the same platform (ShipLogic) and connects
as its own carrier: see [Fastway](/integrations/carriers/fastway-za/).

## On this page

- What you enter
- What Floormode books
- Tracking updates
- Test labels first
- See also

## What you enter

| Field | Where you find it |
|---|---|
| API key | portal.thecourierguy.co.za → Integrations → API Keys → Create |

1. Sign in to your Courier Guy portal (portal.thecourierguy.co.za). Since May 2026
   The Courier Guy's keys work only for its own portal, not for another ShipLogic
   courier's.
2. Open **Integrations → API Keys** and create a key.
3. In Floormode, open **Settings → Shipping & carriers → Carriers & printing → Connect carrier →
   The Courier Guy** and enter the key.

## What Floormode books

- One parcel per label within South Africa, from a South African address with its
  four-digit postcode.
- **To the door:** the service levels your account has (for example Economy, Priority),
  priced in rand with VAT as The Courier Guy quotes them. A declared value insures
  the parcel.
- **To a locker or pickup point:** the point your customer chose at checkout, or one
  you pick from the nearest points. The Courier Guy takes no declared value on a
  pickup-point parcel.
- The waybill as a PDF. The Courier Guy texts and e-mails the recipient, so the order
  needs the customer's mobile number or e-mail.
- Cancelling a label before the parcel is collected: The Courier Guy reverses the
  charge. A collected parcel cannot be cancelled.
- Tracking, from The Courier Guy's statuses.

Not offered: **cash on delivery** (The Courier Guy's API has none), returns, opt-in
extras such as early-bird delivery, and international parcels.

## Tracking updates

**Refresh** on a shipment reads the latest status from The Courier Guy. For status changes
that arrive on their own, each connected Courier Guy account has its own private tracking
address: add it as a webhook in your Courier Guy portal. To get it, open **Settings → Shipping & carriers → Carriers & printing**, find the account and press
**Copy address** beside *Tracking address* (it needs Settings access). Treat the
address like a password: anyone who has it can send status updates for this
account. The Courier Guy does not sign its updates, so the address is their only proof.
Reconnecting the account keeps the same address.

## Test labels first

Register a free sandbox account at tcg-sandbox.shiplogic.com/register (it needs a
South African mobile number), create an API key under Integrations → API Keys, and
connect it as a test account. Sandbox rates are demo prices, and the sandbox gives no
international quotes.

## See also

- [Carriers and packaging](/features/settings/carriers-and-packaging/)
- [Labels, printers and scanners](/features/settings/labels-printers-and-scanners/)

<DocUpdated date="2026-11-18" />