POST /orgs/:orgId/shipping-quote on a headless storefront.
What you configure in Zippendo is which shipping rules become those options, how many pickup points to show, and (Shopify) whether the Zippendo Shipping carrier service is registered.
Connect the store first — Connect Shopify or Connect order channels — and add at least one outbound shipping rule. Without a rule, checkout has nothing to offer.
What the shopper sees
A matching shipping rule becomes a shipping method. The shopper’s destination country, cart weight, order value, and item count decide which rules appear and what they cost. Service-point rules expand into individual pickup locations. After checkout, the order syncs into Orders with that rule attached, so creating a shipment fills carrier, product, and sender from the rule.You cannot preview a cart inside Zippendo. The Test button on a shipping rule tests conditions (would this rule match this cart?), not a live carrier quote. See Shipping rules.
Prerequisites
1
Connect the store
Order Channels → Available integrations. Shopify, WooCommerce, or a custom channel.
2
Connect carriers
Carriers → All Carriers. Rates use the products on those accounts — Carriers.
3
Add outbound shipping rules
Shipping Rules → Add Shipping Rule. Name the rule the way customers should read it. Set destination countries and conditions. Shipping rules.
Available integrations — Shopify, WooCommerce, and Custom channel
Shipping Rules power the methods shoppers see at checkout
Shopify: Zippendo Shipping
Shopify checkout uses carrier-calculated rates. Zippendo registers a carrier service named Zippendo Shipping. Shopify calls Zippendo when the shopper reaches shipping; Zippendo returns the selected rules (and pickup points) as rates.Install the store
From Available integrations, click Connect Shopify. The modal is Connect your Shopify store.
Connect your Shopify store — install from the Shopify App Store
1
Open the Zippendo listing in the Shopify App Store
2
Install the app on your store and approve the permissions
3
You are redirected back to Zippendo to choose organization, sender address and order import
Choose which rules appear
Open the Shopify store under Connected stores. Stay on Orders & checkout. Scroll to Checkout Shipping Rates.
Checkout Shipping Rates — tick the rules Shopify should offer
Service points per checkout
On the same card, Service Points per Checkout is Total number of pickup point locations to show at checkout. These are divided evenly among service point shipping rules. Allowed range is 1–20 (the docs org uses 6).
Service Points per Checkout and Shipping method mapping on the same tab
Register the carrier service
Open Connection & integration. Scroll to Carrier Service.
Check Carrier Service — register Zippendo Shipping with Shopify
1
Check Status
Check Carrier Service verifies the carrier service is registered with Shopify for calculated rates. If none is registered, rates will not appear at checkout.
2
Register Carrier Service
Use Register Carrier Service if the check finds nothing (or after a reconnect).
3
Add Zippendo Shipping in Shopify Admin
This step is in Shopify, not Zippendo: Shopify Admin → Settings → Shipping and delivery, then add Zippendo Shipping as a rate provider in your shipping zones.
Fallback: shipping method mapping
Shipping method mapping is for stores without Shopify Carrier-Calculated Shipping. Map the shipping method names from your manual Shopify rates to shipping rules so imported orders are ready to ship. Click Add mapping, enter the Shopify method name (for exampleGLS Home Delivery), pick a shipping rule, and choose how parcel shops are selected (Nearest automatically or Choose manually). If you already use Zippendo Shipping, you can leave mappings empty.
WooCommerce: plugin and checkout token
WooCommerce checkout is the Zippendo for WooCommerce plugin plus a Checkout token (zck_…) stored on the channel.
Connect WooCommerce Store — store URL and default sender, then approve on the store
wc-auth cannot be completed in this documentation environment, so the channel settings below are described from the product UI (the same labels you will see after a successful connect). Then open the WooCommerce channel and stay on Orders & checkout:
1
Download the plugin
The Checkout token card includes Download plugin. Install Zippendo for WooCommerce on the WordPress site.
2
Generate a checkout token
Click Generate token. Copy it immediately — only a hash is stored. The token is shown once.
3
Paste the token into the plugin
In WordPress, open the plugin settings and paste the token. Rotate token invalidates the old key immediately; Revoke stops the plugin until you generate a new one.
POST /woocommerce/checkout/rates (and POST /woocommerce/checkout/service-points when the shopper changes postcode). Those routes authenticate with the checkout token, not your dashboard session.
Test connection on the WooCommerce channel Connection tab is different: it verifies the stored REST API keys can reach the store (order sync). It does not quote checkout rates. The plugin can ping GET /woocommerce/checkout/ping to confirm the token.
Custom and headless storefronts
A Custom channel imports orders (signed ingest or the API). It does not render a Zippendo checkout UI. To show live rates in your own checkout, callPOST /orgs/:orgId/shipping-quote with destination, items, and currency. Requirements and a sample body: Shipping quotes quickstart. You need an API token — Settings, team, and brands covers API Settings.
How to test rates
There is no in-app checkout preview. Test on the surface the shopper uses:
If a rate is missing, check the rule’s Receiving Countries, hard limits, and conditions before assuming the carrier service is down.
After checkout
1
Confirm the order landed
Orders — the channel badge and shipping rule should match what the shopper picked. Orders.
2
Create the shipment
Open the order → Create Shipment (or Add Shipment). The rule fills carrier and product. Create a shipment.
3
Print and track
Shipping rules
Build the methods checkout offers — destination, weight, and price.
Connect Shopify
Install the app and finish organization, address, and import.
Connect order channels
WooCommerce and custom channels, including more than one store.
Shipping quotes
Headless checkout via POST /orgs/:orgId/shipping-quote.