REST, JSON, bearer tokens. Nothing exotic. A competent developer connects a storefront in an afternoon.
// request { "reference": "ORD-99214", "dropoff": { "name": "Aisha Rahman", "phone": "+9715XXXXXXXX", "address": "Marina Gate 2, Dubai Marina", "pin": { "lat": 25.0805, "lng": 55.1403 } }, "window": { "from": "14:00", "to": "18:00" }, "vehicle": "bike", "payment": { "method": "cod", "amount": 249.00 }, "proof": ["photo", "otp"] }
{
"id": "dp_8Kq2mR7xN",
"status": "pending_dispatch",
"eta": "2026-09-08T15:42:00+04:00",
"tracking": "https://track.yourbrand.com/8Kq2mR7xN",
"driver": null
}We POST to your endpoint on every state change. Retries use exponential backoff for 24 hours.
| EVENT | FIRES WHEN | USEFUL FOR |
|---|---|---|
| delivery.assigned | A driver accepts the job | Notify the customer it is on the way |
| delivery.collected | Parcel picked up from your warehouse | Decrement stock, close the pick list |
| delivery.approaching | Driver within 10 minutes | The "your driver is nearby" message |
| delivery.completed | Proof captured and accepted | Mark the order fulfilled, trigger review request |
| delivery.failed | Driver arrived, could not deliver | Open a support ticket, schedule a retry |
| cash.reconciled | Driver shift closed, cash counted | Post to your accounting ledger |
npm i deliverpin
pip install deliverpin
composer require deliverpin
Shopify, WooCommerce, Salla and Zid
Illustrative documentation for a concept build. No live API is running behind these endpoints.