curl -X POST "https://api.chidori.africa/enterprise-service/api/deliveries/cancel" \
  -H "X-API-Key: sk_live_xxx.yyy" \
  -H "Content-Type: application/json" \
  -d '{
    "deliveryId": "abc123-def456-ghi789",
    "reason": "Customer changed their mind"
  }'

const response = await fetch(
  'https://api.chidori.africa/enterprise-service/api/deliveries/cancel',
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'sk_live_xxx.yyy',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      deliveryId: 'abc123-def456-ghi789',
      reason: 'Customer changed their mind',
    }),
  }
);

const data = await response.json();

import requests

response = requests.post(
    'https://api.chidori.africa/enterprise-service/api/deliveries/cancel',
    headers={
        'X-API-Key': 'sk_live_xxx.yyy',
        'Content-Type': 'application/json',
    },
    json={
        'deliveryId': 'abc123-def456-ghi789',
        'reason': 'Customer changed their mind',
    },
)

data = response.json()

{
  "status": true,
  "data": {
    "cancelled": [
      {
        "id": "abc123-def456-ghi789",
        "trackingId": "a1b2c3d4e5f6",
        "bulk": null
      }
    ],
    "refundAmount": 2500,
    "refundChannel": "Wallet",
    "refundTransactionId": "5d8b3c0e9f4a4f12bc7e9d2a1f3c4e5d"
  }
}

{
  "status": true,
  "data": {
    "cancelled": [
      { "id": "11111111-1111-1111-1111-111111111111", "trackingId": "aaaaaaaaaaaa", "bulk": "bulk-uuid-123" },
      { "id": "22222222-2222-2222-2222-222222222222", "trackingId": "bbbbbbbbbbbb", "bulk": "bulk-uuid-123" },
      { "id": "33333333-3333-3333-3333-333333333333", "trackingId": "cccccccccccc", "bulk": "bulk-uuid-123" }
    ],
    "refundAmount": 7500,
    "refundChannel": "Wallet",
    "refundTransactionId": "7e2a1b3d4c5f6a7b8c9d0e1f2a3b4c5d"
  }
}

{
  "status": true,
  "data": {
    "cancelled": [
      {
        "id": "abc123-def456-ghi789",
        "trackingId": "a1b2c3d4e5f6",
        "bulk": null
      }
    ],
    "refundAmount": 0,
    "refundChannel": null,
    "refundTransactionId": null
  }
}

{
  "status": true,
  "message": "Delivery already cancelled",
  "data": {
    "cancelled": [
      { "id": "abc123-def456-ghi789", "trackingId": "a1b2c3d4e5f6", "bulk": null }
    ],
    "refundAmount": 0,
    "refundChannel": null,
    "refundTransactionId": null
  }
}

{
  "message": "deliveryId must be a valid UUID"
}

{
  "message": "Delivery not found"
}

{
  "message": "Only PENDING deliveries can be cancelled (current status: STARTED)"
}

{
  "message": "Cannot cancel bulk: one or more siblings are no longer PENDING"
}