{
  "type": "object",
  "title": "TaxProductResourceLineItemTaxRateDetails",
  "required": [
    "display_name",
    "percentage_decimal",
    "tax_type"
  ],
  "properties": {
    "tax_type": {
      "enum": [
        "amusement_tax",
        "communications_tax",
        "gst",
        "hst",
        "igst",
        "jct",
        "lease_tax",
        "pst",
        "qst",
        "retail_delivery_fee",
        "rst",
        "sales_tax",
        "service_tax",
        "vat"
      ],
      "type": "string",
      "description": "The tax type, such as `vat` or `sales_tax`.",
      "x-stripeBypassValidation": true
    },
    "display_name": {
      "type": "string",
      "maxLength": 5000,
      "description": "A localized display name for tax type, intended to be human-readable. For example, \"Local Sales and Use Tax\", \"Value-added tax (VAT)\", or \"Umsatzsteuer (USt.)\"."
    },
    "percentage_decimal": {
      "type": "string",
      "maxLength": 5000,
      "description": "The tax rate percentage as a string. For example, 8.5% is represented as \"8.5\"."
    }
  },
  "description": "",
  "x-expandableFields": []
}

{
  "type": "object",
  "title": "TaxProductResourcePostalAddress",
  "required": [
    "country"
  ],
  "properties": {
    "city": {
      "type": "string",
      "nullable": true,
      "maxLength": 5000,
      "description": "City, district, suburb, town, or village."
    },
    "line1": {
      "type": "string",
      "nullable": true,
      "maxLength": 5000,
      "description": "Address line 1, such as the street, PO Box, or company name."
    },
    "line2": {
      "type": "string",
      "nullable": true,
      "maxLength": 5000,
      "description": "Address line 2, such as the apartment, suite, unit, or building."
    },
    "state": {
      "type": "string",
      "nullable": true,
      "maxLength": 5000,
      "description": "State/province as an [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) subdivision code, without country prefix, such as \"NY\" or \"TX\"."
    },
    "country": {
      "type": "string",
      "maxLength": 5000,
      "description": "Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2))."
    },
    "postal_code": {
      "type": "string",
      "nullable": true,
      "maxLength": 5000,
      "description": "ZIP or postal code."
    }
  },
  "description": "",
  "x-expandableFields": []
}

{
  "type": "object",
  "title": "TaxProductResourceShipFromDetails",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "$ref": "#/components/schemas/tax_product_resource_postal_address"
    }
  },
  "description": "",
  "x-expandableFields": [
    "address"
  ]
}

{
  "type": "object",
  "title": "TaxProductResourceTaxAssociationTransactionAttempts",
  "required": [
    "source",
    "status"
  ],
  "properties": {
    "source": {
      "type": "string",
      "maxLength": 5000,
      "description": "The source of the tax transaction attempt. This is either a refund or a payment intent."
    },
    "status": {
      "type": "string",
      "maxLength": 5000,
      "description": "The status of the transaction attempt. This can be `errored` or `committed`."
    },
    "errored": {
      "$ref": "#/components/schemas/tax_product_resource_tax_association_transaction_attempts_resource_errored"
    },
    "committed": {
      "$ref": "#/components/schemas/tax_product_resource_tax_association_transaction_attempts_resource_committed"
    }
  },
  "description": "",
  "x-expandableFields": [
    "committed",
    "errored"
  ]
}

{
  "type": "object",
  "title": "TaxProductResourceTaxAssociationTransactionAttemptsResourceCommitted",
  "required": [
    "transaction"
  ],
  "properties": {
    "transaction": {
      "type": "string",
      "maxLength": 5000,
      "description": "The [Tax Transaction](https://docs.stripe.com/api/tax/transaction/object)"
    }
  },
  "description": "",
  "x-expandableFields": []
}

{
  "type": "object",
  "title": "TaxProductResourceTaxAssociationTransactionAttemptsResourceErrored",
  "required": [
    "reason"
  ],
  "properties": {
    "reason": {
      "enum": [
        "another_payment_associated_with_calculation",
        "calculation_expired",
        "currency_mismatch",
        "original_transaction_voided",
        "unique_reference_violation"
      ],
      "type": "string",
      "description": "Details on why we couldn't commit the tax transaction."
    }
  },
  "description": "",
  "x-expandableFields": []
}

{
  "type": "object",
  "title": "TaxProductResourceTaxBreakdown",
  "required": [
    "amount",
    "inclusive",
    "tax_rate_details",
    "taxability_reason",
    "taxable_amount"
  ],
  "properties": {
    "amount": {
      "type": "integer",
      "description": "The amount of tax, in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units)."
    },
    "inclusive": {
      "type": "boolean",
      "description": "Specifies whether the tax amount is included in the line item amount."
    },
    "taxable_amount": {
      "type": "integer",
      "description": "The amount on which tax is calculated, in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units)."
    },
    "tax_rate_details": {
      "$ref": "#/components/schemas/tax_product_resource_tax_rate_details"
    },
    "taxability_reason": {
      "enum": [
        "customer_exempt",
        "not_collecting",
        "not_subject_to_tax",
        "not_supported",
        "portion_product_exempt",
        "portion_reduced_rated",
        "portion_standard_rated",
        "product_exempt",
        "product_exempt_holiday",
        "proportionally_rated",
        "reduced_rated",
        "reverse_charge",
        "standard_rated",
        "taxable_basis_reduced",
        "zero_rated"
      ],
      "type": "string",
      "description": "The reasoning behind this tax, for example, if the product is tax exempt. We might extend the possible values for this field to support new tax rules."
    }
  },
  "description": "",
  "x-expandableFields": [
    "tax_rate_details"
  ]
}

{
  "type": "object",
  "title": "TaxProductResourceTaxCalculationShippingCost",
  "required": [
    "amount",
    "amount_tax",
    "tax_behavior",
    "tax_code"
  ],
  "properties": {
    "amount": {
      "type": "integer",
      "description": "The shipping amount in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount."
    },
    "tax_code": {
      "type": "string",
      "maxLength": 5000,
      "description": "The [tax code](https://docs.stripe.com/tax/tax-categories) ID used for shipping."
    },
    "amount_tax": {
      "type": "integer",
      "description": "The amount of tax calculated for shipping, in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units)."
    },
    "tax_behavior": {
      "enum": [
        "exclusive",
        "inclusive"
      ],
      "type": "string",
      "description": "Specifies whether the `amount` includes taxes. If `tax_behavior=inclusive`, then the amount includes taxes."
    },
    "shipping_rate": {
      "type": "string",
      "maxLength": 5000,
      "description": "The ID of an existing [ShippingRate](https://docs.stripe.com/api/shipping_rates/object)."
    },
    "tax_breakdown": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/tax_product_resource_line_item_tax_breakdown"
      },
      "description": "Detailed account of taxes relevant to shipping cost."
    }
  },
  "description": "",
  "x-expandableFields": [
    "tax_breakdown"
  ]
}

{
  "type": "object",
  "title": "TaxProductResourceTaxRateDetails",
  "required": [
    "percentage_decimal"
  ],
  "properties": {
    "state": {
      "type": "string",
      "nullable": true,
      "maxLength": 5000,
      "description": "State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2))."
    },
    "country": {
      "type": "string",
      "nullable": true,
      "maxLength": 5000,
      "description": "Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2))."
    },
    "tax_type": {
      "enum": [
        "amusement_tax",
        "communications_tax",
        "gst",
        "hst",
        "igst",
        "jct",
        "lease_tax",
        "pst",
        "qst",
        "retail_delivery_fee",
        "rst",
        "sales_tax",
        "service_tax",
        "vat"
      ],
      "type": "string",
      "nullable": true,
      "description": "The tax type, such as `vat` or `sales_tax`.",
      "x-stripeBypassValidation": true
    },
    "rate_type": {
      "enum": [
        "flat_amount",
        "percentage"
      ],
      "type": "string",
      "nullable": true,
      "description": "Indicates the type of tax rate applied to the taxable amount. This value can be `null` when no tax applies to the location. This field is only present for TaxRates created by Stripe Tax."
    },
    "flat_amount": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/tax_rate_flat_amount"
        }
      ],
      "nullable": true,
      "description": "The amount of the tax rate when the `rate_type` is `flat_amount`. Tax rates with `rate_type` `percentage` can vary based on the transaction, resulting in this field being `null`. This field exposes the amount and currency of the flat tax rate."
    },
    "percentage_decimal": {
      "type": "string",
      "maxLength": 5000,
      "description": "The tax rate percentage as a string. For example, 8.5% is represented as `\"8.5\"`."
    }
  },
  "description": "",
  "x-expandableFields": [
    "flat_amount"
  ]
}

{
  "type": "object",
  "title": "TaxProductResourceTaxSettingsDefaults",
  "required": [
    "provider"
  ],
  "properties": {
    "provider": {
      "enum": [
        "anrok",
        "avalara",
        "sphere",
        "stripe"
      ],
      "type": "string",
      "description": "The tax calculation provider this account uses. Defaults to `stripe` when not using a [third-party provider](/tax/third-party-apps)."
    },
    "tax_code": {
      "type": "string",
      "nullable": true,
      "maxLength": 5000,
      "description": "Default [tax code](https://stripe.com/docs/tax/tax-categories) used to classify your products and prices."
    },
    "tax_behavior": {
      "enum": [
        "exclusive",
        "inclusive",
        "inferred_by_currency"
      ],
      "type": "string",
      "nullable": true,
      "description": "Default [tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#tax-behavior) used to specify whether the price is considered inclusive of taxes or exclusive of taxes. If the item's price has a tax behavior set, it will take precedence over the default tax behavior."
    }
  },
  "description": "",
  "x-expandableFields": []
}

{
  "type": "object",
  "title": "TaxProductResourceTaxSettingsHeadOffice",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "$ref": "#/components/schemas/address"
    }
  },
  "description": "",
  "x-expandableFields": [
    "address"
  ]
}

{
  "type": "object",
  "title": "TaxProductResourceTaxSettingsStatusDetails",
  "properties": {
    "active": {
      "$ref": "#/components/schemas/tax_product_resource_tax_settings_status_details_resource_active"
    },
    "pending": {
      "$ref": "#/components/schemas/tax_product_resource_tax_settings_status_details_resource_pending"
    }
  },
  "description": "",
  "x-expandableFields": [
    "active",
    "pending"
  ]
}

{
  "type": "object",
  "title": "TaxProductResourceTaxSettingsStatusDetailsResourceActive",
  "properties": {},
  "description": "",
  "x-expandableFields": []
}

{
  "type": "object",
  "title": "TaxProductResourceTaxSettingsStatusDetailsResourcePending",
  "properties": {
    "missing_fields": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 5000
      },
      "nullable": true,
      "description": "The list of missing fields that are required to perform calculations. It includes the entry `head_office` when the status is `pending`. It is recommended to set the optional values even if they aren't listed as required for calculating taxes. Calculations can fail if missing fields aren't explicitly provided on every call."
    }
  },
  "description": "",
  "x-expandableFields": []
}

{
  "type": "object",
  "title": "TaxProductResourceTaxTransactionLineItemResourceReversal",
  "required": [
    "original_line_item"
  ],
  "properties": {
    "original_line_item": {
      "type": "string",
      "maxLength": 5000,
      "description": "The `id` of the line item to reverse in the original transaction."
    }
  },
  "description": "",
  "x-expandableFields": []
}

{
  "type": "object",
  "title": "TaxProductResourceTaxTransactionResourceReversal",
  "properties": {
    "original_transaction": {
      "type": "string",
      "nullable": true,
      "maxLength": 5000,
      "description": "The `id` of the reversed `Transaction` object."
    }
  },
  "description": "",
  "x-expandableFields": []
}

{
  "type": "object",
  "title": "TaxProductResourceTaxTransactionShippingCost",
  "required": [
    "amount",
    "amount_tax",
    "tax_behavior",
    "tax_code"
  ],
  "properties": {
    "amount": {
      "type": "integer",
      "description": "The shipping amount in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount."
    },
    "tax_code": {
      "type": "string",
      "maxLength": 5000,
      "description": "The [tax code](https://docs.stripe.com/tax/tax-categories) ID used for shipping."
    },
    "amount_tax": {
      "type": "integer",
      "description": "The amount of tax calculated for shipping, in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units)."
    },
    "tax_behavior": {
      "enum": [
        "exclusive",
        "inclusive"
      ],
      "type": "string",
      "description": "Specifies whether the `amount` includes taxes. If `tax_behavior=inclusive`, then the amount includes taxes."
    },
    "shipping_rate": {
      "type": "string",
      "maxLength": 5000,
      "description": "The ID of an existing [ShippingRate](https://docs.stripe.com/api/shipping_rates/object)."
    }
  },
  "description": "",
  "x-expandableFields": []
}

{
  "type": "object",
  "title": "TaxRate",
  "required": [
    "active",
    "created",
    "display_name",
    "id",
    "inclusive",
    "livemode",
    "object",
    "percentage"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 5000,
      "description": "Unique identifier for the object."
    },
    "state": {
      "type": "string",
      "nullable": true,
      "maxLength": 5000,
      "description": "[ISO 3166-2 subdivision code](https://en.wikipedia.org/wiki/ISO_3166-2), without country prefix. For example, \"NY\" for New York, United States."
    },
    "active": {
      "type": "boolean",
      "description": "Defaults to `true`. When set to `false`, this tax rate cannot be used with new applications or Checkout Sessions, but will still work for subscriptions and invoices that already have it set."
    },
    "object": {
      "enum": [
        "tax_rate"
      ],
      "type": "string",
      "description": "String representing the object's type. Objects of the same type share the same value."
    },
    "country": {
      "type": "string",
      "nullable": true,
      "maxLength": 5000,
      "description": "Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2))."
    },
    "created": {
      "type": "integer",
      "format": "unix-time",
      "description": "Time at which the object was created. Measured in seconds since the Unix epoch."
    },
    "livemode": {
      "type": "boolean",
      "description": "If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`."
    },
    "metadata": {
      "type": "object",
      "nullable": true,
      "description": "Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.",
      "additionalProperties": {
        "type": "string",
        "maxLength": 500
      }
    },
    "tax_type": {
      "enum": [
        "amusement_tax",
        "communications_tax",
        "gst",
        "hst",
        "igst",
        "jct",
        "lease_tax",
        "pst",
        "qst",
        "retail_delivery_fee",
        "rst",
        "sales_tax",
        "service_tax",
        "vat"
      ],
      "type": "string",
      "nullable": true,
      "description": "The high-level tax type, such as `vat` or `sales_tax`.",
      "x-stripeBypassValidation": true
    },
    "inclusive": {
      "type": "boolean",
      "description": "This specifies if the tax rate is inclusive or exclusive."
    },
    "rate_type": {
      "enum": [
        "flat_amount",
        "percentage"
      ],
      "type": "string",
      "nullable": true,
      "description": "Indicates the type of tax rate applied to the taxable amount. This value can be `null` when no tax applies to the location. This field is only present for TaxRates created by Stripe Tax."
    },
    "percentage": {
      "type": "number",
      "description": "Tax rate percentage out of 100. For tax calculations with automatic_tax[enabled]=true, this percentage includes the statutory tax rate of non-taxable jurisdictions."
    },
    "description": {
      "type": "string",
      "nullable": true,
      "maxLength": 5000,
      "description": "An arbitrary string attached to the tax rate for your internal use only. It will not be visible to your customers."
    },
    "flat_amount": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/tax_rate_flat_amount"
        }
      ],
      "nullable": true,
      "description": "The amount of the tax rate when the `rate_type` is `flat_amount`. Tax rates with `rate_type` `percentage` can vary based on the transaction, resulting in this field being `null`. This field exposes the amount and currency of the flat tax rate."
    },
    "display_name": {
      "type": "string",
      "maxLength": 5000,
      "description": "The display name of the tax rates as it will appear to your customer on their receipt email, PDF, and the hosted invoice page."
    },
    "jurisdiction": {
      "type": "string",
      "nullable": true,
      "maxLength": 5000,
      "description": "The jurisdiction for the tax rate. You can use this label field for tax reporting purposes. It also appears on your customer’s invoice."
    },
    "jurisdiction_level": {
      "enum": [
        "city",
        "country",
        "county",
        "district",
        "multiple",
        "state"
      ],
      "type": "string",
      "nullable": true,
      "description": "The level of the jurisdiction that imposes this tax rate. Will be `null` for manually defined tax rates."
    },
    "effective_percentage": {
      "type": "number",
      "nullable": true,
      "description": "Actual/effective tax rate percentage out of 100. For tax calculations with automatic_tax[enabled]=true,\nthis percentage reflects the rate actually used to calculate tax based on the product's taxability\nand whether the user is registered to collect taxes in the corresponding jurisdiction."
    }
  },
  "description": "Tax rates can be applied to [invoices](/invoicing/taxes/tax-rates), [subscriptions](/billing/taxes/tax-rates) and [Checkout Sessions](/payments/checkout/use-manual-tax-rates) to collect tax.\n\nRelated guide: [Tax rates](/billing/taxes/tax-rates)",
  "x-resourceId": "tax_rate",
  "x-expandableFields": [
    "flat_amount"
  ]
}

{
  "type": "object",
  "title": "TaxRateFlatAmount",
  "required": [
    "amount",
    "currency"
  ],
  "properties": {
    "amount": {
      "type": "integer",
      "description": "Amount of the tax when the `rate_type` is `flat_amount`. This positive integer represents how much to charge in the smallest currency unit (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99)."
    },
    "currency": {
      "type": "string",
      "maxLength": 5000,
      "description": "Three-letter ISO currency code, in lowercase."
    }
  },
  "description": "The amount of the tax rate when the `rate_type`` is `flat_amount`. Tax rates with `rate_type` `percentage` can vary based on the transaction, resulting in this field being `null`. This field exposes the amount and currency of the flat tax rate.",
  "x-expandableFields": []
}

{
  "type": "object",
  "title": "TerminalConfigurationConfiguration",
  "required": [
    "id",
    "livemode",
    "object"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 5000,
      "description": "Unique identifier for the object."
    },
    "name": {
      "type": "string",
      "nullable": true,
      "maxLength": 5000,
      "description": "String indicating the name of the Configuration object, set by the user"
    },
    "wifi": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_wifi_config"
    },
    "object": {
      "enum": [
        "terminal.configuration"
      ],
      "type": "string",
      "description": "String representing the object's type. Objects of the same type share the same value."
    },
    "offline": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_offline_config"
    },
    "tipping": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_tipping"
    },
    "cellular": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_cellular_config"
    },
    "livemode": {
      "type": "boolean",
      "description": "If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`."
    },
    "stripe_s700": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_device_type_specific_config"
    },
    "stripe_s710": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_device_type_specific_config"
    },
    "reboot_window": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_reboot_window"
    },
    "verifone_p400": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_device_type_specific_config"
    },
    "bbpos_wisepad3": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_device_type_specific_config"
    },
    "bbpos_wisepos_e": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_device_type_specific_config"
    },
    "is_account_default": {
      "type": "boolean",
      "nullable": true,
      "description": "Whether this Configuration is the default for your account"
    }
  },
  "description": "A Configurations object represents how features should be configured for terminal readers.\nFor information about how to use it, see the [Terminal configurations documentation](https://docs.stripe.com/terminal/fleet/configurations-overview).",
  "x-resourceId": "terminal.configuration",
  "x-expandableFields": [
    "bbpos_wisepad3",
    "bbpos_wisepos_e",
    "cellular",
    "offline",
    "reboot_window",
    "stripe_s700",
    "stripe_s710",
    "tipping",
    "verifone_p400",
    "wifi"
  ]
}

{
  "type": "object",
  "title": "TerminalConnectionToken",
  "required": [
    "object",
    "secret"
  ],
  "properties": {
    "object": {
      "enum": [
        "terminal.connection_token"
      ],
      "type": "string",
      "description": "String representing the object's type. Objects of the same type share the same value."
    },
    "secret": {
      "type": "string",
      "maxLength": 5000,
      "description": "Your application should pass this token to the Stripe Terminal SDK."
    },
    "location": {
      "type": "string",
      "maxLength": 5000,
      "description": "The id of the location that this connection token is scoped to. Note that location scoping only applies to internet-connected readers. For more details, see [the docs on scoping connection tokens](https://docs.stripe.com/terminal/fleet/locations-and-zones?dashboard-or-api=api#connection-tokens)."
    }
  },
  "description": "A Connection Token is used by the Stripe Terminal SDK to connect to a reader.\n\nRelated guide: [Fleet management](https://docs.stripe.com/terminal/fleet/locations)",
  "x-resourceId": "terminal.connection_token",
  "x-expandableFields": []
}

{
  "type": "object",
  "title": "TerminalLocationLocation",
  "required": [
    "address",
    "display_name",
    "id",
    "livemode",
    "metadata",
    "object"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 5000,
      "description": "Unique identifier for the object."
    },
    "phone": {
      "type": "string",
      "maxLength": 5000,
      "description": "The phone number of the location."
    },
    "object": {
      "enum": [
        "terminal.location"
      ],
      "type": "string",
      "description": "String representing the object's type. Objects of the same type share the same value."
    },
    "address": {
      "$ref": "#/components/schemas/address"
    },
    "livemode": {
      "type": "boolean",
      "description": "If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`."
    },
    "metadata": {
      "type": "object",
      "description": "Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.",
      "additionalProperties": {
        "type": "string",
        "maxLength": 500
      }
    },
    "address_kana": {
      "$ref": "#/components/schemas/legal_entity_japan_address"
    },
    "display_name": {
      "type": "string",
      "maxLength": 5000,
      "description": "The display name of the location."
    },
    "address_kanji": {
      "$ref": "#/components/schemas/legal_entity_japan_address"
    },
    "display_name_kana": {
      "type": "string",
      "maxLength": 5000,
      "description": "The Kana variation of the display name of the location."
    },
    "display_name_kanji": {
      "type": "string",
      "maxLength": 5000,
      "description": "The Kanji variation of the display name of the location."
    },
    "configuration_overrides": {
      "type": "string",
      "maxLength": 5000,
      "description": "The ID of a configuration that will be used to customize all readers in this location."
    }
  },
  "description": "A Location represents a grouping of readers.\n\nRelated guide: [Fleet management](https://docs.stripe.com/terminal/fleet/locations)",
  "x-resourceId": "terminal.location",
  "x-expandableFields": [
    "address",
    "address_kana",
    "address_kanji"
  ]
}

{
  "type": "object",
  "title": "TerminalOnboardingLinkOnboardingLink",
  "required": [
    "link_options",
    "link_type",
    "object",
    "redirect_url"
  ],
  "properties": {
    "object": {
      "enum": [
        "terminal.onboarding_link"
      ],
      "type": "string"
    },
    "link_type": {
      "enum": [
        "apple_terms_and_conditions"
      ],
      "type": "string",
      "description": "The type of link being generated."
    },
    "link_options": {
      "$ref": "#/components/schemas/terminal_onboarding_link_link_options"
    },
    "on_behalf_of": {
      "type": "string",
      "nullable": true,
      "maxLength": 5000,
      "description": "Stripe account ID to generate the link for."
    },
    "redirect_url": {
      "type": "string",
      "maxLength": 5000,
      "description": "The link passed back to the user for their onboarding."
    }
  },
  "description": "Returns redirect links used for onboarding onto Tap to Pay on iPhone.",
  "x-resourceId": "terminal.onboarding_link",
  "x-expandableFields": [
    "link_options"
  ]
}

{
  "type": "object",
  "title": "TerminalReaderReader",
  "required": [
    "device_type",
    "id",
    "label",
    "livemode",
    "metadata",
    "object",
    "serial_number"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 5000,
      "description": "Unique identifier for the object."
    },
    "label": {
      "type": "string",
      "maxLength": 5000,
      "description": "Custom label given to the reader for easier identification."
    },
    "action": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/terminal_reader_reader_resource_reader_action"
        }
      ],
      "nullable": true,
      "description": "The most recent action performed by the reader."
    },
    "object": {
      "enum": [
        "terminal.reader"
      ],
      "type": "string",
      "description": "String representing the object's type. Objects of the same type share the same value."
    },
    "status": {
      "enum": [
        "offline",
        "online"
      ],
      "type": "string",
      "nullable": true,
      "description": "The networking status of the reader. We do not recommend using this field in flows that may block taking payments."
    },
    "livemode": {
      "type": "boolean",
      "description": "If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`."
    },
    "location": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 5000
        },
        {
          "$ref": "#/components/schemas/terminal.location"
        }
      ],
      "nullable": true,
      "description": "The location identifier of the reader.",
      "x-expansionResources": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/terminal.location"
          }
        ]
      }
    },
    "metadata": {
      "type": "object",
      "description": "Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.",
      "additionalProperties": {
        "type": "string",
        "maxLength": 500
      }
    },
    "ip_address": {
      "type": "string",
      "nullable": true,
      "maxLength": 5000,
      "description": "The local IP address of the reader."
    },
    "device_type": {
      "enum": [
        "bbpos_chipper2x",
        "bbpos_wisepad3",
        "bbpos_wisepos_e",
        "mobile_phone_reader",
        "simulated_stripe_s700",
        "simulated_stripe_s710",
        "simulated_wisepos_e",
        "stripe_m2",
        "stripe_s700",
        "stripe_s710",
        "verifone_P400"
      ],
      "type": "string",
      "description": "Device type of the reader.",
      "x-stripeBypassValidation": true
    },
    "last_seen_at": {
      "type": "integer",
      "format": "unix-time",
      "nullable": true,
      "description": "The last time this reader reported to Stripe backend. Timestamp is measured in milliseconds since the Unix epoch. Unlike most other Stripe timestamp fields which use seconds, this field uses milliseconds."
    },
    "serial_number": {
      "type": "string",
      "maxLength": 5000,
      "description": "Serial number of the reader."
    },
    "device_sw_version": {
      "type": "string",
      "nullable": true,
      "maxLength": 5000,
      "description": "The current software version of the reader."
    }
  },
  "description": "A Reader represents a physical device for accepting payment details.\n\nRelated guide: [Connecting to a reader](https://docs.stripe.com/terminal/payments/connect-reader)",
  "x-resourceId": "terminal.reader",
  "x-expandableFields": [
    "action",
    "location"
  ]
}

{
  "type": "object",
  "title": "TerminalRefundsRefund",
  "properties": {},
  "description": "A Refund object returned by the Terminal refunds API.",
  "x-resourceId": "terminal.refund",
  "x-expandableFields": []
}

{
  "type": "object",
  "title": "TerminalConfigurationConfigurationResourceCellularConfig",
  "required": [
    "enabled"
  ],
  "properties": {
    "enabled": {
      "type": "boolean",
      "description": "Whether a cellular-capable reader can connect to the internet over cellular."
    }
  },
  "description": "",
  "x-expandableFields": []
}

{
  "type": "object",
  "title": "TerminalConfigurationConfigurationResourceCurrencySpecificConfig",
  "properties": {
    "percentages": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "nullable": true,
      "description": "Percentages displayed when collecting a tip"
    },
    "fixed_amounts": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "nullable": true,
      "description": "Fixed amounts displayed when collecting a tip"
    },
    "smart_tip_threshold": {
      "type": "integer",
      "description": "Below this amount, fixed amounts will be displayed; above it, percentages will be displayed"
    }
  },
  "description": "",
  "x-expandableFields": []
}

{
  "type": "object",
  "title": "TerminalConfigurationConfigurationResourceDeviceTypeSpecificConfig",
  "properties": {
    "splashscreen": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 5000
        },
        {
          "$ref": "#/components/schemas/file"
        }
      ],
      "description": "A File ID representing an image to display on the reader",
      "x-expansionResources": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/file"
          }
        ]
      }
    }
  },
  "description": "",
  "x-expandableFields": [
    "splashscreen"
  ]
}

{
  "type": "object",
  "title": "TerminalConfigurationConfigurationResourceEnterprisePEAPWifi",
  "required": [
    "password",
    "ssid",
    "username"
  ],
  "properties": {
    "ssid": {
      "type": "string",
      "maxLength": 5000,
      "description": "Name of the WiFi network"
    },
    "password": {
      "type": "string",
      "maxLength": 5000,
      "description": "Password for connecting to the WiFi network"
    },
    "username": {
      "type": "string",
      "maxLength": 5000,
      "description": "Username for connecting to the WiFi network"
    },
    "ca_certificate_file": {
      "type": "string",
      "maxLength": 5000,
      "description": "A File ID representing a PEM file containing the server certificate"
    }
  },
  "description": "",
  "x-expandableFields": []
}

{
  "type": "object",
  "title": "TerminalConfigurationConfigurationResourceEnterpriseTLSWifi",
  "required": [
    "client_certificate_file",
    "private_key_file",
    "ssid"
  ],
  "properties": {
    "ssid": {
      "type": "string",
      "maxLength": 5000,
      "description": "Name of the WiFi network"
    },
    "private_key_file": {
      "type": "string",
      "maxLength": 5000,
      "description": "A File ID representing a PEM file containing the client RSA private key"
    },
    "ca_certificate_file": {
      "type": "string",
      "maxLength": 5000,
      "description": "A File ID representing a PEM file containing the server certificate"
    },
    "client_certificate_file": {
      "type": "string",
      "maxLength": 5000,
      "description": "A File ID representing a PEM file containing the client certificate"
    },
    "private_key_file_password": {
      "type": "string",
      "maxLength": 5000,
      "description": "Password for the private key file"
    }
  },
  "description": "",
  "x-expandableFields": []
}

{
  "type": "object",
  "title": "TerminalConfigurationConfigurationResourceOfflineConfig",
  "properties": {
    "enabled": {
      "type": "boolean",
      "nullable": true,
      "description": "Determines whether to allow transactions to be collected while reader is offline. Defaults to false."
    }
  },
  "description": "",
  "x-expandableFields": []
}

{
  "type": "object",
  "title": "TerminalConfigurationConfigurationResourcePersonalPSKWifi",
  "required": [
    "password",
    "ssid"
  ],
  "properties": {
    "ssid": {
      "type": "string",
      "maxLength": 5000,
      "description": "Name of the WiFi network"
    },
    "password": {
      "type": "string",
      "maxLength": 5000,
      "description": "Password for connecting to the WiFi network"
    }
  },
  "description": "",
  "x-expandableFields": []
}

{
  "type": "object",
  "title": "TerminalConfigurationConfigurationResourceRebootWindow",
  "required": [
    "end_hour",
    "start_hour"
  ],
  "properties": {
    "end_hour": {
      "type": "integer",
      "description": "Integer between 0 to 23 that represents the end hour of the reboot time window. The value must be different than the start_hour."
    },
    "start_hour": {
      "type": "integer",
      "description": "Integer between 0 to 23 that represents the start hour of the reboot time window."
    }
  },
  "description": "",
  "x-expandableFields": []
}

{
  "type": "object",
  "title": "TerminalConfigurationConfigurationResourceTipping",
  "properties": {
    "aed": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_currency_specific_config"
    },
    "aud": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_currency_specific_config"
    },
    "cad": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_currency_specific_config"
    },
    "chf": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_currency_specific_config"
    },
    "czk": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_currency_specific_config"
    },
    "dkk": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_currency_specific_config"
    },
    "eur": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_currency_specific_config"
    },
    "gbp": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_currency_specific_config"
    },
    "gip": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_currency_specific_config"
    },
    "hkd": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_currency_specific_config"
    },
    "huf": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_currency_specific_config"
    },
    "jpy": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_currency_specific_config"
    },
    "mxn": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_currency_specific_config"
    },
    "myr": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_currency_specific_config"
    },
    "nok": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_currency_specific_config"
    },
    "nzd": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_currency_specific_config"
    },
    "pln": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_currency_specific_config"
    },
    "ron": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_currency_specific_config"
    },
    "sek": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_currency_specific_config"
    },
    "sgd": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_currency_specific_config"
    },
    "usd": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_currency_specific_config"
    }
  },
  "description": "",
  "x-expandableFields": [
    "aed",
    "aud",
    "cad",
    "chf",
    "czk",
    "dkk",
    "eur",
    "gbp",
    "gip",
    "hkd",
    "huf",
    "jpy",
    "mxn",
    "myr",
    "nok",
    "nzd",
    "pln",
    "ron",
    "sek",
    "sgd",
    "usd"
  ]
}

{
  "type": "object",
  "title": "TerminalConfigurationConfigurationResourceWifiConfig",
  "required": [
    "type"
  ],
  "properties": {
    "type": {
      "enum": [
        "enterprise_eap_peap",
        "enterprise_eap_tls",
        "personal_psk"
      ],
      "type": "string",
      "description": "Security type of the WiFi network. The hash with the corresponding name contains the credentials for this security type."
    },
    "personal_psk": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_personal_psk_wifi"
    },
    "enterprise_eap_tls": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_enterprise_tls_wifi"
    },
    "enterprise_eap_peap": {
      "$ref": "#/components/schemas/terminal_configuration_configuration_resource_enterprise_peap_wifi"
    }
  },
  "description": "",
  "x-expandableFields": [
    "enterprise_eap_peap",
    "enterprise_eap_tls",
    "personal_psk"
  ]
}

{
  "type": "object",
  "title": "TerminalOnboardingLinkAppleTermsAndConditions",
  "required": [
    "merchant_display_name"
  ],
  "properties": {
    "allow_relinking": {
      "type": "boolean",
      "nullable": true,
      "description": "Whether the link should also support users relinking their Apple account."
    },
    "merchant_display_name": {
      "type": "string",
      "maxLength": 5000,
      "description": "The business name of the merchant accepting Apple's Terms and Conditions."
    }
  },
  "description": "Options associated with the Apple Terms and Conditions link type.",
  "x-expandableFields": []
}

{
  "type": "object",
  "title": "TerminalOnboardingLinkLinkOptions",
  "properties": {
    "apple_terms_and_conditions": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/terminal_onboarding_link_apple_terms_and_conditions"
        }
      ],
      "nullable": true,
      "description": "The options associated with the Apple Terms and Conditions link type."
    }
  },
  "description": "Link type options associated with the current onboarding link object.",
  "x-expandableFields": [
    "apple_terms_and_conditions"
  ]
}

{
  "type": "object",
  "title": "TerminalReaderReaderResourceCart",
  "required": [
    "currency",
    "line_items",
    "total"
  ],
  "properties": {
    "tax": {
      "type": "integer",
      "nullable": true,
      "description": "Tax amount for the entire cart. A positive integer in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal)."
    },
    "total": {
      "type": "integer",
      "description": "Total amount for the entire cart, including tax. A positive integer in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal)."
    },
    "currency": {
      "type": "string",
      "format": "currency",
      "description": "Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies)."
    },
    "line_items": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/terminal_reader_reader_resource_line_item"
      },
      "description": "List of line items in the cart."
    }
  },
  "description": "Represents a cart to be displayed on the reader",
  "x-expandableFields": [
    "line_items"
  ]
}

{
  "type": "object",
  "title": "TerminalReaderReaderResourceChoice",
  "required": [
    "text"
  ],
  "properties": {
    "id": {
      "type": "string",
      "nullable": true,
      "maxLength": 5000,
      "description": "The identifier for the selected choice. Maximum 50 characters."
    },
    "text": {
      "type": "string",
      "maxLength": 5000,
      "description": "The text to be selected. Maximum 30 characters."
    },
    "style": {
      "enum": [
        "primary",
        "secondary"
      ],
      "type": "string",
      "nullable": true,
      "description": "The button style for the choice. Can be `primary` or `secondary`."
    }
  },
  "description": "Choice to be selected on a Reader",
  "x-expandableFields": []
}

{
  "type": "object",
  "title": "TerminalReaderReaderResourceCollectConfig",
  "properties": {
    "tipping": {
      "$ref": "#/components/schemas/terminal_reader_reader_resource_tipping_config"
    },
    "skip_tipping": {
      "type": "boolean",
      "description": "Override showing a tipping selection screen on this transaction."
    },
    "enable_customer_cancellation": {
      "type": "boolean",
      "description": "Enable customer-initiated cancellation when processing this payment."
    }
  },
  "description": "Represents a per-transaction override of a reader configuration",
  "x-expandableFields": [
    "tipping"
  ]
}

{
  "type": "object",
  "title": "TerminalReaderReaderResourceCollectInputsAction",
  "required": [
    "inputs"
  ],
  "properties": {
    "inputs": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/terminal_reader_reader_resource_input"
      },
      "description": "List of inputs to be collected."
    },
    "metadata": {
      "type": "object",
      "nullable": true,
      "description": "Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.",
      "additionalProperties": {
        "type": "string",
        "maxLength": 500
      }
    }
  },
  "description": "Represents a reader action to collect customer inputs",
  "x-expandableFields": [
    "inputs"
  ]
}

{
  "type": "object",
  "title": "TerminalReaderReaderResourceCollectPaymentMethodAction",
  "required": [
    "payment_intent"
  ],
  "properties": {
    "collect_config": {
      "$ref": "#/components/schemas/terminal_reader_reader_resource_collect_config"
    },
    "payment_intent": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 5000
        },
        {
          "$ref": "#/components/schemas/payment_intent"
        }
      ],
      "description": "Most recent PaymentIntent processed by the reader.",
      "x-expansionResources": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/payment_intent"
          }
        ]
      }
    },
    "payment_method": {
      "$ref": "#/components/schemas/payment_method"
    }
  },
  "description": "Represents a reader action to collect a payment method",
  "x-expandableFields": [
    "collect_config",
    "payment_intent",
    "payment_method"
  ]
}

{
  "type": "object",
  "title": "TerminalReaderReaderResourceConfirmConfig",
  "properties": {
    "return_url": {
      "type": "string",
      "maxLength": 5000,
      "description": "If the customer doesn't abandon authenticating the payment, they're redirected to this URL after completion."
    }
  },
  "description": "Represents a per-transaction override of a reader configuration",
  "x-expandableFields": []
}

{
  "type": "object",
  "title": "TerminalReaderReaderResourceConfirmPaymentIntentAction",
  "required": [
    "payment_intent"
  ],
  "properties": {
    "confirm_config": {
      "$ref": "#/components/schemas/terminal_reader_reader_resource_confirm_config"
    },
    "payment_intent": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 5000
        },
        {
          "$ref": "#/components/schemas/payment_intent"
        }
      ],
      "description": "Most recent PaymentIntent processed by the reader.",
      "x-expansionResources": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/payment_intent"
          }
        ]
      }
    }
  },
  "description": "Represents a reader action to confirm a payment",
  "x-expandableFields": [
    "confirm_config",
    "payment_intent"
  ]
}

{
  "type": "object",
  "title": "TerminalReaderReaderResourceCustomText",
  "properties": {
    "title": {
      "type": "string",
      "nullable": true,
      "maxLength": 5000,
      "description": "Customize the default title for this input"
    },
    "description": {
      "type": "string",
      "nullable": true,
      "maxLength": 5000,
      "description": "Customize the default description for this input"
    },
    "skip_button": {
      "type": "string",
      "nullable": true,
      "maxLength": 5000,
      "description": "Customize the default label for this input's skip button"
    },
    "submit_button": {
      "type": "string",
      "nullable": true,
      "maxLength": 5000,
      "description": "Customize the default label for this input's submit button"
    }
  },
  "description": "Represents custom text to be displayed when collecting the input using a reader",
  "x-expandableFields": []
}

{
  "type": "object",
  "title": "TerminalReaderReaderResourceEmail",
  "properties": {
    "value": {
      "type": "string",
      "nullable": true,
      "maxLength": 5000,
      "description": "The collected email address"
    }
  },
  "description": "Information about a email being collected using a reader",
  "x-expandableFields": []
}

{
  "type": "object",
  "title": "TerminalReaderReaderResourceInput",
  "required": [
    "type"
  ],
  "properties": {
    "text": {
      "$ref": "#/components/schemas/terminal_reader_reader_resource_text"
    },
    "type": {
      "enum": [
        "email",
        "numeric",
        "phone",
        "selection",
        "signature",
        "text"
      ],
      "type": "string",
      "description": "Type of input being collected."
    },
    "email": {
      "$ref": "#/components/schemas/terminal_reader_reader_resource_email"
    },
    "phone": {
      "$ref": "#/components/schemas/terminal_reader_reader_resource_phone"
    },
    "numeric": {
      "$ref": "#/components/schemas/terminal_reader_reader_resource_numeric"
    },
    "skipped": {
      "type": "boolean",
      "description": "Indicate that this input was skipped by the user."
    },
    "toggles": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/terminal_reader_reader_resource_toggle"
      },
      "nullable": true,
      "description": "List of toggles being collected. Values are present if collection is complete."
    },
    "required": {
      "type": "boolean",
      "nullable": true,
      "description": "Indicate that this input is required, disabling the skip button."
    },
    "selection": {
      "$ref": "#/components/schemas/terminal_reader_reader_resource_selection"
    },
    "signature": {
      "$ref": "#/components/schemas/terminal_reader_reader_resource_signature"
    },
    "custom_text": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/terminal_reader_reader_resource_custom_text"
        }
      ],
      "nullable": true,
      "description": "Default text of input being collected."
    }
  },
  "description": "Represents an input to be collected using the reader",
  "x-expandableFields": [
    "custom_text",
    "email",
    "numeric",
    "phone",
    "selection",
    "signature",
    "text",
    "toggles"
  ]
}

{
  "type": "object",
  "title": "TerminalReaderReaderResourceLineItem",
  "required": [
    "amount",
    "description",
    "quantity"
  ],
  "properties": {
    "amount": {
      "type": "integer",
      "description": "The amount of the line item. A positive integer in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal)."
    },
    "quantity": {
      "type": "integer",
      "description": "The quantity of the line item."
    },
    "description": {
      "type": "string",
      "maxLength": 5000,
      "description": "Description of the line item."
    }
  },
  "description": "Represents a line item to be displayed on the reader",
  "x-expandableFields": []
}

{
  "type": "object",
  "title": "TerminalReaderReaderResourceNumeric",
  "properties": {
    "value": {
      "type": "string",
      "nullable": true,
      "maxLength": 5000,
      "description": "The collected number"
    }
  },
  "description": "Information about a number being collected using a reader",
  "x-expandableFields": []
}

{
  "type": "object",
  "title": "TerminalReaderReaderResourcePhone",
  "properties": {
    "value": {
      "type": "string",
      "nullable": true,
      "maxLength": 5000,
      "description": "The collected phone number"
    }
  },
  "description": "Information about a phone number being collected using a reader",
  "x-expandableFields": []
}