diff --git a/embedded/openapi/spec3.beta.sdk.json b/embedded/openapi/spec3.beta.sdk.json index 649e1945..bbbc64ff 100644 --- a/embedded/openapi/spec3.beta.sdk.json +++ b/embedded/openapi/spec3.beta.sdk.json @@ -1943,7 +1943,7 @@ "type": "array" }, "hosted_payment_method_save": { - "description": "Whether to save the payment method after a payment is completed for a one-time invoice or a subscription invoice when the customer already has a default payment method on the hosted invoice page.", + "description": "Whether payment methods should be saved when a payment is completed for a one-time invoices on a hosted invoice page.", "enum": [ "always", "never", @@ -28180,7 +28180,7 @@ "type": "integer" }, "billing_reason": { - "description": "Indicates the reason why the invoice was created.\n\n* `manual`: Unrelated to a subscription, for example, created via the invoice editor.\n* `subscription`: No longer in use. Applies to subscriptions from before May 2018 where no distinction was made between updates, cycles, and thresholds.\n* `subscription_create`: A new subscription was created.\n* `subscription_cycle`: A subscription advanced into a new period.\n* `subscription_threshold`: A subscription reached a billing threshold.\n* `subscription_update`: A subscription was updated.\n* `upcoming`: Reserved for upcoming invoices created through the Create Preview Invoice API or when an `invoice.upcoming` event is generated for an upcoming invoice on a subscription.", + "description": "Indicates the reason why the invoice was created.\n\n* `manual`: Unrelated to a subscription, for example, created via the invoice editor.\n* `subscription`: No longer in use. Applies to subscriptions from before May 2018 where no distinction was made between updates, cycles, and thresholds.\n* `subscription_create`: A new subscription was created.\n* `subscription_cycle`: A subscription advanced into a new period.\n* `subscription_threshold`: A subscription reached a billing threshold.\n* `subscription_update`: A subscription was updated.\n* `upcoming`: Reserved for simulated invoices, per the upcoming invoice endpoint.", "enum": [ "automatic_pending_invoice_item_invoice", "manual", @@ -42302,7 +42302,7 @@ "type": "integer" }, "amount_type": { - "description": "The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively. Defaults to `maximum`.", + "description": "The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively.", "enum": [ "fixed", "maximum" @@ -42317,7 +42317,7 @@ "type": "string" }, "payment_schedule": { - "description": "The periodicity at which payments will be collected. Defaults to `adhoc`.", + "description": "The periodicity at which payments will be collected.", "enum": [ "adhoc", "annual", @@ -42337,7 +42337,7 @@ "type": "integer" }, "purpose": { - "description": "The purpose for which payments are made. Has a default value based on your merchant category code.", + "description": "The purpose for which payments are made. Defaults to retail.", "enum": [ "dependant_support", "government", @@ -42548,7 +42548,7 @@ "type": "integer" }, "amount_type": { - "description": "The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively. Defaults to `maximum`.", + "description": "The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively.", "enum": [ "fixed", "maximum" @@ -42562,7 +42562,7 @@ "type": "string" }, "payment_schedule": { - "description": "The periodicity at which payments will be collected. Defaults to `adhoc`.", + "description": "The periodicity at which payments will be collected.", "enum": [ "adhoc", "annual", @@ -42581,7 +42581,7 @@ "type": "integer" }, "purpose": { - "description": "The purpose for which payments are made. Has a default value based on your merchant category code.", + "description": "The purpose for which payments are made. Defaults to retail.", "enum": [ "dependant_support", "government", @@ -49138,7 +49138,7 @@ "type": "integer" }, "amount_type": { - "description": "The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively. Defaults to `maximum`.", + "description": "The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively.", "enum": [ "fixed", "maximum" @@ -49153,7 +49153,7 @@ "type": "string" }, "payment_schedule": { - "description": "The periodicity at which payments will be collected. Defaults to `adhoc`.", + "description": "The periodicity at which payments will be collected.", "enum": [ "adhoc", "annual", @@ -49173,7 +49173,7 @@ "type": "integer" }, "purpose": { - "description": "The purpose for which payments are made. Has a default value based on your merchant category code.", + "description": "The purpose for which payments are made. Defaults to retail.", "enum": [ "dependant_support", "government", @@ -68316,7 +68316,7 @@ "type": "integer" }, "billing_reason": { - "description": "Indicates the reason why the invoice was created.\n\n* `manual`: Unrelated to a subscription, for example, created via the invoice editor.\n* `subscription`: No longer in use. Applies to subscriptions from before May 2018 where no distinction was made between updates, cycles, and thresholds.\n* `subscription_create`: A new subscription was created.\n* `subscription_cycle`: A subscription advanced into a new period.\n* `subscription_threshold`: A subscription reached a billing threshold.\n* `subscription_update`: A subscription was updated.\n* `upcoming`: Reserved for upcoming invoices created through the Create Preview Invoice API or when an `invoice.upcoming` event is generated for an upcoming invoice on a subscription.", + "description": "Indicates the reason why the invoice was created.\n\n* `manual`: Unrelated to a subscription, for example, created via the invoice editor.\n* `subscription`: No longer in use. Applies to subscriptions from before May 2018 where no distinction was made between updates, cycles, and thresholds.\n* `subscription_create`: A new subscription was created.\n* `subscription_cycle`: A subscription advanced into a new period.\n* `subscription_threshold`: A subscription reached a billing threshold.\n* `subscription_update`: A subscription was updated.\n* `upcoming`: Reserved for simulated invoices, per the upcoming invoice endpoint.", "enum": [ "automatic_pending_invoice_item_invoice", "manual", @@ -76128,7 +76128,7 @@ "type": "integer" }, "amount_type": { - "description": "The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively. Defaults to `maximum`.", + "description": "The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively.", "enum": [ "fixed", "maximum" @@ -76143,7 +76143,7 @@ "type": "string" }, "payment_schedule": { - "description": "The periodicity at which payments will be collected. Defaults to `adhoc`.", + "description": "The periodicity at which payments will be collected.", "enum": [ "adhoc", "annual", @@ -76163,7 +76163,7 @@ "type": "integer" }, "purpose": { - "description": "The purpose for which payments are made. Has a default value based on your merchant category code.", + "description": "The purpose for which payments are made. Defaults to retail.", "enum": [ "dependant_support", "government", @@ -94746,7 +94746,7 @@ "description": "The Stripe REST API. Please see https://stripe.com/docs/api for more details.", "termsOfService": "https://stripe.com/us/terms/", "title": "Stripe API", - "version": "2025-10-29.preview; embedded_connect_beta=v2; server_side_confirmation_beta=v1; orders_beta=v4; unified_accounts_beta=v1; terminal_collect_inputs_beta=v2; terminal_collect_confirm_beta=v1; retrieve_tax_forms_beta=v1; checkout_server_update_beta=v1; payment_records_beta=v2; financial_connections_transactions_beta=v1; invoice_partial_payments_beta=v3; invoice_payment_plans_beta=v1; payment_intent_with_tax_api_beta=v1; custom_checkout_beta=v2; id_bank_transfer_beta=v2; fx_quote_preview=v1", + "version": "2025-09-30.preview; embedded_connect_beta=v2; server_side_confirmation_beta=v1; orders_beta=v4; unified_accounts_beta=v1; terminal_collect_inputs_beta=v2; terminal_collect_confirm_beta=v1; retrieve_tax_forms_beta=v1; checkout_server_update_beta=v1; payment_records_beta=v2; financial_connections_transactions_beta=v1; invoice_partial_payments_beta=v3; invoice_payment_plans_beta=v1; payment_intent_with_tax_api_beta=v1; custom_checkout_beta=v2; id_bank_transfer_beta=v2; fx_quote_preview=v1", "x-stripeSpecFilename": "spec3.beta.sdk" }, "openapi": "3.0.0", @@ -98054,7 +98054,6 @@ "card_issuing_fa_spend_card_celtic", "card_issuing_fa_spend_card_stripe", "card_issuing_prepaid_card_cross_river", - "card_issuing_prepaid_card_lead", "card_issuing_spend_card_cross_river", "card_payments", "cartes_bancaires_payments", @@ -98067,7 +98066,6 @@ "crypto_transfers", "crypto_transfers_platform", "demo_pay_payments", - "dispute_arbitration", "duitnow_payments", "dummy_passthrough_card_payments", "edenred_payments", @@ -99721,7 +99719,7 @@ "description": "Settings specific to the account’s use of Invoices.", "properties": { "hosted_payment_method_save": { - "description": "Whether to save the payment method after a payment is completed for a one-time invoice or a subscription invoice when the customer already has a default payment method on the hosted invoice page.", + "description": "Whether payment methods should be saved when a payment is completed for a one-time invoices on a hosted invoice page.", "enum": [ "always", "never", @@ -101581,7 +101579,6 @@ "card_issuing_fa_spend_card_celtic", "card_issuing_fa_spend_card_stripe", "card_issuing_prepaid_card_cross_river", - "card_issuing_prepaid_card_lead", "card_issuing_spend_card_cross_river", "card_payments", "cartes_bancaires_payments", @@ -101594,7 +101591,6 @@ "crypto_transfers", "crypto_transfers_platform", "demo_pay_payments", - "dispute_arbitration", "duitnow_payments", "dummy_passthrough_card_payments", "edenred_payments", @@ -103136,7 +103132,7 @@ "description": "The list of default Account Tax IDs to automatically include on invoices. Account Tax IDs get added when an invoice is finalized." }, "hosted_payment_method_save": { - "description": "Whether to save the payment method after a payment is completed for a one-time invoice or a subscription invoice when the customer already has a default payment method on the hosted invoice page.", + "description": "Whether payment methods should be saved when a payment is completed for a one-time invoices on a hosted invoice page.", "enum": [ "always", "never", @@ -121353,7 +121349,7 @@ "type": "integer" }, "amount_type": { - "description": "The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively. Defaults to `maximum`.", + "description": "The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively.", "enum": [ "fixed", "maximum" @@ -121366,7 +121362,7 @@ "type": "string" }, "payment_schedule": { - "description": "The periodicity at which payments will be collected. Defaults to `adhoc`.", + "description": "The periodicity at which payments will be collected.", "enum": [ "adhoc", "annual", @@ -121384,7 +121380,7 @@ "type": "integer" }, "purpose": { - "description": "The purpose for which payments are made. Has a default value based on your merchant category code.", + "description": "The purpose for which payments are made. Defaults to retail.", "enum": [ "dependant_support", "government", @@ -127608,7 +127604,7 @@ "additionalProperties": false, "properties": { "components": { - "description": "Configuration for each component. At least 1 component must be enabled.", + "description": "Configuration for each component. Exactly 1 component must be enabled.", "properties": { "buy_button": { "description": "Configuration for buy button.", @@ -169122,7 +169118,6 @@ "discount_amount", "line_items", "shipping", - "surcharge", "tax" ] }, @@ -174080,7 +174075,7 @@ "type": "integer" }, "amount_type": { - "description": "The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively. Defaults to `maximum`.", + "description": "The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively.", "enum": [ "fixed", "maximum" @@ -174093,7 +174088,7 @@ "type": "string" }, "payment_schedule": { - "description": "The periodicity at which payments will be collected. Defaults to `adhoc`.", + "description": "The periodicity at which payments will be collected.", "enum": [ "adhoc", "annual", @@ -174111,7 +174106,7 @@ "type": "integer" }, "purpose": { - "description": "The purpose for which payments are made. Has a default value based on your merchant category code.", + "description": "The purpose for which payments are made. Defaults to retail.", "enum": [ "dependant_support", "government", @@ -175870,7 +175865,6 @@ "discount_amount", "line_items", "shipping", - "surcharge", "tax" ] }, @@ -180780,7 +180774,7 @@ "type": "integer" }, "amount_type": { - "description": "The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively. Defaults to `maximum`.", + "description": "The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively.", "enum": [ "fixed", "maximum" @@ -180793,7 +180787,7 @@ "type": "string" }, "payment_schedule": { - "description": "The periodicity at which payments will be collected. Defaults to `adhoc`.", + "description": "The periodicity at which payments will be collected.", "enum": [ "adhoc", "annual", @@ -180811,7 +180805,7 @@ "type": "integer" }, "purpose": { - "description": "The purpose for which payments are made. Has a default value based on your merchant category code.", + "description": "The purpose for which payments are made. Defaults to retail.", "enum": [ "dependant_support", "government", @@ -182594,7 +182588,6 @@ "discount_amount", "line_items", "shipping", - "surcharge", "tax" ] }, @@ -184230,7 +184223,6 @@ "discount_amount", "line_items", "shipping", - "surcharge", "tax" ] }, @@ -189211,7 +189203,7 @@ "type": "integer" }, "amount_type": { - "description": "The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively. Defaults to `maximum`.", + "description": "The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively.", "enum": [ "fixed", "maximum" @@ -189224,7 +189216,7 @@ "type": "string" }, "payment_schedule": { - "description": "The periodicity at which payments will be collected. Defaults to `adhoc`.", + "description": "The periodicity at which payments will be collected.", "enum": [ "adhoc", "annual", @@ -189242,7 +189234,7 @@ "type": "integer" }, "purpose": { - "description": "The purpose for which payments are made. Has a default value based on your merchant category code.", + "description": "The purpose for which payments are made. Defaults to retail.", "enum": [ "dependant_support", "government", @@ -190885,7 +190877,6 @@ "discount_amount", "line_items", "shipping", - "surcharge", "tax" ] }, @@ -217843,7 +217834,6 @@ "tds_triggered", "tenant_filters", "tenant_filters_by_meter", - "tenant_group_by_keys_by_meter", "three_d_s_outcome", "time_granularity", "timezone", @@ -220861,7 +220851,7 @@ "type": "integer" }, "amount_type": { - "description": "The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively. Defaults to `maximum`.", + "description": "The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively.", "enum": [ "fixed", "maximum" @@ -220874,7 +220864,7 @@ "type": "string" }, "payment_schedule": { - "description": "The periodicity at which payments will be collected. Defaults to `adhoc`.", + "description": "The periodicity at which payments will be collected.", "enum": [ "adhoc", "annual", @@ -220892,7 +220882,7 @@ "type": "integer" }, "purpose": { - "description": "The purpose for which payments are made. Has a default value based on your merchant category code.", + "description": "The purpose for which payments are made. Defaults to retail.", "enum": [ "dependant_support", "government", @@ -223296,7 +223286,7 @@ "type": "integer" }, "amount_type": { - "description": "The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively. Defaults to `maximum`.", + "description": "The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively.", "enum": [ "fixed", "maximum" @@ -223309,7 +223299,7 @@ "type": "string" }, "payment_schedule": { - "description": "The periodicity at which payments will be collected. Defaults to `adhoc`.", + "description": "The periodicity at which payments will be collected.", "enum": [ "adhoc", "annual", @@ -223327,7 +223317,7 @@ "type": "integer" }, "purpose": { - "description": "The purpose for which payments are made. Has a default value based on your merchant category code.", + "description": "The purpose for which payments are made. Defaults to retail.", "enum": [ "dependant_support", "government", @@ -225697,7 +225687,7 @@ "type": "integer" }, "amount_type": { - "description": "The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively. Defaults to `maximum`.", + "description": "The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively.", "enum": [ "fixed", "maximum" @@ -225710,7 +225700,7 @@ "type": "string" }, "payment_schedule": { - "description": "The periodicity at which payments will be collected. Defaults to `adhoc`.", + "description": "The periodicity at which payments will be collected.", "enum": [ "adhoc", "annual", @@ -225728,7 +225718,7 @@ "type": "integer" }, "purpose": { - "description": "The purpose for which payments are made. Has a default value based on your merchant category code.", + "description": "The purpose for which payments are made. Defaults to retail.", "enum": [ "dependant_support", "government", @@ -246408,7 +246398,7 @@ "additionalProperties": false, "properties": { "bbpos_wisepad3": { - "description": "An object containing device type specific settings for BBPOS WisePad 3 readers.", + "description": "An object containing device type specific settings for BBPOS WisePad 3 readers", "properties": { "splashscreen": { "anyOf": [ @@ -246422,7 +246412,7 @@ "type": "string" } ], - "description": "A File ID representing an image you want to display on the reader." + "description": "A File ID representing an image you would like displayed on the reader." } }, "title": "bbpos_wise_pad3", @@ -246432,7 +246422,7 @@ ] }, "bbpos_wisepos_e": { - "description": "An object containing device type specific settings for BBPOS WisePOS E readers.", + "description": "An object containing device type specific settings for BBPOS WisePOS E readers", "properties": { "splashscreen": { "anyOf": [ @@ -246531,7 +246521,7 @@ "description": "Configurations for reader security settings." }, "reboot_window": { - "description": "Reboot time settings for readers. that support customized reboot time configuration.", + "description": "Reboot time settings for readers that support customized reboot time configuration.", "properties": { "end_hour": { "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.", @@ -246554,7 +246544,7 @@ ] }, "stripe_s700": { - "description": "An object containing device type specific settings for Stripe S700 readers.", + "description": "An object containing device type specific settings for Stripe S700 readers", "properties": { "splashscreen": { "anyOf": [ @@ -246568,7 +246558,7 @@ "type": "string" } ], - "description": "A File ID representing an image you want to display on the reader." + "description": "A File ID representing an image you would like displayed on the reader." } }, "title": "stripe_s700", @@ -247276,10 +247266,10 @@ "type": "string" } ], - "description": "Tipping configurations for readers. supporting on-reader tips" + "description": "Tipping configurations for readers supporting on-reader tips" }, "verifone_p400": { - "description": "An object containing device type specific settings for Verifone P400 readers.", + "description": "An object containing device type specific settings for Verifone P400 readers", "properties": { "splashscreen": { "anyOf": [ @@ -247293,7 +247283,7 @@ "type": "string" } ], - "description": "A File ID representing an image you want to display on the reader." + "description": "A File ID representing an image you would like displayed on the reader." } }, "title": "verifone_p400", @@ -247685,7 +247675,7 @@ "type": "string" } ], - "description": "A File ID representing an image you want to display on the reader." + "description": "A File ID representing an image you would like displayed on the reader." } }, "title": "bbpos_wise_pad3", @@ -247701,7 +247691,7 @@ "type": "string" } ], - "description": "An object containing device type specific settings for BBPOS WisePad 3 readers." + "description": "An object containing device type specific settings for BBPOS WisePad 3 readers" }, "bbpos_wisepos_e": { "anyOf": [ @@ -247735,7 +247725,7 @@ "type": "string" } ], - "description": "An object containing device type specific settings for BBPOS WisePOS E readers." + "description": "An object containing device type specific settings for BBPOS WisePOS E readers" }, "expand": { "description": "Specifies which fields in the response should be expanded.", @@ -247843,7 +247833,7 @@ "type": "string" } ], - "description": "Reboot time settings for readers. that support customized reboot time configuration." + "description": "Reboot time settings for readers that support customized reboot time configuration." }, "stripe_s700": { "anyOf": [ @@ -247861,7 +247851,7 @@ "type": "string" } ], - "description": "A File ID representing an image you want to display on the reader." + "description": "A File ID representing an image you would like displayed on the reader." } }, "title": "stripe_s700", @@ -247877,7 +247867,7 @@ "type": "string" } ], - "description": "An object containing device type specific settings for Stripe S700 readers." + "description": "An object containing device type specific settings for Stripe S700 readers" }, "tipping": { "anyOf": [ @@ -248578,7 +248568,7 @@ "type": "string" } ], - "description": "Tipping configurations for readers. supporting on-reader tips" + "description": "Tipping configurations for readers supporting on-reader tips" }, "verifone_p400": { "anyOf": [ @@ -248596,7 +248586,7 @@ "type": "string" } ], - "description": "A File ID representing an image you want to display on the reader." + "description": "A File ID representing an image you would like displayed on the reader." } }, "title": "verifone_p400", @@ -248612,7 +248602,7 @@ "type": "string" } ], - "description": "An object containing device type specific settings for Verifone P400 readers." + "description": "An object containing device type specific settings for Verifone P400 readers" }, "wifi": { "anyOf": [ @@ -268200,8 +268190,7 @@ "2025-07-30.basil", "2025-08-27.basil", "2025-09-30.clover", - "2025-10-29.clover", - "2025-11-17.clover" + "2025-10-29.clover" ], "maxLength": 5000, "type": "string", diff --git a/embedded/openapi/spec3.json b/embedded/openapi/spec3.json index 62e219a0..5792d8d4 100644 --- a/embedded/openapi/spec3.json +++ b/embedded/openapi/spec3.json @@ -28576,7 +28576,7 @@ "description": "", "properties": { "discount_amount": { - "description": "The total discount applied on the transaction.", + "description": "The total discount applied on the transaction represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). An integer greater than 0.\n\nThis field is mutually exclusive with the `amount_details[line_items][#][discount_amount]` field.", "type": "integer" }, "line_items": { @@ -28691,7 +28691,7 @@ "description": "", "properties": { "total_tax_amount": { - "description": "Total portion of the amount that is for tax.", + "description": "The total amount of tax on the transaction represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Required for L2 rates. An integer greater than or equal to 0.\n\nThis field is mutually exclusive with the `amount_details[line_items][#][tax][total_tax_amount]` field.", "type": "integer" } }, @@ -28706,18 +28706,18 @@ "description": "", "properties": { "amount": { - "description": "Portion of the amount that is for shipping.", + "description": "If a physical good is being shipped, the cost of shipping represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). An integer greater than or equal to 0.", "nullable": true, "type": "integer" }, "from_postal_code": { - "description": "The postal code that represents the shipping source.", + "description": "If a physical good is being shipped, the postal code of where it is being shipped from. At most 10 alphanumeric characters long, hyphens are allowed.", "maxLength": 5000, "nullable": true, "type": "string" }, "to_postal_code": { - "description": "The postal code that represents the shipping destination.", + "description": "If a physical good is being shipped, the postal code of where it is being shipped to. At most 10 alphanumeric characters long, hyphens are allowed.", "maxLength": 5000, "nullable": true, "type": "string" @@ -28731,7 +28731,7 @@ "description": "", "properties": { "total_tax_amount": { - "description": "Total portion of the amount that is for tax.", + "description": "The total amount of tax on the transaction represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Required for L2 rates. An integer greater than or equal to 0.\n\nThis field is mutually exclusive with the `amount_details[line_items][#][tax][total_tax_amount]` field.", "nullable": true, "type": "integer" } @@ -28807,13 +28807,13 @@ "description": "", "properties": { "customer_reference": { - "description": "Some customers might be required by their company or organization to provide this information. If so, provide this value. Otherwise you can ignore this field.", + "description": "A unique value to identify the customer. This field is available only for card payments.\n\nThis field is truncated to 25 alphanumeric characters, excluding spaces, before being sent to card networks.", "maxLength": 5000, "nullable": true, "type": "string" }, "order_reference": { - "description": "A unique value assigned by the business to identify the transaction.", + "description": "A unique value assigned by the business to identify the transaction. Required for L2 and L3 rates.\n\nRequired when the Payment Method Types array contains `card`, including when [automatic_payment_methods.enabled](/api/payment_intents/create#create_payment_intent-automatic_payment_methods-enabled) is set to `true`.\n\nFor Cards, this field is truncated to 25 alphanumeric characters, excluding spaces, before being sent to card networks. For Klarna, this field is truncated to 255 characters and is visible to customers when they view the order in the Klarna app.", "maxLength": 5000, "nullable": true, "type": "string" @@ -29643,7 +29643,7 @@ "description": "", "properties": { "discount_amount": { - "description": "The amount an item was discounted for. Positive integer.", + "description": "The discount applied on this line item represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). An integer greater than 0.\n\nThis field is mutually exclusive with the `amount_details[discount_amount]` field.", "nullable": true, "type": "integer" }, @@ -29669,18 +29669,18 @@ "nullable": true }, "product_code": { - "description": "Unique identifier of the product. At most 12 characters long.", + "description": "The product code of the line item, such as an SKU. Required for L3 rates. At most 12 characters long.", "maxLength": 5000, "nullable": true, "type": "string" }, "product_name": { - "description": "Name of the product. At most 100 characters long.", + "description": "The product name of the line item. Required for L3 rates. At most 1024 characters long.\n\nFor Cards, this field is truncated to 26 alphanumeric characters before being sent to the card networks. For Paypal, this field is truncated to 127 characters.", "maxLength": 5000, "type": "string" }, "quantity": { - "description": "Number of items of the product. Positive integer.", + "description": "The quantity of items. Required for L3 rates. An integer greater than 0.", "type": "integer" }, "tax": { @@ -29693,11 +29693,11 @@ "nullable": true }, "unit_cost": { - "description": "Cost of the product. Non-negative integer.", + "description": "The unit cost of the line item represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0.", "type": "integer" }, "unit_of_measure": { - "description": "A unit of measure for the line item, such as gallons, feet, meters, etc.", + "description": "A unit of measure for the line item, such as gallons, feet, meters, etc. Required for L3 rates. At most 12 alphanumeric characters long.", "maxLength": 5000, "nullable": true, "type": "string"