{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://ucp.dev/2026-08-25/schemas/common/types/network_token_credential.json",
  "title": "Network Token Credential",
  "description": "A card-network token credential verified with a transaction cryptogram. The `number` field carries the network token or wallet-provisioned token rather than the underlying FPAN.",
  "allOf": [
    {
      "$ref": "https://ucp.dev/2026-08-25/schemas/common/types/payment_credential.json"
    },
    {
      "type": "object",
      "required": [
        "type",
        "number",
        "cryptogram"
      ],
      "properties": {
        "type": {
          "const": "network_token",
          "description": "The credential type identifier for network token credentials."
        },
        "number": {
          "type": "string",
          "description": "Network token or wallet-provisioned token replacing the underlying FPAN.",
          "examples": [
            "5204240000004242"
          ]
        },
        "expiry_month": {
          "type": "integer",
          "description": "The month of the token's expiration date (1-12)."
        },
        "expiry_year": {
          "type": "integer",
          "description": "The year of the token's expiration date."
        },
        "name": {
          "type": "string",
          "description": "Cardholder name.",
          "examples": [
            "Jane Doe"
          ]
        },
        "cryptogram": {
          "type": "string",
          "description": "Transaction cryptogram or dynamic CVC (dCVV), in the long or short form expected by the card network or processor.",
          "examples": [
            "gXc5UCLnM6ckD7pjM1TdPA=="
          ]
        },
        "eci_value": {
          "type": "string",
          "description": "Electronic Commerce Indicator / Security Level Indicator associated with the transaction.",
          "examples": [
            "07"
          ]
        },
        "token_requestor_id": {
          "type": "string",
          "description": "Payment network token requestor identifier, when required by the processor or network-token program.",
          "examples": [
            "12345678901"
          ]
        }
      }
    }
  ]
}