Developer reference

Pickup Point Delivery Option Generator API (Beta)

The Pickup Point Delivery Option Generator API (PP-DOG API) is a Shopify feature that displays pickup points in Shopify’s native checkout UI. It is currently in beta and available only to Shopify Plus merchants. See Shopify’s PP-DOG API documentation for details.

#How it works with Atlas Pickup Points

The PP-DOG API is restricted to custom apps, so it cannot be integrated directly into our app. You can create a custom app that uses the PP-DOG API to display pickup points powered by Atlas Pickup Points APIs.

We provide ready-to-deploy custom app code and a Shopify Function. You manage pickup point configurations inside Atlas Pickup Points as usual.

Since the PP-DOG API is still in beta, some features may not work as expected. Contact us if you’d like access to demo stores for testing.

#Prerequisites

The custom app restriction means a developer on your team needs to handle the setup. Contact us and we’ll provide the necessary information to get started.

#Known limitations

The PP-DOG API has several limitations compared to the standard Atlas Pickup Points checkout experience:

FeaturePP-DOG APIAtlas Pickup Points
Shipping method nameAlways displays as “Standard” in Shopify Admin and API - cannot be changed, which can cause issues with fulfillmentFully customizable shipping method names
Loading time~4 seconds on average~0.15 seconds on average
Map sizeSmall embedded mapFull-screen map
Search and map interactionPickup points are searched once and remain static - no updates when dragging the mapPickup points update dynamically as the user drags the map
Number of pickup points~30 pickup points across all carriers combined (depends on data volume), cannot be increased50 pickup points per carrier, can be increased on request
Webhook dataNo pickup point code in webhooks - must query via Shopify Admin GraphQL APIPickup point information included in webhooks and accessible via metafield
Country filteringPickup point option is shown for all countries - if a buyer searches in an unsupported country, they see an error saying there are no pickup points in the areaPickup point option is only shown for countries enabled in settings
Draft ordersNot supportedSupported
Price visibilityPickup point selection happens before shipping methods - buyers cannot compare pickup point vs home delivery costs upfront, price is only shown after selecting a specific pickup pointPickup point shipping rates are listed alongside home delivery rates, making it easy to compare costs