ucp.new

{
  "type": "object",
  "properties": {
    "endpoint": {
      "type": "string",
      "maxLength": 2048,
      "description": "Exact HTTPS endpoint advertised in dev.ucp.shopping.permalink; no trailing slash, query, or fragment."
    },
    "items": {
      "type": "array",
      "minItems": 1,
      "maxItems": 50,
      "description": "Exact merchant item or variant identifiers and positive quantities.",
      "items": {
        "type": "object",
        "description": "One exact merchant item and the quantity to initialize.",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 2048,
            "description": "Exact item identifier."
          },
          "quantity": {
            "type": "integer",
            "minimum": 1,
            "maximum": 999,
            "description": "Number of this exact item to initialize, from 1 to 999."
          }
        },
        "required": [
          "id",
          "quantity"
        ],
        "additionalProperties": false
      }
    },
    "continue_to": {
      "type": "string",
      "maxLength": 2048,
      "description": "Optional safe same-origin path beginning with one slash, such as /collections/sale."
    },
    "discount_codes": {
      "type": "array",
      "maxItems": 20,
      "description": "Optional discount codes explicitly requested by the user, in application order.",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 128,
        "description": "One exact merchant discount code."
      }
    },
    "country": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "Optional ISO 3166-1 alpha-2 country code."
    },
    "postal_code": {
      "type": "string",
      "maxLength": 32,
      "description": "Optional buyer postal code used to initialize merchant context."
    },
    "language": {
      "type": "string",
      "maxLength": 35,
      "description": "Optional BCP 47 language tag."
    },
    "attribution_ref": {
      "type": "string",
      "maxLength": 256,
      "description": "Optional non-sensitive attribution reference explicitly supplied by the user."
    },
    "utm_source": {
      "type": "string",
      "maxLength": 256,
      "description": "Optional UTM source explicitly supplied by the user."
    }
  },
  "required": [
    "endpoint",
    "items"
  ],
  "additionalProperties": false
}