Integrationsguide
Anpassad kassaintegration
Delivery Zone API fungerar med alla backendspråk och ramverk. Skicka en POST till /api/v1/delivery/check från din server med kundens postnummer och varukorgsvärde. Svaret anger om du kan leverera, vilken zon som gäller och vilket pris som ska debiteras.
När API:et ska anropas
Anropa API:et på serversidan under kassans validering — innan betalsätten visas och innan någon debitering genomförs.
Viktigt: håll API-nycklar på serversidan: Anropa alltid API:et från din server, inte från kundens webbläsare. Din API-nyckel får aldrig förekomma i frontend-kod.
Kodexempel
// 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();
}Felhantering
När canDeliver är false (eller null) innehåller svaret ett reasonCode-fält. Visa detta för kunden:
NOT_DELIVERABLE— postnumret ligger utanför dina leveranszoner eller känns inte igen (API:et använder avsiktligt en generell kod för båda för att skydda zongränser)MINIMUM_ORDER_NOT_MET— varukorgens värde understiger zonens minsta ordervärdeBASKET_VALUE_REQUIRED— ett varukorgsvärde krävs för att utvärdera denna destinations regel för minsta order eller fri frakt
Hantera alltid HTTP-fel (5xx, timeout) kontrollerat. Om API:et inte kan nås, använd felsäkert läge — avvisa antingen ordern eller tillåt manuell granskning.
Checklista för implementation
- Anropa API:et från din server, inte från webbläsaren
- Spara API-nyckeln som en miljövariabel
- Validera postnummerformatet (5 siffror) innan du anropar API:et
- Hantera API-fel kontrollerat — låt inte en timeout blockera kassan
- Testa både postnummer inom och utanför zonen före lansering
Redo att lägga till postnummervalidering?
Gratis plan. Inget kreditkort. Riktig hjälp med start.