Docs
Sign in

Click and collect

Updated May 29, 20262 min read

Click and collect lets your customer pick the parcel up at a configured location (a store, a parcel locker, a partner pickup point) rather than having it delivered to their address.

In Carriyo, click and collect is a Delivery Option with delivery_method = COLLECTION. It uses the same data shape as a home delivery option. The collection point replaces the customer's address as the destination. See Delivery options for the shared model.

What's different from home delivery

  • No customer address as destination. The customer chooses a collection point from the list of points Carriyo returns for the option.
  • Geographic eligibility is location-based. Each option declares its supported collection locations and (optionally) a maximum distance from the customer. Carriyo returns the collection points within range that the option supports.
  • The fulfillment may differ. A click-and-collect option can be fulfilled in two ways. See Local vs remote collection below.

Configuration

For each COLLECTION delivery option, the merchant configures:

  • Customer collection locations. The list of stores, lockers, or partner locations the option can be picked up from.
  • Maximum distance (optional). Limit the response to collection points within a given distance from the customer's address.
  • Fulfillment locations. Where the option can ship from. For local collection (see below), the collection location is the fulfillment location.

Local vs remote collection

Two operational flows are possible, depending on how the option's fulfillment and collection locations relate:

  • Local collection. The collection location is also the fulfillment location. The item is already at the store; no shipment is needed to move it. The customer arrives, the collection is closed out, and the order completes.
  • Remote collection. The fulfillment location is a warehouse (or similar), and the parcel is shipped to the collection location for pickup. A Shipment exists for that warehouse-to-collection-point leg; the customer's pickup happens at the destination.

Both flows are covered in more detail on Fulfillment orders → what a fulfillment order produces.

After the customer picks click and collect

When the order is placed with a click-and-collect option, the chosen option is captured on the order along with the chosen collection location. The downstream Customer collection entity tracks the in-store handover: OTP verification, expiry handling, the lifecycle from open to collected.

How it fits with other modules