{
  "$id": "https://schema.nfh.global/FareMedium/v2.0",
  "x-iri": "https://schema.nfh.global/FareMedium/v2.0",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "FareMedium",
  "type": "object",
  "description": "The physical or digital medium used to carry or present a fare product, such as a contactless card, mobile app, or paper ticket.",
  "properties": {
    "mediumType": {
      "description": "Type of fare medium (e.g. CONTACTLESS_CARD, MOBILE_APP, PAPER_TICKET, QR_CODE)",
      "type": "string"
    },
    "mediumId": {
      "description": "Unique identifier or number of the physical or digital medium",
      "type": "string"
    },
    "id": {
      "description": "Unique identifier for the entitlement",
      "type": "string"
    },
    "descriptor": {
      "description": "Human-readable information about the entitlement",
      "$ref": "https://schema.nfh.global/Descriptor/v2.1/schema.json"
    },
    "resource": {
      "description": "The resource being accessed against this entitlement",
      "$ref": "https://schema.nfh.global/ContractItem/v2.0/schema.json"
    },
    "credentials": {
      "description": "Credential descriptors for the entitlement",
      "$ref": "https://schema.nfh.global/Descriptor/v2.1/schema.json"
    }
  },
  "additionalProperties": false,
  "x-tags": [
    "mobility",
    "ride-hailing"
  ]
}