Drop developers

Find an order by reference

Look up an order using the stable merchant reference from your checkout or source system.

Endpoint

GET https://api.dropsa.co.za/v1/orders?reference=ORD-100245

Required scope

orders:read

200 OK

json
{
  "request_id": "req_01HXYZ...",
  "order": {
    "id": "ord_01HXYZ...",
    "reference": "ORD-100245",
    "status": "VALIDATED"
  }
}

cURL

bash
curl "https://api.dropsa.co.za/v1/orders?reference=ORD-100245" \
  -H "Authorization: Bearer <access_token>"

Implementation notes

  • reference is required and should remain stable between your source system, retries and support conversations.