Use case

Shopify delivery zone validation with postcode API

The problem

Shopify's native shipping zones are coarse — they work by country and region, not by Finnish postcode precision. If you deliver only to specific postal areas, Shopify's defaults either over-permit (accepting orders you can't fulfill) or require complex workarounds.

How Delivery Zone solves it

Call the Delivery Zone API from your Shopify backend (custom app, Shopify Functions, or checkout extension) before the order is confirmed. The API returns a clear deliverability decision and zone-based price you can surface in the checkout UI.

Example API request

# Server-side: check whether a postcode can be delivered to
curl -X POST https://api.deliveryzone.fi/api/v1/delivery/check \
  -H "X-Api-Key: dz_live_..." \
  -H "Content-Type: application/json" \
  -d '{"destinationPostcode":"00100","basketValueCents":4500}'

# Response: in zone
{
  "canDeliver": true,
  "matchedZoneName": "Helsinki Center",
  "priceCents": 590,
  "currency": "EUR",
  "estimatedDeliveryMinutes": 45,
  "reasonCode": "DELIVERABLE"
}

// Server-side only — never expose your API key in browser code
async function checkDelivery(postcode, basketValueCents) {
  const res = await fetch("https://api.deliveryzone.fi/api/v1/delivery/check", {
    method: "POST",
    headers: {
      "X-Api-Key": process.env.DZ_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ destinationPostcode: postcode, basketValueCents }),
  });
  return res.json();
}

// PHP — server-side, keep API key out of frontend
$response = wp_remote_post('https://api.deliveryzone.fi/api/v1/delivery/check', [
  'headers' => [
    'X-Api-Key'      => get_option('dz_api_key'),
    'Content-Type' => 'application/json',
  ],
  'body' => wp_json_encode([
    'destinationPostcode' => $postcode,
    'basketValueCents'    => $basket_cents,
  ]),
]);
$data = json_decode(wp_remote_retrieve_body($response), true);

Example customer-facing message

We don’t deliver to this postcode. Please check the postcode or choose a different delivery address. Your order has not been charged.

Who this is for

Shopify store owners in Finland

Shopify developers

Shopify agencies building custom checkout flows

Ready to add postcode validation?

Free plan. No credit card. Real setup help.

Start free Read API docs

Shopify integration guide Checkout validation use case API reference