Recovery page
The recovery page is a self-service page that lets customers select a pickup point after checkout. You generate a link and share it with the customer — they open it, see nearby pickup points on a map, and make their selection.
When do you need this?
The recovery page is useful when:
- Your store is not on Shopify Plus and does not have the checkout extension
- A customer completed checkout without selecting a pickup point
- You need to manually share a pickup selection link with a customer (email, chat, etc.)
On Shopify Plus stores with the checkout extension enabled, customers select their pickup point directly during checkout. The recovery page is rarely needed in that case.
How it works
1. Generate a recovery link
- Go to Orders in the Baltix sidebar.
- Find the order that has no pickup point selected.
- Click Generate Recovery Link.
- Copy the link to your clipboard.
The link looks like: https://your-store.myshopify.com/apps/proxy-subpath/pickup/abc123...
Each link is unique to the order and can only be used once (until a pickup point is selected).
2. Share the link with the customer
Send the recovery link to the customer through your preferred channel:
- SMS
- Live chat
- Social media
3. Customer selects a pickup point
When the customer opens the link, they see a page with:
- Their delivery address displayed for reference
- A list of nearby pickup points sorted by distance (within 5 km radius)
- An interactive map showing pickup point locations (if Google Maps is configured)
- A search bar to find pickup points by name or address
- A phone number field (required for some carriers)
The customer clicks on a pickup point to select it, confirms their phone number if needed, and submits.
4. What happens after selection
Once the customer selects a pickup point:
- The order is updated with the selected pickup point
- If auto-label creation is enabled, Baltix starts creating the shipping label automatically
- Any automatic pickup selection that was scheduled is now cancelled (no longer needed)
Auto-pickup fallback
If the customer does not select a pickup point within 30 minutes of the order being created, Baltix can automatically select the nearest pickup point based on the customer's shipping address.
This automatic selection:
- Finds the closest pickup point based on your customer's delivery address
- Searches within a 5 km radius (or expands to the 20 closest points if none found nearby)
- Then follows the same steps as manual selection (label creation, carrier updates, etc.)
Automatic selection only applies to non-Shopify Plus stores where the customer used a pickup shipping method but did not select a specific point. You will see a banner in the admin indicating the point was automatically selected.
Prerequisites
For the best customer experience on the recovery page:
| Requirement | Why | Link |
|---|---|---|
| Google Maps API key | Shows an interactive map with pickup point markers | Setup Google Maps |
| Carrier connected | Pickup points are loaded from connected carriers | Connect a carrier |
The recovery page works without Google Maps, but the experience is significantly better with the map enabled. Customers can visually browse pickup points near their address.
Troubleshooting
| Problem | Possible cause | Solution |
|---|---|---|
| Recovery link shows "not found" | Token is invalid or order was deleted | Generate a new recovery link from the order page |
| No pickup points displayed | Carrier not connected or no points in the area | Check carrier configuration in Settings > Carriers |
| Map not showing | Google Maps API key not configured or restricted | See Setup Google Maps |
| Customer already selected a point | Link can only be used once | The page will show a message that a point was already selected |