# Step 1: Get OAuth token
curl -X POST https://dropmerce.com/api/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "CLI-SHOPEASY-GH-X7K2",
    "client_secret": "sk_live_dropmerce_..."
  }'

# Response
{
  "access_token": "eyJ0eXAiOiJKV1Qi...",
  "expires_in": 3600
}

# Create Package
POST   /api/packages
# Get Package
GET    /api/packages/{ref}
# Track Package
GET    /api/packages/{ref}/track
# List My Packages
GET    /api/packages?page=1&status=at_hub
# Get Nearest Hubs
POST   /api/routing/nearest
# Calculate Transfer Fee
POST   /api/routing/transfer-fee
# List All Hubs
GET    /api/hubs
# Search Hubs
GET    /api/hubs/search?query=kasoa

POST /api/packages
Authorization: Bearer {your_token}

{
  "order_ref":          "YOUR-ORDER-001",
  "salliba_order_id":   "optional",
  "seller_name":        "Ama Textiles",
  "seller_phone":       "0241000001",
  "buyer_name":         "Kweku Asante",
  "buyer_phone":        "0201987654",
  "origin_hub_id":      1,
  "destination_hub_id": 3,
  "product_value":      250.00,
  "pickup_fee":         8.00,
  "size_category":      "small",
  "insured":            true
}

# Response 201 Created
{
  "success": true,
  "data": {
    "package_ref":    "PKG-2026-XXXX",
    "collection_pin": "7734",
    "qr_data":        "base64_encoded_qr...",
    "expires_at":     "2026-04-08T00:00:00Z"
  }
}