Drop developers

Build same-day delivery into your product.

Create a merchant app in the Drop portal, authenticate with client credentials, quote and create delivery orders, then keep your system in sync with webhooks.

API base URL

https://api.dropsa.co.za

1. Authenticate

POST /oauth/token

2. Quote

POST /v1/pricing/quote

3. Create

POST /v1/orders

4. Track

GET /v1/orders/:id + webhooks

Create a delivery from your backend

bash

curl -X POST https://api.dropsa.co.za/v1/orders \
  -H "Authorization: Bearer <access_token>" \
  -H "Idempotency-Key: checkout-ORD-100245" \
  -H "Content-Type: application/json" \
  -d '{
    "reference": "ORD-100245",
    "channel": "web",
    "serviceType": "SAME_DAY",
    "pickup": { "storeId": "store_jhb_001" },
    "dropoff": {
      "name": "Lebo Ndlovu",
      "phone": "+27821234567",
      "addressLine1": "45 Oxford Road",
      "city": "Johannesburg",
      "country": "ZA",
      "latitude": -26.1367,
      "longitude": 28.0416
    },
    "package": { "size": "SMALL", "weightKg": 1.2 },
    "amount": 499.99,
    "currency": "ZAR"
  }'

Create-order response

json

{
  "request_id": "req_01HXYZ...",
  "order": {
    "id": "ord_01HXYZ...",
    "reference": "ORD-100245",
    "status": "VALIDATED",
    "deliveryPrice": 89.5,
    "currency": "ZAR"
  },
  "dispatch": { "id": "job_01HXYZ..." }
}

Before you start

Create a verified merchant account and merchant API app in the Drop portal.
Keep client secrets on your backend and use an Idempotency-Key for create requests.
Set a pickup store, configure billing, then register a webhook endpoint for delivery updates.

Create account Portal sign in