One <script> tag. No Shopify App approval. No npm install. Works with any theme โ Dawn, custom, or headless.
Drop one <script> tag into your theme.liquid (or checkout.liquid for Shopify Plus). That's it.
The SDK auto-detects when a customer enters a postcode and picks a shipping method. Debounced, lightweight, no PII.
High-risk โ upsell photo-proof shipping. Medium โ require signature. Low โ standard. Your business logic, our data.
Online Store โ Themes โ Edit code โ theme.liquid, just before the closing </body> tag.
<!-- WhereIsMyParcel Risk SDK -->
<script src="https://whereismyparcel.uk/wimp-risk.js" defer></script>
<script>
document.addEventListener("DOMContentLoaded", function () {
WIMP.attachToCheckout({
postcodeSelector: "#checkout_shipping_address_zip",
carrierSelector: "[data-shipping-method]:checked",
defaultCarrier: "Evri",
onRisk: function (risk) {
console.log("[WIMP]", risk);
if (risk.risk_level === "high") {
// Show your "upgrade to safer delivery" UI here
document.dispatchEvent(new CustomEvent("wimp:high-risk", { detail: risk }));
}
}
});
});
</script>// Or call the API directly
WIMP.checkRisk({ postcode: "M1 2AB", carrier: "Evri" })
.then(function (risk) {
// { risk_level, risk_score, failure_rate,
// recommended_action, recommended_carrier }
console.log(risk);
});curl -X POST https://whereismyparcel.uk/api/risk-check \
-H "Content-Type: application/json" \
-d '{"postcode": "M1 2AB", "carrier": "Evri"}'Same <script> tag in your theme footer. Adjust the selectors to match WooCommerce's checkout fields (#billing_postcode, input[name='shipping_method[0]']).
| Field | Type | Description |
|---|---|---|
| risk_level | "low" | "medium" | "high" | Headline classification โ what most retailers act on. |
| risk_score | number (0โ100) | Granular score for advanced rules / A/B tests. |
| area_complaints | number | Total complaints in this postcode area, all carriers. |
| carrier_complaints | number | Complaints in this postcode for this carrier. |
| failure_rate | number (%) | Of resolved complaints in area, what % were lost / damaged / false delivery. |
| recommended_action | string | Plain-English suggestion for what to do. |
| recommended_carrier | string | null | If risk is high, the lowest-complaint alternative carrier in this area. |
Standard checkout flow. Don't add friction where you don't need to.
Show a ยฃ1.50 upsell for photo-proof-of-delivery. ~8% take rate, 100% margin.
Auto-select a recommended alternative carrier or require signature on delivery to cut chargebacks.
We're tracking which retailers are testing the snippet so we can prioritise the official Shopify App build. Join the early-access list to get a real-time dashboard, webhooks, and the official app the second it ships.
Join the early access list โ