Pickup Site Matching

Pickup Site Identification

To determine the pickup site for a given partner, we rely on the pickup latitude and longitude provided by the partner:

• At delivery creation time, when a delivery is created directly without a prior quote
• At quote creation time, when a quote is created first

The provided coordinates are matched against the pickup sites we have on record using a 10-metre tolerance. This ensures the pickup site is correctly identified and authorised as a valid site for the partner.

Multiple Sites at the Same Location

In some cases, a partner may operate multiple brands from the same physical location, requiring multiple site entries with identical latitude and longitude.

Example:

• A site at latitude 1.1 and longitude 2.2 sells items for two different brands belonging to the same partner.

To support this scenario, the API exposes two optional fields that allow more precise matching:

• brand_id: the Deliveroo brand ID shared with the partner during onboarding
• external_site_id: the site identifier used by the partner’s internal systems

Matching Logic with Optional Fields

When both brand_id and external_site_id are provided, a pickup site is matched only if all of the following conditions are met:

• brand_id matches the value on record
• external_site_id matches the value on record
• The latitude and longitude match within a 10-metre radius of the stored coordinates

If brand_id and external_site_id aren't both provided, we match the latitude and longitude within a 10-metre radius of the stored coordinates.