Postnummervalidering i kassan för finländska leveranszoner

Få min gratis API-nyckel Testa postnummerkontroll

Problemet

Kunden fyller sin varukorg, når kassan och upptäcker först då att du inte levererar till hens postnummer. Ordern är redan lagd, betalningsleverantören har redan dragit pengarna och du måste göra en återbetalning. Detta kostar pengar och skapar onödig kundservice.

Hur Delivery Zone löser det

Anropa /api/v1/delivery/check på serversidan innan betalningssteget körs. Om canDeliver är false, blockera ordern och returnera en tydlig orsakskod som gränssnittet kan visa kunden. Kunden får ett ärligt svar tidigt — inte en ursäkt och återbetalning i efterhand.

Exempel på API-anrop

# 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);

Exempel på kundmeddelande

Vi levererar tyvärr inte till detta postnummer. Kontrollera postnumret eller välj en annan leveransadress. Ingen debitering har gjorts.

Vem detta är för

E-handelsbutiker

WooCommerce-butiker

Shopify-butiker

Anpassade kassalösningar

Prenumerationsboxar

Redo att lägga till postnummervalidering?

Gratis plan. Inget kreditkort. Riktig hjälp med start.

Börja gratis Läs API-dokumentationen

Relaterat

WooCommerce-integration Integration för anpassad kassa Exempel: blockera order utanför zonen