BigCommerce · Schema

Rate Options Schema

A set of carrier-specific fields that will be displayed to shoppers at checkout.

E-CommerceRetailCatalogOrdersCheckoutPaymentsSaaS
View JSON Schema on GitHub

JSON Schema

bigcommerce-rateoptionsschema-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/RateOptionsSchema",
  "title": "Rate Options Schema",
  "description": "A set of carrier-specific fields that will be displayed to shoppers at checkout.",
  "type": "array",
  "items": {
    "description": "Options, ranges, defaults, and validation for a carrier-defined field that displays at checkout.",
    "type": "object",
    "properties": {
      "code": {
        "description": "The internal code that represents this input field.",
        "type": "string"
      },
      "label": {
        "description": "Display name for this input field.",
        "type": "string"
      },
      "description": {
        "description": "Longer description text to be displayed as a tooltip at checkout.",
        "type": "string"
      },
      "validation": {
        "description": "Placeholder for any validation we choose to implement.",
        "type": "string"
      },
      "type": {
        "description": "How this input will be displayed.",
        "type": "string",
        "enum": [
          "date",
          "string",
          "select",
          "code"
        ]
      },
      "default_value": {
        "description": "A valid default value for this field.",
        "type": "string"
      },
      "value_options": {
        "description": "The list of options available for `select` type fields.",
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "date_ranges": {
        "description": "The set of valid date ranges for `date` type fields.",
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "from": {
              "type": "object",
              "properties": {
                "date": {
                  "type": "string",
                  "format": "date"
                },
                "timezone": {
                  "type": "string"
                }
              },
              "title": "Date Value",
              "description": "Value Object representing a Date."
            },
            "to": {
              "type": "object",
              "properties": {
                "date": {
                  "type": "string",
                  "format": "date"
                },
                "timezone": {
                  "type": "string"
                }
              },
              "title": "Date Value",
              "description": "Value Object representing a Date."
            }
          },
          "title": "Date Range",
          "description": "Representation of a range of date objects."
        }
      }
    },
    "required": [
      "code",
      "label",
      "type",
      "default_value"
    ],
    "title": "Key Value Pair Schema"
  },
  "x-internal": false
}