{
  "$id": "https://schema.nfh.global/WaitingPolicy/v2.0",
  "x-iri": "https://schema.nfh.global/WaitingPolicy/v2.0",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "WaitingPolicy",
  "type": "object",
  "description": "Rules governing the maximum time a driver is required to wait for a passenger at the pickup location before being permitted to cancel the booking.",
  "properties": {
    "freeWaitingTimeMinutes": {
      "description": "Number of minutes the driver waits for free before charging",
      "type": "number"
    },
    "maxWaitingTimeMinutes": {
      "description": "Maximum total minutes the driver will wait before auto-cancelling",
      "type": "number"
    },
    "chargePerExtraMinute": {
      "description": "Additional charge per minute beyond the free waiting time",
      "type": "number"
    },
    "currency": {
      "description": "ISO 4217 currency code for waiting charges",
      "type": "string"
    },
    "id": {
      "description": "Unique identifier for the policy",
      "type": "string"
    },
    "policyType": {
      "description": "Type of policy (extensible term)",
      "type": "string"
    },
    "descriptor": {
      "description": "Human-readable description of the policy",
      "$ref": "https://schema.nfh.global/Descriptor/v2.1/schema.json"
    },
    "validity": {
      "description": "Validity window for this policy version",
      "$ref": "https://schema.nfh.global/TimePeriod/v2.1/schema.json"
    },
    "policyAttributes": {
      "description": "Extensible domain-specific policy attributes",
      "$ref": "https://schema.nfh.global/Attributes/v2.0/schema.json"
    }
  },
  "additionalProperties": false,
  "x-tags": [
    "mobility",
    "ride-hailing"
  ]
}
