Update generated code (#1912)

* Update generated code for v1249

* Update generated code for v1250

* Update generated code for v1255

* Update generated code for v1257

* Update generated code for v1259

---------

Co-authored-by: Stripe OpenAPI <105521251+stripe-openapi[bot]@users.noreply.github.com>
Co-authored-by: jar-stripe <[email protected]>

OPENAPI_VERSION

@@ -1 +1 @@
-v1246
+v1259

checkout_session.go

@@ -893,6 +893,15 @@ const (
 	CheckoutSessionSubmitTypePay    CheckoutSessionSubmitType = "pay"
 )
 
+// Indicates whether a tax ID is required on the payment page
+type CheckoutSessionTaxIDCollectionRequired string
+
+// List of values that CheckoutSessionTaxIDCollectionRequired can take
+const (
+	CheckoutSessionTaxIDCollectionRequiredIfSupported CheckoutSessionTaxIDCollectionRequired = "if_supported"
+	CheckoutSessionTaxIDCollectionRequiredNever       CheckoutSessionTaxIDCollectionRequired = "never"
+)
+
 // The reasoning behind this tax, for example, if the product is tax exempt. The possible values for this field may be extended as new tax rules are supported.
 type CheckoutSessionTotalDetailsBreakdownTaxTaxabilityReason string
 
@@ -2092,6 +2101,8 @@ func (p *CheckoutSessionSubscriptionDataParams) AddMetadata(key string, value st
 type CheckoutSessionTaxIDCollectionParams struct {
 	// Enable tax ID collection during checkout. Defaults to `false`.
 	Enabled *bool `form:"enabled"`
+	// Describes whether a tax ID is required during checkout. Defaults to `never`.
+	Required *string `form:"required"`
 }
 
 // Creates a Session object.
@@ -2993,6 +3004,8 @@ type CheckoutSessionShippingOption struct {
 type CheckoutSessionTaxIDCollection struct {
 	// Indicates whether tax ID collection is enabled for the session
 	Enabled bool `json:"enabled"`
+	// Indicates whether a tax ID is required on the payment page
+	Required CheckoutSessionTaxIDCollectionRequired `json:"required"`
 }
 
 // The aggregated discounts.

client/api.go

@@ -58,6 +58,7 @@ import (
 	"github.com/stripe/stripe-go/v79/invoice"
 	"github.com/stripe/stripe-go/v79/invoiceitem"
 	"github.com/stripe/stripe-go/v79/invoicelineitem"
+	"github.com/stripe/stripe-go/v79/invoicerenderingtemplate"
 	issuingauthorization "github.com/stripe/stripe-go/v79/issuing/authorization"
 	issuingcard "github.com/stripe/stripe-go/v79/issuing/card"
 	issuingcardholder "github.com/stripe/stripe-go/v79/issuing/cardholder"
@@ -241,6 +242,8 @@ type API struct {
 	InvoiceItems *invoiceitem.Client
 	// InvoiceLineItems is the client used to invoke /invoices/{invoice}/lines APIs.
 	InvoiceLineItems *invoicelineitem.Client
+	// InvoiceRenderingTemplates is the client used to invoke /invoice_rendering_templates APIs.
+	InvoiceRenderingTemplates *invoicerenderingtemplate.Client
 	// Invoices is the client used to invoke /invoices APIs.
 	Invoices *invoice.Client
 	// IssuingAuthorizations is the client used to invoke /issuing/authorizations APIs.
@@ -469,6 +472,7 @@ func (a *API) Init(key string, backends *stripe.Backends) {
 	a.IdentityVerificationSessions = &identityverificationsession.Client{B: backends.API, Key: key}
 	a.InvoiceItems = &invoiceitem.Client{B: backends.API, Key: key}
 	a.InvoiceLineItems = &invoicelineitem.Client{B: backends.API, Key: key}
+	a.InvoiceRenderingTemplates = &invoicerenderingtemplate.Client{B: backends.API, Key: key}
 	a.Invoices = &invoice.Client{B: backends.API, Key: key}
 	a.IssuingAuthorizations = &issuingauthorization.Client{B: backends.API, Key: key}
 	a.IssuingCardholders = &issuingcardholder.Client{B: backends.API, Key: key}

customer.go

@@ -133,6 +133,8 @@ type CustomerInvoiceSettingsCustomFieldParams struct {
 type CustomerInvoiceSettingsRenderingOptionsParams struct {
 	// How line-item prices and amounts will be displayed with respect to tax on invoice PDFs. One of `exclude_tax` or `include_inclusive_tax`. `include_inclusive_tax` will include inclusive tax (and exclude exclusive tax) in invoice PDF amounts. `exclude_tax` will exclude all tax (inclusive and exclusive alike) from invoice PDF amounts.
 	AmountTaxDisplay *string `form:"amount_tax_display"`
+	// ID of the invoice rendering template to use for future invoices.
+	Template *string `form:"template"`
 }
 
 // Default invoice settings for this customer.
@@ -295,6 +297,8 @@ type CustomerInvoiceSettingsCustomField struct {
 type CustomerInvoiceSettingsRenderingOptions struct {
 	// How line-item prices and amounts will be displayed with respect to tax on invoice PDFs.
 	AmountTaxDisplay string `json:"amount_tax_display"`
+	// ID of the invoice rendering template to be used for this customer's invoices. If set, the template will be used on all invoices for this customer unless a template is set directly on the invoice.
+	Template string `json:"template"`
 }
 type CustomerInvoiceSettings struct {
 	// Default custom fields to be displayed on invoices for this customer.

invoice.go

@@ -521,6 +521,10 @@ type InvoiceRenderingParams struct {
 	AmountTaxDisplay *string `form:"amount_tax_display"`
 	// Invoice pdf rendering options
 	PDF *InvoiceRenderingPDFParams `form:"pdf"`
+	// ID of the invoice rendering template to use for this invoice.
+	Template *string `form:"template"`
+	// The specific version of invoice rendering template to use for this invoice.
+	TemplateVersion *int64 `form:"template_version"`
 }
 
 // The upper bound of the estimated range. If empty, represents no upper bound i.e., infinite.
@@ -3021,6 +3025,10 @@ type InvoiceRendering struct {
 	AmountTaxDisplay string `json:"amount_tax_display"`
 	// Invoice pdf rendering options
 	PDF *InvoiceRenderingPDF `json:"pdf"`
+	// ID of the rendering template that the invoice is formatted by.
+	Template string `json:"template"`
+	// Version of the rendering template that the invoice is using.
+	TemplateVersion int64 `json:"template_version"`
 }
 
 // The taxes applied to the shipping rate.

invoicerenderingtemplate.go

@@ -0,0 +1,93 @@
+//
+//
+// File generated from our OpenAPI spec
+//
+//
+
+package stripe
+
+// The status of the template, one of `active` or `archived`.
+type InvoiceRenderingTemplateStatus string
+
+// List of values that InvoiceRenderingTemplateStatus can take
+const (
+	InvoiceRenderingTemplateStatusActive   InvoiceRenderingTemplateStatus = "active"
+	InvoiceRenderingTemplateStatusArchived InvoiceRenderingTemplateStatus = "archived"
+)
+
+// List all templates, ordered by creation date, with the most recently created template appearing first.
+type InvoiceRenderingTemplateListParams struct {
+	ListParams `form:"*"`
+	// Specifies which fields in the response should be expanded.
+	Expand []*string `form:"expand"`
+	Status *string   `form:"status"`
+}
+
+// AddExpand appends a new field to expand.
+func (p *InvoiceRenderingTemplateListParams) AddExpand(f string) {
+	p.Expand = append(p.Expand, &f)
+}
+
+// Retrieves an invoice rendering template with the given ID. It by default returns the latest version of the template. Optionally, specify a version to see previous versions.
+type InvoiceRenderingTemplateParams struct {
+	Params `form:"*"`
+	// Specifies which fields in the response should be expanded.
+	Expand  []*string `form:"expand"`
+	Version *int64    `form:"version"`
+}
+
+// AddExpand appends a new field to expand.
+func (p *InvoiceRenderingTemplateParams) AddExpand(f string) {
+	p.Expand = append(p.Expand, &f)
+}
+
+// Updates the status of an invoice rendering template to ‘archived' so no new Stripe objects (customers, invoices, etc.) can reference it. The template can also no longer be updated. However, if the template is already set on a Stripe object, it will continue to be applied on invoices generated by it.
+type InvoiceRenderingTemplateArchiveParams struct {
+	Params `form:"*"`
+	// Specifies which fields in the response should be expanded.
+	Expand []*string `form:"expand"`
+}
+
+// AddExpand appends a new field to expand.
+func (p *InvoiceRenderingTemplateArchiveParams) AddExpand(f string) {
+	p.Expand = append(p.Expand, &f)
+}
+
+// Unarchive an invoice rendering template so it can be used on new Stripe objects again.
+type InvoiceRenderingTemplateUnarchiveParams struct {
+	Params `form:"*"`
+	// Specifies which fields in the response should be expanded.
+	Expand []*string `form:"expand"`
+}
+
+// AddExpand appends a new field to expand.
+func (p *InvoiceRenderingTemplateUnarchiveParams) AddExpand(f string) {
+	p.Expand = append(p.Expand, &f)
+}
+
+type InvoiceRenderingTemplate struct {
+	APIResource
+	// Time at which the object was created. Measured in seconds since the Unix epoch.
+	Created int64 `json:"created"`
+	// Unique identifier for the object.
+	ID string `json:"id"`
+	// Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+	Livemode bool `json:"livemode"`
+	// Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+	Metadata map[string]string `json:"metadata"`
+	// A brief description of the template, hidden from customers
+	Nickname string `json:"nickname"`
+	// String representing the object's type. Objects of the same type share the same value.
+	Object string `json:"object"`
+	// The status of the template, one of `active` or `archived`.
+	Status InvoiceRenderingTemplateStatus `json:"status"`
+	// Version of this template; version increases by one when an update on the template changes any field that controls invoice rendering
+	Version int64 `json:"version"`
+}
+
+// InvoiceRenderingTemplateList is a list of InvoiceRenderingTemplates as retrieved from a list endpoint.
+type InvoiceRenderingTemplateList struct {
+	APIResource
+	ListMeta
+	Data []*InvoiceRenderingTemplate `json:"data"`
+}

invoicerenderingtemplate/client.go

@@ -0,0 +1,118 @@
+//
+//
+// File generated from our OpenAPI spec
+//
+//
+
+// Package invoicerenderingtemplate provides the /invoice_rendering_templates APIs
+package invoicerenderingtemplate
+
+import (
+	"net/http"
+
+	stripe "github.com/stripe/stripe-go/v79"
+	"github.com/stripe/stripe-go/v79/form"
+)
+
+// Client is used to invoke /invoice_rendering_templates APIs.
+type Client struct {
+	B   stripe.Backend
+	Key string
+}
+
+// Retrieves an invoice rendering template with the given ID. It by default returns the latest version of the template. Optionally, specify a version to see previous versions.
+func Get(id string, params *stripe.InvoiceRenderingTemplateParams) (*stripe.InvoiceRenderingTemplate, error) {
+	return getC().Get(id, params)
+}
+
+// Retrieves an invoice rendering template with the given ID. It by default returns the latest version of the template. Optionally, specify a version to see previous versions.
+func (c Client) Get(id string, params *stripe.InvoiceRenderingTemplateParams) (*stripe.InvoiceRenderingTemplate, error) {
+	path := stripe.FormatURLPath("/v1/invoice_rendering_templates/%s", id)
+	invoicerenderingtemplate := &stripe.InvoiceRenderingTemplate{}
+	err := c.B.Call(http.MethodGet, path, c.Key, params, invoicerenderingtemplate)
+	return invoicerenderingtemplate, err
+}
+
+// Updates the status of an invoice rendering template to ‘archived' so no new Stripe objects (customers, invoices, etc.) can reference it. The template can also no longer be updated. However, if the template is already set on a Stripe object, it will continue to be applied on invoices generated by it.
+func Archive(id string, params *stripe.InvoiceRenderingTemplateArchiveParams) (*stripe.InvoiceRenderingTemplate, error) {
+	return getC().Archive(id, params)
+}
+
+// Updates the status of an invoice rendering template to ‘archived' so no new Stripe objects (customers, invoices, etc.) can reference it. The template can also no longer be updated. However, if the template is already set on a Stripe object, it will continue to be applied on invoices generated by it.
+func (c Client) Archive(id string, params *stripe.InvoiceRenderingTemplateArchiveParams) (*stripe.InvoiceRenderingTemplate, error) {
+	path := stripe.FormatURLPath("/v1/invoice_rendering_templates/%s/archive", id)
+	invoicerenderingtemplate := &stripe.InvoiceRenderingTemplate{}
+	err := c.B.Call(
+		http.MethodPost,
+		path,
+		c.Key,
+		params,
+		invoicerenderingtemplate,
+	)
+	return invoicerenderingtemplate, err
+}
+
+// Unarchive an invoice rendering template so it can be used on new Stripe objects again.
+func Unarchive(id string, params *stripe.InvoiceRenderingTemplateUnarchiveParams) (*stripe.InvoiceRenderingTemplate, error) {
+	return getC().Unarchive(id, params)
+}
+
+// Unarchive an invoice rendering template so it can be used on new Stripe objects again.
+func (c Client) Unarchive(id string, params *stripe.InvoiceRenderingTemplateUnarchiveParams) (*stripe.InvoiceRenderingTemplate, error) {
+	path := stripe.FormatURLPath(
+		"/v1/invoice_rendering_templates/%s/unarchive",
+		id,
+	)
+	invoicerenderingtemplate := &stripe.InvoiceRenderingTemplate{}
+	err := c.B.Call(
+		http.MethodPost,
+		path,
+		c.Key,
+		params,
+		invoicerenderingtemplate,
+	)
+	return invoicerenderingtemplate, err
+}
+
+// List all templates, ordered by creation date, with the most recently created template appearing first.
+func List(params *stripe.InvoiceRenderingTemplateListParams) *Iter {
+	return getC().List(params)
+}
+
+// List all templates, ordered by creation date, with the most recently created template appearing first.
+func (c Client) List(listParams *stripe.InvoiceRenderingTemplateListParams) *Iter {
+	return &Iter{
+		Iter: stripe.GetIter(listParams, func(p *stripe.Params, b *form.Values) ([]interface{}, stripe.ListContainer, error) {
+			list := &stripe.InvoiceRenderingTemplateList{}
+			err := c.B.CallRaw(http.MethodGet, "/v1/invoice_rendering_templates", c.Key, b, p, list)
+
+			ret := make([]interface{}, len(list.Data))
+			for i, v := range list.Data {
+				ret[i] = v
+			}
+
+			return ret, list, err
+		}),
+	}
+}
+
+// Iter is an iterator for invoice rendering templates.
+type Iter struct {
+	*stripe.Iter
+}
+
+// InvoiceRenderingTemplate returns the invoice rendering template which the iterator is currently pointing to.
+func (i *Iter) InvoiceRenderingTemplate() *stripe.InvoiceRenderingTemplate {
+	return i.Current().(*stripe.InvoiceRenderingTemplate)
+}
+
+// InvoiceRenderingTemplateList returns the current list object which the iterator is
+// currently using. List objects will change as new API calls are made to
+// continue pagination.
+func (i *Iter) InvoiceRenderingTemplateList() *stripe.InvoiceRenderingTemplateList {
+	return i.List().(*stripe.InvoiceRenderingTemplateList)
+}
+
+func getC() Client {
+	return Client{stripe.GetBackend(stripe.APIBackend), stripe.Key}
+}

issuing_card.go

@@ -81,6 +81,7 @@ const (
 	IssuingCardShippingStatusPending   IssuingCardShippingStatus = "pending"
 	IssuingCardShippingStatusReturned  IssuingCardShippingStatus = "returned"
 	IssuingCardShippingStatusShipped   IssuingCardShippingStatus = "shipped"
+	IssuingCardShippingStatusSubmitted IssuingCardShippingStatus = "submitted"
 )
 
 // Packaging options.

paymentlink.go

@@ -198,6 +198,14 @@ const (
 	PaymentLinkSubscriptionDataTrialSettingsEndBehaviorMissingPaymentMethodPause         PaymentLinkSubscriptionDataTrialSettingsEndBehaviorMissingPaymentMethod = "pause"
 )
 
+type PaymentLinkTaxIDCollectionRequired string
+
+// List of values that PaymentLinkTaxIDCollectionRequired can take
+const (
+	PaymentLinkTaxIDCollectionRequiredIfSupported PaymentLinkTaxIDCollectionRequired = "if_supported"
+	PaymentLinkTaxIDCollectionRequiredNever       PaymentLinkTaxIDCollectionRequired = "never"
+)
+
 // Returns a list of your payment links.
 type PaymentLinkListParams struct {
 	ListParams `form:"*"`
@@ -566,6 +574,8 @@ func (p *PaymentLinkSubscriptionDataParams) AddMetadata(key string, value string
 type PaymentLinkTaxIDCollectionParams struct {
 	// Enable tax ID collection during checkout. Defaults to `false`.
 	Enabled *bool `form:"enabled"`
+	// Describes whether a tax ID is required during checkout. Defaults to `never`.
+	Required *string `form:"required"`
 }
 
 // The account (if any) the payments will be attributed to for tax reporting, and where funds from each payment will be transferred to.
@@ -930,7 +940,8 @@ type PaymentLinkSubscriptionData struct {
 }
 type PaymentLinkTaxIDCollection struct {
 	// Indicates whether tax ID collection is enabled for the session.
-	Enabled bool `json:"enabled"`
+	Enabled  bool                               `json:"enabled"`
+	Required PaymentLinkTaxIDCollectionRequired `json:"required"`
 }
 
 // The account (if any) the payments will be attributed to for tax reporting, and where funds from each payment will be transferred to.

quote.go

@@ -170,7 +170,7 @@ type QuoteAutomaticTaxParams struct {
 	Liability *QuoteAutomaticTaxLiabilityParams `form:"liability"`
 }
 
-// The discounts applied to the quote. You can only set up to one discount.
+// The discounts applied to the quote.
 type QuoteDiscountParams struct {
 	// ID of the coupon to create a new discount for.
 	Coupon *string `form:"coupon"`
@@ -310,7 +310,7 @@ type QuoteParams struct {
 	DefaultTaxRates []*string `form:"default_tax_rates"`
 	// A description that will be displayed on the quote PDF. If no value is passed, the default description configured in your [quote template settings](https://dashboard.stripe.com/settings/billing/quote) will be used.
 	Description *string `form:"description"`
-	// The discounts applied to the quote. You can only set up to one discount.
+	// The discounts applied to the quote.
 	Discounts []*QuoteDiscountParams `form:"discounts"`
 	// Specifies which fields in the response should be expanded.
 	Expand []*string `form:"expand"`

subscription.go

@@ -716,10 +716,14 @@ type SubscriptionListParams struct {
 	// Only return subscriptions that were created during the given date interval.
 	Created *int64 `form:"created"`
 	// Only return subscriptions that were created during the given date interval.
-	CreatedRange            *RangeQueryParams `form:"created"`
-	CurrentPeriodEnd        *int64            `form:"current_period_end"`
-	CurrentPeriodEndRange   *RangeQueryParams `form:"current_period_end"`
-	CurrentPeriodStart      *int64            `form:"current_period_start"`
+	CreatedRange *RangeQueryParams `form:"created"`
+	// Only return subscriptions whose current_period_end falls within the given date interval.
+	CurrentPeriodEnd *int64 `form:"current_period_end"`
+	// Only return subscriptions whose current_period_end falls within the given date interval.
+	CurrentPeriodEndRange *RangeQueryParams `form:"current_period_end"`
+	// Only return subscriptions whose current_period_start falls within the given date interval.
+	CurrentPeriodStart *int64 `form:"current_period_start"`
+	// Only return subscriptions whose current_period_start falls within the given date interval.
 	CurrentPeriodStartRange *RangeQueryParams `form:"current_period_start"`
 	// The ID of the customer whose subscriptions will be retrieved.
 	Customer *string `form:"customer"`