Käyttökohde

Tarkka toimituskulujen laskenta postinumerovyöhykkeittäin

Hanki ilmainen API-avain Kokeile postinumerotarkistusta

Ongelma

Monet kaupat näyttävät 0 € tai alustavan toimituskulun siihen asti, kunnes asiakas siirtyy kassan myöhempään vaiheeseen. Tämä aiheuttaa hintajärkytyksen maksuvaiheessa, lisää ostoskorin hylkäämistä ja tuottaa yhteydenottoja asiakkailta, jotka eivät osanneet odottaa lopullista hintaa.

Miten Delivery Zone ratkaisee sen

Kutsu /api/v1/delivery/check heti postinumeron syötön yhteydessä ja käytä vastauksen priceCents-arvoa näyttääksesi toimituskulun välittömästi. Kun postinumero on vyöhykkeen ulkopuolella, kerro syy sen sijaan että piilottaisit kuluja. Asiakas näkee todellisen hinnan alusta alkaen.

Esimerkki API-pyynnöstä

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

Esimerkkiviesti asiakkaalle

Emme valitettavasti toimita tälle postinumeroalueelle. Tarkista postinumero tai valitse toinen toimitusosoite. Tilaustasi ei ole veloitettu.

Kenelle tämä sopii

Verkkokaupat, joissa on vyöhykepohjainen hinnoittelu

Ravintoloiden toimitusalustat

Ruoka- ja lähilogistiikkatoimitukset

Monivyöhykkeiset toimitusketjut

Valmis ottamaan postinumerotarkistuksen käyttöön?

Ilmainen aloitus. Ei luottokorttia. Aito käyttöönottoapu.

Aloita ilmaiseksi Lue API-ohjeet

Liittyvät aiheet

Kassan tarkistus Esimerkki: toimitushinnan palautus WooCommerce-integraatio