v3

type Addon struct {
	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// Currency The currency code of the add-on.
	Currency BillingCurrencyCode `json:"currency"`

	// DeletedAt An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`

	// EffectiveFrom The date and time when the add-on becomes effective. When not specified, the
	// add-on is a draft.
	EffectiveFrom *DateTime `json:"effective_from,omitempty"`

	// EffectiveTo The date and time when the add-on is no longer effective. When not specified,
	// the add-on is effective indefinitely.
	EffectiveTo *DateTime `json:"effective_to,omitempty"`
	Id          ULID      `json:"id"`

	// InstanceType The InstanceType of the add-ons. Can be "single" or "multiple".
	InstanceType AddonInstanceType `json:"instance_type"`

	// Key A key is a semi-unique string that is used to identify the add-on. It is used to
	// reference the latest `active` version of the add-on and is unique with the
	// version number.
	Key ResourceKey `json:"key"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// RateCards The rate cards of the add-on.
	RateCards []BillingRateCard `json:"rate_cards"`

	// Status The status of the add-on. Computed based on the effective start and end dates:
	//
	// - `draft`: `effective_from` is not set.
	// - `active`: `effective_from <= now` and (`effective_to` is not set or
	// `now < effective_to`).
	// - `archived`: `effective_to <= now`.
	Status AddonStatus `json:"status"`

	// UpdatedAt An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt DateTime `json:"updated_at"`

	// ValidationErrors List of validation errors.
	ValidationErrors *[]ProductCatalogValidationError `json:"validation_errors,omitempty"`

	// Version Version of the add-on. Incremented when the add-on is updated.
	Version int `json:"version"`
}

type AddonInstanceType string

type AddonPagePaginatedResponse struct {
	Data []Addon `json:"data"`

	// Meta returns the pagination information
	Meta PaginatedMeta `json:"meta"`
}

type AddonReference struct {
	// Id ULID (Universally Unique Lexicographically Sortable Identifier).
	Id ULID `json:"id"`
}

type AddonStatus string

type Address struct {
	// City City.
	City *string `json:"city,omitempty"`

	// Country Country code in [ISO 3166-1](https://www.iso.org/iso-3166-country-codes.html)
	// alpha-2 format.
	Country *CountryCode `json:"country,omitempty"`

	// Line1 First line of the address.
	Line1 *string `json:"line1,omitempty"`

	// Line2 Second line of the address.
	Line2 *string `json:"line2,omitempty"`

	// PhoneNumber Phone number.
	PhoneNumber *string `json:"phone_number,omitempty"`

	// PostalCode Postal code.
	PostalCode *string `json:"postal_code,omitempty"`

	// State State or province.
	State *string `json:"state,omitempty"`
}

type AppCatalogItemPagePaginatedResponse struct {
	Data []BillingAppCatalogItem `json:"data"`

	// Meta returns the pagination information
	Meta PaginatedMeta `json:"meta"`
}

type AppPagePaginatedResponse struct {
	Data []BillingApp `json:"data"`

	// Meta returns the pagination information
	Meta PaginatedMeta `json:"meta"`
}

type BadRequest = BadRequestError

type BadRequestError struct {
	// Detail A human readable explanation specific to this occurence of the problem.
	// This field may contain request/entity data to help the user understand
	// what went wrong. Enclose variable values in square brackets. Should be
	// provided as "Sentence case" for direct use in the UI.
	Detail string `json:"detail"`

	// Instance Used to return the correlation ID back to the user, in the format
	// kong:trace:<correlation_id>. This helps us find the relevant logs
	// when a customer reports an issue.
	Instance string `json:"instance"`

	// InvalidParameters invalid parameters
	InvalidParameters InvalidParameters `json:"invalid_parameters"`

	// Status The HTTP status code of the error. Useful when passing the response
	// body to child properties in a frontend UI. Must be returned as an integer.
	Status int `json:"status"`

	// Title A short, human-readable summary of the problem. It should not
	// change between occurences of a problem, except for localization.
	// Should be provided as "Sentence case" for direct use in the UI.
	Title string `json:"title"`

	// Type The error type.
	Type *string `json:"type,omitempty"`
}

type BaseError struct {
	// Detail A human readable explanation specific to this occurence of the problem.
	// This field may contain request/entity data to help the user understand
	// what went wrong. Enclose variable values in square brackets. Should be
	// provided as "Sentence case" for direct use in the UI.
	Detail string `json:"detail"`

	// Instance Used to return the correlation ID back to the user, in the format
	// kong:trace:<correlation_id>. This helps us find the relevant logs
	// when a customer reports an issue.
	Instance string `json:"instance"`

	// Status The HTTP status code of the error. Useful when passing the response
	// body to child properties in a frontend UI. Must be returned as an integer.
	Status int `json:"status"`

	// Title A short, human-readable summary of the problem. It should not
	// change between occurences of a problem, except for localization.
	// Should be provided as "Sentence case" for direct use in the UI.
	Title string `json:"title"`

	// Type The error type.
	Type *string `json:"type,omitempty"`
}

type BillingApp struct {
	// contains filtered or unexported fields
}

type BillingAppAction struct {
	// Description Human readable explanation of why the action is needed.
	Description string `json:"description"`

	// Type The action type.
	Type BillingAppActionType `json:"type"`
}

type BillingAppActionRequest struct {
	// contains filtered or unexported fields
}

type BillingAppActionType string

type BillingAppCapability struct {
	// Description Description of the capability.
	Description string `json:"description"`

	// Key Key of the capability.
	Key ResourceKey `json:"key"`

	// Name Name of the capability.
	Name string `json:"name"`

	// Type Type of the capability.
	Type BillingAppCapabilityType `json:"type"`
}

type BillingAppCapabilityType string

type BillingAppCatalogItem struct {
	// Capabilities Capabilities of the app.
	Capabilities []BillingAppCapability `json:"capabilities"`

	// Description Description of the app.
	Description string `json:"description"`

	// InstallMethods Available install methods of the app.
	InstallMethods []BillingAppInstallMethods `json:"install_methods"`

	// Name Name of the app.
	Name string `json:"name"`

	// Type Type of the app.
	Type BillingAppType `json:"type"`
}

type BillingAppCustomerData struct {
	// ExternalInvoicing Used if the customer has a linked external invoicing app.
	//
	// Set to `null` to remove the external invoicing data of the customer; omit to
	// leave it unchanged.
	ExternalInvoicing nullable.Nullable[BillingAppCustomerDataExternalInvoicing] `json:"external_invoicing,omitempty"`

	// Stripe Used if the customer has a linked Stripe app.
	//
	// Set to `null` to remove the Stripe data of the customer; omit to leave it
	// unchanged.
	Stripe nullable.Nullable[BillingAppCustomerDataStripe] `json:"stripe,omitempty"`
}

type BillingAppCustomerDataExternalInvoicing struct {
	// Labels Labels for this external invoicing integration on the customer.
	Labels *Labels `json:"labels,omitempty"`
}

type BillingAppCustomerDataStripe struct {
	// CustomerId The Stripe customer ID used.
	CustomerId *string `json:"customer_id,omitempty"`

	// DefaultPaymentMethodId The Stripe default payment method ID.
	DefaultPaymentMethodId *string `json:"default_payment_method_id,omitempty"`

	// Labels Labels for this Stripe integration on the customer.
	Labels *Labels `json:"labels,omitempty"`
}

type BillingAppExternalInvoicing struct {
	// Actions Actions the operator should take to bring the app up to date. Omitted when no
	// action is required.
	Actions *[]BillingAppAction `json:"actions,omitempty"`

	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// Definition The app catalog definition that this installed app is based on.
	Definition BillingAppCatalogItem `json:"definition"`

	// DeletedAt An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`

	// EnableDraftSyncHook Enable draft synchronization hook.
	//
	// When enabled, invoices will pause at the draft state and wait for the
	// integration to call the draft synchronized endpoint before progressing to the
	// issuing state. This allows the external system to validate and prepare the
	// invoice data.
	//
	// When disabled, invoices automatically progress through the draft state based on
	// the configured workflow timing.
	EnableDraftSyncHook bool `json:"enable_draft_sync_hook"`

	// EnableIssuingSyncHook Enable issuing synchronization hook.
	//
	// When enabled, invoices will pause at the issuing state and wait for the
	// integration to call the issuing synchronized endpoint before progressing to the
	// issued state. This ensures the external invoicing system has successfully
	// created and finalized the invoice before it is marked as issued.
	//
	// When disabled, invoices automatically progress through the issuing state and are
	// immediately marked as issued.
	EnableIssuingSyncHook bool `json:"enable_issuing_sync_hook"`
	Id                    ULID `json:"id"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// Status Status of the app connection.
	Status BillingAppStatus `json:"status"`

	// Type The app type.
	Type BillingAppExternalInvoicingType `json:"type"`

	// UpdatedAt An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt DateTime `json:"updated_at"`
}

type BillingAppExternalInvoicingType string

type BillingAppInstallMethods string

type BillingAppReconcileWebhookEventsActionRequest struct {
	// ActionType The action to execute.
	ActionType BillingAppReconcileWebhookEventsActionRequestActionType `json:"action_type"`
}

type BillingAppReconcileWebhookEventsActionRequestActionType string

type BillingAppReference struct {
	// Id The ID of the app.
	Id ULID `json:"id"`
}

type BillingAppSandbox struct {
	// Actions Actions the operator should take to bring the app up to date. Omitted when no
	// action is required.
	Actions *[]BillingAppAction `json:"actions,omitempty"`

	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// Definition The app catalog definition that this installed app is based on.
	Definition BillingAppCatalogItem `json:"definition"`

	// DeletedAt An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`
	Id          ULID    `json:"id"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// Status Status of the app connection.
	Status BillingAppStatus `json:"status"`

	// Type The app type.
	Type BillingAppSandboxType `json:"type"`

	// UpdatedAt An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt DateTime `json:"updated_at"`
}

type BillingAppSandboxType string

type BillingAppStatus string

type BillingAppStripe struct {
	// AccountId The Stripe account ID associated with the connected Stripe account.
	AccountId string `json:"account_id"`

	// Actions Actions the operator should take to bring the app up to date. Omitted when no
	// action is required.
	Actions *[]BillingAppAction `json:"actions,omitempty"`

	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// Definition The app catalog definition that this installed app is based on.
	Definition BillingAppCatalogItem `json:"definition"`

	// DeletedAt An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`
	Id          ULID    `json:"id"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Livemode Indicates whether the app is connected to a live Stripe account.
	Livemode bool `json:"livemode"`

	// MaskedApiKey The masked Stripe API key that only exposes the first and last few characters.
	MaskedApiKey string `json:"masked_api_key"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// Status Status of the app connection.
	Status BillingAppStatus `json:"status"`

	// Type The app type.
	Type BillingAppStripeType `json:"type"`

	// UpdatedAt An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt DateTime `json:"updated_at"`
}

type BillingAppStripeCheckoutSessionCustomTextParams struct {
	// AfterSubmit Text displayed after the payment confirmation button.
	AfterSubmit *struct {
		// Message The custom message text (max 1200 characters).
		Message *string `json:"message,omitempty"`
	} `json:"after_submit,omitempty"`

	// ShippingAddress Text displayed alongside shipping address collection.
	ShippingAddress *struct {
		// Message The custom message text (max 1200 characters).
		Message *string `json:"message,omitempty"`
	} `json:"shipping_address,omitempty"`

	// Submit Text displayed alongside the payment confirmation button.
	Submit *struct {
		// Message The custom message text (max 1200 characters).
		Message *string `json:"message,omitempty"`
	} `json:"submit,omitempty"`

	// TermsOfServiceAcceptance Text replacing the default terms of service agreement text.
	TermsOfServiceAcceptance *struct {
		// Message The custom message text (max 1200 characters).
		Message *string `json:"message,omitempty"`
	} `json:"terms_of_service_acceptance,omitempty"`
}

type BillingAppStripeCheckoutSessionMode string

type BillingAppStripeCheckoutSessionUIMode string

type BillingAppStripeCreateCheckoutSessionBillingAddressCollection string

type BillingAppStripeCreateCheckoutSessionConsentCollection struct {
	// PaymentMethodReuseAgreement Controls the visibility of payment method reuse agreement.
	PaymentMethodReuseAgreement *BillingAppStripeCreateCheckoutSessionConsentCollectionPaymentMethodReuseAgreement `json:"payment_method_reuse_agreement,omitempty"`

	// Promotions Enables collection of promotional communication consent.
	//
	// Only available to US merchants. When set to "auto", Checkout determines whether
	// to show the option based on the customer's locale.
	Promotions *BillingAppStripeCreateCheckoutSessionConsentCollectionPromotions `json:"promotions,omitempty"`

	// TermsOfService Requires customers to accept terms of service before payment.
	//
	// Requires a valid terms of service URL in your Stripe Dashboard settings.
	TermsOfService *BillingAppStripeCreateCheckoutSessionConsentCollectionTermsOfService `json:"terms_of_service,omitempty"`
}

type BillingAppStripeCreateCheckoutSessionConsentCollectionPaymentMethodReuseAgreement struct {
	// Position Position and visibility of the payment method reuse agreement.
	Position *BillingAppStripeCreateCheckoutSessionConsentCollectionPaymentMethodReuseAgreementPosition `json:"position,omitempty"`
}

type BillingAppStripeCreateCheckoutSessionConsentCollectionPaymentMethodReuseAgreementPosition string

type BillingAppStripeCreateCheckoutSessionConsentCollectionPromotions string

type BillingAppStripeCreateCheckoutSessionConsentCollectionTermsOfService string

type BillingAppStripeCreateCheckoutSessionCustomerUpdate struct {
	// Address Whether to save the billing address to customer.address.
	//
	// Defaults to "never".
	Address *BillingAppStripeCreateCheckoutSessionCustomerUpdateBehavior `json:"address,omitempty"`

	// Name Whether to save the customer name to customer.name.
	//
	// Defaults to "never".
	Name *BillingAppStripeCreateCheckoutSessionCustomerUpdateBehavior `json:"name,omitempty"`

	// Shipping Whether to save shipping information to customer.shipping.
	//
	// Defaults to "never".
	Shipping *BillingAppStripeCreateCheckoutSessionCustomerUpdateBehavior `json:"shipping,omitempty"`
}

type BillingAppStripeCreateCheckoutSessionCustomerUpdateBehavior string

type BillingAppStripeCreateCheckoutSessionRedirectOnCompletion string

type BillingAppStripeCreateCheckoutSessionRequestOptions struct {
	// BillingAddressCollection Whether to collect the customer's billing address.
	//
	// Defaults to auto, which only collects the address when necessary for tax
	// calculation.
	BillingAddressCollection *BillingAppStripeCreateCheckoutSessionBillingAddressCollection `json:"billing_address_collection,omitempty"`

	// CancelUrl URL to redirect customers who cancel the checkout session.
	//
	// Not allowed when ui_mode is "embedded".
	CancelUrl *string `json:"cancel_url,omitempty"`

	// ClientReferenceId Unique reference string for reconciling sessions with internal systems.
	//
	// Can be a customer ID, cart ID, or any other identifier.
	ClientReferenceId *string `json:"client_reference_id,omitempty"`

	// ConsentCollection Configuration for collecting customer consent during checkout.
	ConsentCollection *BillingAppStripeCreateCheckoutSessionConsentCollection `json:"consent_collection,omitempty"`

	// Currency Three-letter ISO 4217 currency code in uppercase.
	//
	// Required for payment mode sessions. Optional for setup mode sessions.
	Currency *CurrencyCode `json:"currency,omitempty"`

	// CustomText Custom text to display during checkout at various stages.
	CustomText *BillingAppStripeCheckoutSessionCustomTextParams `json:"custom_text,omitempty"`

	// CustomerUpdate Controls which customer fields can be updated by the checkout session.
	CustomerUpdate *BillingAppStripeCreateCheckoutSessionCustomerUpdate `json:"customer_update,omitempty"`

	// ExpiresAt Unix timestamp when the checkout session expires.
	//
	// Can be 30 minutes to 24 hours from creation. Defaults to 24 hours.
	ExpiresAt *int64 `json:"expires_at,omitempty"`

	// Locale IETF language tag for the checkout UI locale.
	//
	// If blank or "auto", uses the browser's locale. Example: "en", "fr", "de".
	Locale *string `json:"locale,omitempty"`

	// Metadata Set of key-value pairs to attach to the checkout session.
	//
	// Useful for storing additional structured information.
	Metadata *map[string]string `json:"metadata,omitempty"`

	// PaymentMethodTypes List of payment method types to enable (e.g., "card", "us_bank_account").
	//
	// If not specified, Stripe enables all relevant payment methods.
	PaymentMethodTypes *[]string `json:"payment_method_types,omitempty"`

	// RedirectOnCompletion Redirect behavior for embedded checkout sessions.
	//
	// Controls when to redirect users after completion. See:
	// https://docs.stripe.com/payments/checkout/custom-success-page?payment-ui=embedded-form
	RedirectOnCompletion *BillingAppStripeCreateCheckoutSessionRedirectOnCompletion `json:"redirect_on_completion,omitempty"`

	// ReturnUrl Return URL for embedded checkout sessions after payment authentication.
	//
	// Required if ui_mode is "embedded" and redirect-based payment methods are
	// enabled.
	ReturnUrl *string `json:"return_url,omitempty"`

	// SuccessUrl Success URL to redirect customers after completing payment or setup.
	//
	// Not allowed when ui_mode is "embedded". See:
	// https://docs.stripe.com/payments/checkout/custom-success-page
	SuccessUrl *string `json:"success_url,omitempty"`

	// TaxIdCollection Configuration for collecting tax IDs during checkout.
	TaxIdCollection *BillingAppStripeCreateCheckoutSessionTaxIdCollection `json:"tax_id_collection,omitempty"`

	// UiMode The UI mode for the checkout session.
	//
	// "hosted" displays a Stripe-hosted page. "embedded" integrates directly into your
	// app. Defaults to "hosted".
	UiMode *BillingAppStripeCheckoutSessionUIMode `json:"ui_mode,omitempty"`
}

type BillingAppStripeCreateCheckoutSessionResult struct {
	// CancelUrl The cancel URL where customers are redirected if they cancel.
	CancelUrl *string `json:"cancel_url,omitempty"`

	// ClientReferenceId The client reference ID provided in the request.
	//
	// Useful for reconciling the session with your internal systems.
	ClientReferenceId *string `json:"client_reference_id,omitempty"`

	// ClientSecret Client secret for initializing Stripe.js on the client side.
	//
	// Required for embedded checkout sessions. See:
	// https://docs.stripe.com/payments/checkout/custom-success-page
	ClientSecret *string `json:"client_secret,omitempty"`

	// CreatedAt Timestamp when the checkout session was created.
	CreatedAt DateTime `json:"created_at"`

	// Currency Currency code for the checkout session.
	Currency *CurrencyCode `json:"currency,omitempty"`

	// CustomerEmail Customer's email address if provided to Stripe.
	CustomerEmail *string `json:"customer_email,omitempty"`

	// CustomerId The customer ID in the billing system.
	CustomerId ULID `json:"customer_id"`

	// ExpiresAt Timestamp when the checkout session will expire.
	ExpiresAt *DateTime `json:"expires_at,omitempty"`

	// Metadata Metadata attached to the checkout session.
	Metadata *map[string]string `json:"metadata,omitempty"`

	// Mode Mode of the checkout session.
	//
	// Currently only "setup" mode is supported for collecting payment methods.
	Mode BillingAppStripeCheckoutSessionMode `json:"mode"`

	// ReturnUrl The return URL for embedded sessions after authentication.
	ReturnUrl *string `json:"return_url,omitempty"`

	// SessionId The Stripe checkout session ID.
	SessionId string `json:"session_id"`

	// SetupIntentId The setup intent ID created for collecting the payment method.
	SetupIntentId string `json:"setup_intent_id"`

	// Status The status of the checkout session.
	//
	// See:
	// https://docs.stripe.com/api/checkout/sessions/object#checkout_session_object-status
	Status *string `json:"status,omitempty"`

	// StripeCustomerId The Stripe customer ID.
	StripeCustomerId string `json:"stripe_customer_id"`

	// SuccessUrl The success URL where customers are redirected after completion.
	SuccessUrl *string `json:"success_url,omitempty"`

	// Url URL to redirect customers to the checkout page (for hosted mode).
	Url *string `json:"url,omitempty"`
}

type BillingAppStripeCreateCheckoutSessionTaxIdCollection struct {
	// Enabled Enable tax ID collection during checkout.
	//
	// Defaults to false.
	Enabled *bool `json:"enabled,omitempty"`

	// Required Whether tax ID collection is required.
	//
	// Defaults to "never".
	Required *BillingAppStripeCreateCheckoutSessionTaxIdCollectionRequired `json:"required,omitempty"`
}

type BillingAppStripeCreateCheckoutSessionTaxIdCollectionRequired string

type BillingAppStripeCreateCustomerPortalSessionOptions struct {
	// ConfigurationId The ID of an existing
	// [Stripe configuration](https://docs.stripe.com/api/customer_portal/configurations)
	// to use for this session, describing its functionality and features. If not
	// specified, the session uses the default configuration.
	ConfigurationId *string `json:"configuration_id,omitempty"`

	// Locale The IETF
	// [language tag](https://docs.stripe.com/api/customer_portal/sessions/create#create_portal_session-locale)
	// of the locale customer portal is displayed in. If blank or `auto`, the
	// customer's preferred_locales or browser's locale is used.
	Locale *string `json:"locale,omitempty"`

	// ReturnUrl The
	// [URL to redirect](https://docs.stripe.com/api/customer_portal/sessions/create#create_portal_session-return_url)
	// the customer to after they have completed their requested actions.
	ReturnUrl *string `json:"return_url,omitempty"`
}

type BillingAppStripeCreateCustomerPortalSessionResult struct {
	// ConfigurationId Configuration used to customize the customer portal.
	//
	// See:
	// https://docs.stripe.com/api/customer_portal/sessions/object#portal_session_object-configuration
	ConfigurationId string `json:"configuration_id"`

	// CreatedAt Created at.
	//
	// See:
	// https://docs.stripe.com/api/customer_portal/sessions/object#portal_session_object-created
	CreatedAt DateTime `json:"created_at"`

	// Id The ID of the customer portal session.
	//
	// See:
	// https://docs.stripe.com/api/customer_portal/sessions/object#portal_session_object-id
	Id string `json:"id"`

	// Livemode Livemode.
	//
	// See:
	// https://docs.stripe.com/api/customer_portal/sessions/object#portal_session_object-livemode
	Livemode bool `json:"livemode"`

	// Locale The IETF language tag of the locale customer portal is displayed in.
	//
	// See:
	// https://docs.stripe.com/api/customer_portal/sessions/object#portal_session_object-locale
	Locale string `json:"locale"`

	// ReturnUrl Return URL.
	//
	// See:
	// https://docs.stripe.com/api/customer_portal/sessions/object#portal_session_object-return_url
	ReturnUrl string `json:"return_url"`

	// StripeCustomerId The ID of the stripe customer.
	StripeCustomerId string `json:"stripe_customer_id"`

	// Url The URL to redirect the customer to after they have completed their requested
	// actions.
	Url string `json:"url"`
}

type BillingAppStripeType string

type BillingAppType string

type BillingCharge struct {
	// contains filtered or unexported fields
}

type BillingChargeCostBasis struct {
	// contains filtered or unexported fields
}

type BillingChargeCostBasisDynamic struct {
	// FiatCurrency The fiat currency the charge amount is converted into for invoicing.
	FiatCurrency CurrencyCode `json:"fiat_currency"`

	// Type Discriminator selecting the cost basis mode.
	Type BillingChargeCostBasisDynamicType `json:"type"`
}

type BillingChargeCostBasisDynamicType string

type BillingChargeCostBasisManual struct {
	// FiatCurrency The fiat currency the charge amount is converted into for invoicing.
	FiatCurrency *CurrencyCode `json:"fiat_currency,omitempty"`

	// Rate Fiat amount per one unit of the custom currency.
	Rate Numeric `json:"rate"`

	// Type Discriminator selecting the cost basis mode.
	Type BillingChargeCostBasisManualType `json:"type"`
}

type BillingChargeCostBasisManualType string

type BillingChargeCostBasisPinned struct {
	// CostBasisId ID of the custom currency's cost basis resource to pin.
	CostBasisId ULID `json:"cost_basis_id"`

	// FiatCurrency The fiat currency the charge amount is converted into for invoicing.
	FiatCurrency CurrencyCode `json:"fiat_currency"`

	// Type Discriminator selecting the cost basis mode.
	Type BillingChargeCostBasisPinnedType `json:"type"`
}

type BillingChargeCostBasisPinnedType string

type BillingChargeFlatFee struct {
	// AdvanceAfter The earliest time when the charge should be advanced again by background
	// processing.
	AdvanceAfter *DateTime `json:"advance_after,omitempty"`

	// AmountAfterProration The amount after proration of the charge.
	AmountAfterProration BillingCurrencyAmount `json:"amount_after_proration"`

	// BillingPeriod The billing period the charge belongs to.
	BillingPeriod ClosedPeriod `json:"billing_period"`

	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// Currency The currency of the charge.
	Currency BillingCurrencyCode `json:"currency"`

	// Customer The customer owning the charge.
	//
	// By default, only the `id` of the customer is returned. For more details use the
	// `customer` expand.
	Customer CustomerOrReference `json:"customer"`

	// DeletedAt An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`

	// Discounts The discounts applied to the charge.
	Discounts *BillingChargeFlatFeeDiscounts `json:"discounts,omitempty"`

	// Feature The feature associated with the charge, when applicable.
	Feature *FeatureOrReference `json:"feature,omitempty"`

	// FullServicePeriod The full, unprorated service period of the charge.
	FullServicePeriod ClosedPeriod `json:"full_service_period"`
	Id                ULID         `json:"id"`

	// InvoiceAt The timestamp when the charge is intended to be invoiced.
	InvoiceAt DateTime `json:"invoice_at"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// LifecycleController Indicates whether the charge lifecycle is controlled by the system or manually
	// overridden by the API user.
	LifecycleController BillingLifecycleController `json:"lifecycle_controller"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// PaymentTerm Payment term of the flat fee charge.
	PaymentTerm BillingPricePaymentTerm `json:"payment_term"`

	// Price The price of the charge.
	Price BillingPriceFlat `json:"price"`

	// ProrationConfiguration The proration configuration of the charge.
	ProrationConfiguration BillingRateCardProrationConfiguration `json:"proration_configuration"`

	// Realizations The realization runs of the charge, sorted by `created_at`.
	Realizations []BillingChargeRealization `json:"realizations"`

	// ResolvedCostBasis The resolved fiat conversion rate of a custom-currency charge. Resolution
	// depends on costbasis type: dynamic is resolved when charge becomes active, all
	// other types resolved on creation.
	ResolvedCostBasis *BillingChargeResolvedCostBasis `json:"resolved_cost_basis,omitempty"`

	// ServicePeriod The effective service period covered by the charge.
	ServicePeriod ClosedPeriod `json:"service_period"`

	// SettlementMode Settlement mode of the charge.
	SettlementMode BillingSettlementMode `json:"settlement_mode"`

	// Status The lifecycle status of the charge.
	Status BillingChargeStatus `json:"status"`

	// Subscription The subscription that originated the charge, when the charge was created from a
	// subscription item.
	//
	// By default, only the `id`, `phase.id`, `phase.item.id` of the subscription is
	// returned. For more details use the `subscription` expand.
	Subscription *SubscriptionOrReference `json:"subscription,omitempty"`

	// SystemIntent Current intent from the system lifecycle controller for a charge that has an
	// active manual override. The top-level charge fields remain the effective
	// customer-facing intent.
	SystemIntent *BillingChargeFlatFeeSystemIntent `json:"system_intent,omitempty"`

	// TaxConfig Tax configuration of the charge.
	TaxConfig *BillingTaxConfig `json:"tax_config,omitempty"`

	// Type The type of the charge.
	Type BillingChargeFlatFeeType `json:"type"`

	// UniqueReferenceId Unique reference ID of the charge.
	UniqueReferenceId *string `json:"unique_reference_id,omitempty"`

	// UpdatedAt An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt DateTime `json:"updated_at"`

	// ValidationIssues Validation issues found while processing the charge.
	//
	// Present only when there are one or more validation findings. An empty list is
	// omitted.
	ValidationIssues *[]BillingValidationIssue `json:"validation_issues,omitempty"`
}

type BillingChargeFlatFeeDiscounts struct {
	// Percentage Percentage discount applied to the price (0–100).
	Percentage *float32 `json:"percentage,omitempty"`
}

type BillingChargeFlatFeeSystemIntent struct {
	// AmountBeforeProration The amount before proration of the system lifecycle controller flat fee intent.
	AmountBeforeProration BillingCurrencyAmount `json:"amount_before_proration"`

	// BillingPeriod The billing period the charge belongs to.
	BillingPeriod ClosedPeriod `json:"billing_period"`

	// DeletedAt The timestamp when the system lifecycle controller intent was deleted. The
	// effective charge can remain visible while a manual override is active.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`

	// Discounts The discounts applied to the charge.
	Discounts *BillingChargeFlatFeeDiscounts `json:"discounts,omitempty"`

	// FullServicePeriod The full, unprorated service period of the charge.
	FullServicePeriod ClosedPeriod `json:"full_service_period"`

	// InvoiceAt The timestamp when the charge is intended to be invoiced.
	InvoiceAt DateTime `json:"invoice_at"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// PaymentTerm Payment term of the flat fee charge.
	PaymentTerm BillingPricePaymentTerm `json:"payment_term"`

	// ProrationConfiguration The proration configuration of the charge.
	ProrationConfiguration BillingRateCardProrationConfiguration `json:"proration_configuration"`

	// ServicePeriod The effective service period covered by the charge.
	ServicePeriod ClosedPeriod `json:"service_period"`
}

type BillingChargeFlatFeeType string

type BillingChargeRealization struct {
	// DetailedLines The detailed (rated) lines produced by the realization run.
	//
	// Requires the `realization.detailed_lines` expand.
	DetailedLines *[]BillingChargeRealizationDetailedLine `json:"detailed_lines,omitempty"`

	// Id The ID of the realization run. Not present on `outstanding` entries, which are
	// projections rather than persisted runs.
	Id *string `json:"id,omitempty"`

	// Invoice The reference of the invoice related to the realization.
	Invoice *ChargeRealizationInvoiceOrReference `json:"invoice,omitempty"`

	// LineId The ID of the invoice line this realization was booked to, when the realization
	// has been invoiced.
	LineId *string `json:"line_id,omitempty"`

	// Payment The payment state of the realization, when the charge requires a fiat
	// transaction to settle.
	Payment *BillingChargeRealizationPayment `json:"payment,omitempty"`

	// ServicePeriod The service period covered by this realization run.
	ServicePeriod ClosedPeriod `json:"service_period"`

	// Totals Financial totals for the realization run, including credit allocations.
	//
	// Requires the `realization.totals` expand.
	Totals *BillingTotals `json:"totals,omitempty"`

	// Type The type of the realization run.
	Type BillingChargeRealizationType `json:"type"`

	// Usage The metered usage quantity this realization run accounts for. Only present on
	// usage-based charges; flat fees are not metered, so their realizations carry no
	// usage.
	//
	// Booked entries report a signed delta: a negative value states a downward usage
	// correction (or a voided run that snapshotted behind its live neighbors) instead
	// of masking it as zero.
	//
	// On an `outstanding` entry this is `0` unless the `real_time_usage` expand is
	// applied, in which case it is the not-yet-booked remainder of the live metering
	// read (never negative).
	Usage *Numeric `json:"usage,omitempty"`
}

type BillingChargeRealizationAmountDiscount struct {
	// Amount The amount of the discount applied to the charge.
	Amount Numeric `json:"amount"`

	// ChildUniqueReferenceId Unique reference ID of the discount applied to the charge.
	ChildUniqueReferenceId string `json:"child_unique_reference_id"`

	// Description Optional human-readable description of the discount.
	Description *string `json:"description,omitempty"`

	// Reason The reason for the discount applied to the charge.
	Reason string `json:"reason"`

	// RoundingAmount The discount amount applied to the charge, rounded to the nearest cent (or
	// currency equivalent) and adjusted to compensate for rounding errors across
	// multiple discounted detail lines.
	RoundingAmount *Numeric `json:"rounding_amount,omitempty"`
}

type BillingChargeRealizationDetailedLine struct {
	// contains filtered or unexported fields
}

type BillingChargeRealizationDetailedLineCategory string

type BillingChargeRealizationDetailedLineCreditApplied struct {
	// Amount The monetary amount credited.
	Amount Numeric `json:"amount"`

	// CreditRealizationId The ID of the credit realization (allocation) this credit was applied from.
	CreditRealizationId string `json:"credit_realization_id"`

	// Description Human-readable description of the credit allocation.
	Description *string `json:"description,omitempty"`
}

type BillingChargeRealizationDetailedLineFlatFee struct {
	// AmountDiscounts The amount discounts applied to the detailed line.
	AmountDiscounts []BillingChargeRealizationAmountDiscount `json:"amount_discounts"`

	// Category The cost category of this detailed line.
	Category BillingChargeRealizationDetailedLineCategory `json:"category"`

	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// CreditsApplied Credits applied to this detailed line.
	CreditsApplied *[]BillingChargeRealizationDetailedLineCreditApplied `json:"credits_applied,omitempty"`

	// DeletedAt An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`
	Id        ULID      `json:"id"`

	// ServicePeriod The service period covered by this detailed line.
	ServicePeriod ClosedPeriod `json:"service_period"`

	// Totals Aggregated financial totals for the detailed line.
	Totals BillingTotals `json:"totals"`

	// Type The type of the charge the realization belongs to.
	Type BillingChargeRealizationDetailedLineFlatFeeType `json:"type"`

	// UnitPrice The unit price of the detailed line.
	UnitPrice Numeric `json:"unit_price"`

	// UpdatedAt An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt DateTime `json:"updated_at"`
}

type BillingChargeRealizationDetailedLineFlatFeeType string

type BillingChargeRealizationDetailedLineUsageBased struct {
	// AmountDiscounts The amount discounts applied to the detailed line.
	AmountDiscounts []BillingChargeRealizationAmountDiscount `json:"amount_discounts"`

	// Category The cost category of this detailed line.
	Category BillingChargeRealizationDetailedLineCategory `json:"category"`

	// CorrectsRunId The ID of a prior realization run this detailed line corrects. Only set if the
	// detailed line's totals are negative.
	CorrectsRunId *string `json:"corrects_run_id,omitempty"`

	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// CreditsApplied Credits applied to this detailed line.
	CreditsApplied *[]BillingChargeRealizationDetailedLineCreditApplied `json:"credits_applied,omitempty"`

	// DeletedAt An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`
	Id        ULID      `json:"id"`

	// Quantity The quantity of the detailed line.
	Quantity Numeric `json:"quantity"`

	// ServicePeriod The service period covered by this detailed line.
	ServicePeriod ClosedPeriod `json:"service_period"`

	// Totals Aggregated financial totals for the detailed line.
	Totals BillingTotals `json:"totals"`

	// Type The type of the charge the realization belongs to.
	Type BillingChargeRealizationDetailedLineUsageBasedType `json:"type"`

	// UnitPrice The unit price of the detailed line.
	UnitPrice Numeric `json:"unit_price"`

	// UpdatedAt An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt DateTime `json:"updated_at"`
}

type BillingChargeRealizationDetailedLineUsageBasedType string

type BillingChargeRealizationInvoice struct {
	// CollectionAt Timestamp when collection was initiated for this invoice.
	CollectionAt *DateTime `json:"collection_at,omitempty"`

	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// Currency Three-letter ISO 4217 currency code for the invoice.
	Currency CurrencyCode `json:"currency"`

	// DeletedAt An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`

	// DraftUntil Timestamp until which the invoice remains in draft state.
	//
	// The invoice advances automatically once this time is reached.
	DraftUntil *DateTime `json:"draft_until,omitempty"`

	// DueAt Timestamp when payment is due.
	DueAt *DateTime `json:"due_at,omitempty"`

	// ExternalReferences External identifiers assigned to this invoice by third-party systems.
	ExternalReferences *BillingInvoiceExternalReferences `json:"external_references,omitempty"`
	Id                 ULID                              `json:"id"`

	// IssuedAt Timestamp when the invoice was issued to the customer.
	IssuedAt *DateTime `json:"issued_at,omitempty"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Number Human-readable invoice number generated by the invoicing app.
	Number BillingInvoiceNumber `json:"number"`

	// QuantitySnapshottedAt Timestamp when usage quantities were last snapshotted for this invoice.
	QuantitySnapshottedAt *DateTime `json:"quantity_snapshotted_at,omitempty"`

	// SentToCustomerAt Timestamp when the invoice was sent to the customer.
	SentToCustomerAt *DateTime `json:"sent_to_customer_at,omitempty"`

	// ServicePeriod The service period covered by this invoice.
	//
	// For flat fee the service period can be empty which means `from` will be equals
	// to `to`. In other cases those fields will be filled with the actual service
	// period.
	ServicePeriod ClosedPeriod `json:"service_period"`

	// Status Current lifecycle status of the invoice.
	Status BillingInvoiceStandardStatus `json:"status"`

	// StatusDetails Detailed status information including available actions and workflow state.
	StatusDetails BillingInvoiceStatusDetails `json:"status_details"`

	// Supplier Snapshot of the supplier's contact information at the time the invoice was
	// issued.
	Supplier BillingSupplier `json:"supplier"`

	// Totals Aggregated financial totals for the invoice.
	Totals BillingTotals `json:"totals"`

	// Type Discriminator field identifying this as a standard invoice.
	Type BillingChargeRealizationInvoiceType `json:"type"`

	// UpdatedAt An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt DateTime `json:"updated_at"`

	// ValidationIssues Validation issues found during invoice processing.
	//
	// Present only when there are one or more validation findings. An empty list is
	// omitted.
	ValidationIssues *[]BillingValidationIssue `json:"validation_issues,omitempty"`

	// Workflow Workflow configuration snapshot captured at invoice creation time.
	Workflow BillingInvoiceWorkflowSettings `json:"workflow"`
}

type BillingChargeRealizationInvoiceType string

type BillingChargeRealizationPayment struct {
	// Status The settlement status of the payment.
	Status BillingChargeRealizationPaymentStatus `json:"status"`
}

type BillingChargeRealizationPaymentStatus string

type BillingChargeRealizationType string

type BillingChargeReference struct {
	// Id Unique identifier for the charge.
	Id ULID `json:"id"`
}

type BillingChargeResolvedCostBasis struct {
	// CostBasisId ID of the custom currency's cost basis resource the rate was taken from. Absent
	// for manual cost bases.
	CostBasisId *ULID `json:"cost_basis_id,omitempty"`

	// FiatCurrency The fiat currency the charge amount is converted into for invoicing.
	FiatCurrency CurrencyCode `json:"fiat_currency"`

	// Rate Fiat amount per one unit of the custom currency.
	Rate Numeric `json:"rate"`

	// ResolvedAt When the rate was resolved.
	ResolvedAt DateTime `json:"resolved_at"`
}

type BillingChargeStatus string

type BillingChargeTotals struct {
	// Booked The amount of the charge already booked to the internal accounting system.
	Booked BillingTotals `json:"booked"`

	// Realtime The realtime amount of the charge, i.e. the whole usage rated at the charge's
	// price for its full service period, ignoring what has already been booked to a
	// realization. This differs from the `usage` of a realization with type
	// `outstanding`, which only covers the quantity not yet booked.
	//
	// Requires the `real_time_usage` expand.
	Realtime *BillingTotals `json:"realtime,omitempty"`
}

type BillingChargeUsageBased struct {
	// AdvanceAfter The earliest time when the charge should be advanced again by background
	// processing.
	AdvanceAfter *DateTime `json:"advance_after,omitempty"`

	// BillingPeriod The billing period the charge belongs to.
	BillingPeriod ClosedPeriod `json:"billing_period"`

	// Commitments Spend commitments for the charge.
	Commitments *BillingSpendCommitments `json:"commitments,omitempty"`

	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// Currency The currency of the charge.
	Currency BillingCurrencyCode `json:"currency"`

	// Customer The customer owning the charge.
	//
	// By default, only the `id` of the customer is returned. For more details use the
	// `customer` expand.
	Customer CustomerOrReference `json:"customer"`

	// DeletedAt An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`

	// Discounts Discounts applied to the usage-based charge.
	Discounts *BillingRateCardDiscounts `json:"discounts,omitempty"`

	// Feature The feature associated with the charge.
	Feature FeatureOrReference `json:"feature"`

	// FullServicePeriod The full, unprorated service period of the charge.
	FullServicePeriod ClosedPeriod `json:"full_service_period"`
	Id                ULID         `json:"id"`

	// InvoiceAt The timestamp when the charge is intended to be invoiced.
	InvoiceAt DateTime `json:"invoice_at"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// LifecycleController Indicates whether the charge lifecycle is controlled by the system or manually
	// overridden by the API user.
	LifecycleController BillingLifecycleController `json:"lifecycle_controller"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// Price The price of the charge.
	//
	// `free` prices are rejected on create: a usage-based charge always carries a
	// concrete price.
	Price BillingPriceUsageBased `json:"price"`

	// Realizations The realization runs of the charge, sorted by `created_at`.
	Realizations []BillingChargeRealization `json:"realizations"`

	// ResolvedCostBasis The resolved fiat conversion rate of a custom-currency charge. Resolution
	// depends on costbasis type: dynamic is resolved when charge becomes active, all
	// other types resolved on creation.
	ResolvedCostBasis *BillingChargeResolvedCostBasis `json:"resolved_cost_basis,omitempty"`

	// ServicePeriod The effective service period covered by the charge.
	ServicePeriod ClosedPeriod `json:"service_period"`

	// SettlementMode Settlement mode of the charge.
	SettlementMode BillingSettlementMode `json:"settlement_mode"`

	// Status The lifecycle status of the charge.
	Status BillingChargeStatus `json:"status"`

	// Subscription The subscription that originated the charge, when the charge was created from a
	// subscription item.
	//
	// By default, only the `id`, `phase.id`, `phase.item.id` of the subscription is
	// returned. For more details use the `subscription` expand.
	Subscription *SubscriptionOrReference `json:"subscription,omitempty"`

	// SystemIntent Current intent from the system lifecycle controller for a charge that has an
	// active manual override. The top-level charge fields remain the effective
	// customer-facing intent.
	SystemIntent *BillingChargeUsageBasedSystemIntent `json:"system_intent,omitempty"`

	// TaxConfig Tax configuration of the charge.
	TaxConfig *BillingTaxConfig `json:"tax_config,omitempty"`

	// Totals Aggregated booked and realtime totals for the charge.
	Totals BillingChargeTotals `json:"totals"`

	// Type The type of the charge.
	Type BillingChargeUsageBasedType `json:"type"`

	// UniqueReferenceId Unique reference ID of the charge.
	UniqueReferenceId *string `json:"unique_reference_id,omitempty"`

	// UnitConfig Unit conversion configuration for the charge.
	//
	// Synthesized on read for charges created from v1 dynamic or package prices:
	// dynamic prices map to a unit price with a multiply unit config, and package
	// prices map to a unit price with a divide unit config.
	//
	// Accepted on create only when the UnitConfig feature is enabled on the
	// deployment; otherwise rejected.
	UnitConfig *BillingUnitConfig `json:"unit_config,omitempty"`

	// UpdatedAt An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt DateTime `json:"updated_at"`

	// Usage The metered usage quantity of the charge for its full service period.
	//
	// Requires the `real_time_usage` expand, since it is computed live from the
	// metering store rather than stored on the charge.
	Usage *Numeric `json:"usage,omitempty"`

	// ValidationIssues Validation issues found while processing the charge.
	//
	// Present only when there are one or more validation findings. An empty list is
	// omitted.
	ValidationIssues *[]BillingValidationIssue `json:"validation_issues,omitempty"`
}

type BillingChargeUsageBasedSystemIntent struct {
	// BillingPeriod The billing period the charge belongs to.
	BillingPeriod ClosedPeriod `json:"billing_period"`

	// Commitments Spend commitments for the charge.
	Commitments *BillingSpendCommitments `json:"commitments,omitempty"`

	// DeletedAt The timestamp when the system lifecycle controller intent was deleted. The
	// effective charge can remain visible while a manual override is active.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`

	// Discounts Discounts applied to the usage-based charge.
	Discounts *BillingRateCardDiscounts `json:"discounts,omitempty"`

	// FullServicePeriod The full, unprorated service period of the charge.
	FullServicePeriod ClosedPeriod `json:"full_service_period"`

	// InvoiceAt The timestamp when the charge is intended to be invoiced.
	InvoiceAt DateTime `json:"invoice_at"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// Price The price of the charge.
	//
	// `free` prices are rejected on create: a usage-based charge always carries a
	// concrete price.
	Price BillingPriceUsageBased `json:"price"`

	// ServicePeriod The effective service period covered by the charge.
	ServicePeriod ClosedPeriod `json:"service_period"`

	// UnitConfig Unit conversion configuration for the charge.
	//
	// Synthesized on read for charges created from v1 dynamic or package prices:
	// dynamic prices map to a unit price with a multiply unit config, and package
	// prices map to a unit price with a divide unit config.
	//
	// Accepted on create only when the UnitConfig feature is enabled on the
	// deployment; otherwise rejected.
	UnitConfig *BillingUnitConfig `json:"unit_config,omitempty"`
}

type BillingChargeUsageBasedType string

type BillingChargesExpand string

type BillingCostBasis struct {
	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// EffectiveFrom An ISO-8601 timestamp representation of the date from which the cost basis is
	// effective. If not provided, it will be effective immediately and will be set to
	// `now` by the system.
	EffectiveFrom *DateTime `json:"effective_from,omitempty"`

	// EffectiveTo An ISO-8601 timestamp representation of the date until which the cost basis is
	// effective. If provided, it must be later than `effective_from`. If not provided,
	// it remains effective until superseded.
	EffectiveTo *DateTime `json:"effective_to,omitempty"`

	// FiatCode The fiat currency code for the cost basis.
	FiatCode CurrencyCode `json:"fiat_code"`
	Id       ULID         `json:"id"`

	// Rate The cost rate for the currency.
	Rate Numeric `json:"rate"`
}

type BillingCreditAdjustment struct {
	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`
}

type BillingCreditAvailabilityPolicy string

type BillingCreditBalances struct {
	// Balances The balances by currencies.
	Balances []CreditBalance `json:"balances"`

	// RetrievedAt The timestamp of the balance retrieval.
	RetrievedAt DateTime `json:"retrieved_at"`
}

type BillingCreditFundingMethod string

type BillingCreditGrant struct {
	// Amount Granted credit amount.
	Amount Numeric `json:"amount"`

	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// Currency The fiat or custom currency of the granted credits.
	//
	// Funded custom-currency grants must define `purchase.cost_basis` to settle in a
	// fiat currency.
	Currency BillingCurrencyCode `json:"currency"`

	// DeletedAt An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`

	// EffectiveAt The timestamp when the credit grant becomes effective.
	//
	// Defaults to the current date and time.
	EffectiveAt *DateTime `json:"effective_at,omitempty"`

	// ExpiresAt The timestamp when the credit grant expires.
	//
	// Calculated from the grant effective time and `expires_after` if provided.
	ExpiresAt *DateTime `json:"expires_at,omitempty"`

	// Filters Filters for the credit grant.
	Filters *BillingCreditGrantFilters `json:"filters,omitempty"`

	// FundingMethod Funding method of the grant.
	FundingMethod BillingCreditFundingMethod `json:"funding_method"`
	Id            ULID                       `json:"id"`

	// Invoice Available when `funding_method` is `invoice`.
	Invoice *BillingCreditGrantInvoiceReference `json:"invoice,omitempty"`

	// Key Idempotency key for the credit grant creation request.
	//
	// Unique per customer: reusing the same key for the same customer returns an HTTP
	// 409 Conflict instead of creating a duplicate grant, which makes create requests
	// safe to retry. The same key may be reused across different customers.
	Key *ExternalResourceKey `json:"key,omitempty"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// Priority Draw-down priority of the grant. Lower values have higher priority.
	Priority *int16 `json:"priority,omitempty"`

	// Purchase Present when a funding workflow applies (funding_method is not `none`).
	Purchase *BillingCreditGrantPurchase `json:"purchase,omitempty"`

	// Status Current lifecycle status of the grant.
	Status BillingCreditGrantStatus `json:"status"`

	// TaxConfig Tax configuration for the grant.
	//
	// For `invoice` and `external` funding methods, tax configuration should be
	// provided to ensure correct revenue recognition. When not provided, the default
	// credit grant tax code is applied, if that's not set the global default taxcode
	// is used.
	TaxConfig *TaxCodeConfig `json:"tax_config,omitempty"`

	// UpdatedAt An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt DateTime `json:"updated_at"`

	// ValidationIssues Validation issues found while processing the credit grant.
	//
	// Present only when there are one or more validation findings. An empty list is
	// omitted.
	ValidationIssues *[]BillingValidationIssue `json:"validation_issues,omitempty"`

	// VoidedAt Timestamp when the grant was voided.
	VoidedAt *DateTime `json:"voided_at,omitempty"`
}

type BillingCreditGrantFilters struct {
	// Features Limit the credit grant to specific features. If no features are specified, the
	// credit grant can be used for any feature.
	Features *[]ResourceKey `json:"features,omitempty"`

	// Plans Limit credits to charges from these plans. Entries are alternatives; when
	// features are also specified, both dimensions must match. Omission or an empty
	// list leaves plans unrestricted.
	Plans *[]BillingCreditGrantPlanFilter `json:"plans,omitempty"`
}

type BillingCreditGrantInvoiceReference struct {
	// Id Identifier of the invoice associated with the grant.
	Id *ULID `json:"id,omitempty"`

	// Line Identifier of the invoice line associated with the grant.
	Line *struct {
		// Id ULID (Universally Unique Lexicographically Sortable Identifier).
		Id ULID `json:"id"`
	} `json:"line,omitempty"`
}

type BillingCreditGrantPlanFilter struct {
	// Key The plan key in the customer's namespace.
	Key ResourceKey `json:"key"`

	// Version Omission matches all versions, including future versions.
	Version *VersionFilter `json:"version,omitempty"`
}

type BillingCreditGrantPurchase struct {
	// Amount The purchase amount, calculated from the resolved cost basis and credit
	// `amount`. Present once the cost basis is resolved.
	Amount *Numeric `json:"amount,omitempty"`

	// AvailabilityPolicy Controls when credits become available for consumption.
	//
	// Defaults to `on_creation`.
	AvailabilityPolicy *BillingCreditAvailabilityPolicy `json:"availability_policy,omitempty"`

	// Currency Fiat currency the purchase is settled in.
	//
	// Must equal the grant `currency` for fiat grants and `cost_basis.fiat_currency`
	// for custom-currency grants.
	Currency CurrencyCode `json:"currency"`

	// PerUnitCostBasis Fiat cost basis per credit unit of a fiat-currency grant.
	//
	// If `per_unit_cost_basis` is 0.50 and credit amount is
	// $100.00, the total
	// charge is $50.00. The value must be greater than 0. If the
	// cost basis is 0, use `funding_method=none` instead.
	//
	// Only applies to fiat grants and cannot be combined with `cost_basis`. Defaults
	// to 1.0 when neither is provided.
	// Deprecated: this property has been marked as deprecated upstream, but no `x-deprecated-reason` was set
	PerUnitCostBasis *Numeric `json:"per_unit_cost_basis,omitempty"`

	// ResolvedCostBasis The rate the purchase is settled at in the purchase `currency`. Present once the
	// cost basis is resolved.
	ResolvedCostBasis *BillingChargeResolvedCostBasis `json:"resolved_cost_basis,omitempty"`

	// SettlementStatus Current payment settlement status.
	SettlementStatus *BillingCreditPurchasePaymentSettlementStatus `json:"settlement_status,omitempty"`
}

type BillingCreditGrantStatus string

type BillingCreditGrantVoidPaymentAdjustment string

type BillingCreditPurchasePaymentSettlementStatus string

type BillingCreditTransaction struct {
	// Amount Signed amount of the credit movement. Positive values add balance, negative
	// values reduce balance.
	Amount Numeric `json:"amount"`

	// AvailableBalance The available balance before and after the transaction.
	AvailableBalance struct {
		// After Numeric represents an arbitrary precision number.
		After Numeric `json:"after"`

		// Before Numeric represents an arbitrary precision number.
		Before Numeric `json:"before"`
	} `json:"available_balance"`

	// BookedAt The date and time the transaction was booked.
	BookedAt DateTime `json:"booked_at"`

	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// Currency Currency of the balance affected by the transaction.
	Currency BillingCurrencyCode `json:"currency"`

	// CustomCurrency Managed currency reference. Present only for custom currencies.
	CustomCurrency *CurrencyCustomReference `json:"custom_currency,omitempty"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`
	Id          ULID    `json:"id"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// Type The type of credit transaction.
	Type BillingCreditTransactionType `json:"type"`
}

type BillingCreditTransactionType string

type BillingCurrency struct {
	// contains filtered or unexported fields
}

type BillingCurrencyAmount struct {
	// Amount The amount as an arbitrary-precision decimal string.
	Amount Numeric `json:"amount"`

	// Currency The fiat or custom currency code of the amount.
	Currency BillingCurrencyCode `json:"currency"`
}

type BillingCurrencyCode = string

type BillingCurrencyCodeCustom = string

type BillingCurrencyCustom struct {
	// Code Custom currency code. It should be a unique code but not conflicting with any
	// existing fiat currency codes.
	Code BillingCurrencyCodeCustom `json:"code"`

	// CostBasis The list of active and scheduled cost bases for the custom currency. Expired and
	// deleted cost bases are excluded.
	CostBasis *[]BillingCostBasis `json:"cost_basis,omitempty"`

	// CreatedAt An ISO-8601 timestamp representation of the custom currency creation date.
	CreatedAt DateTime `json:"created_at"`

	// DecimalMark The decimal mark for the currency. It should be a string that represents the
	// decimal mark of the currency, such as "." for US Dollar or "," for Euro.
	DecimalMark string `json:"decimal_mark"`
	Id          ULID   `json:"id"`

	// Name The name of the currency. It should be a human-readable string that represents
	// the name of the currency, such as "US Dollar" or "Euro".
	Name string `json:"name"`

	// Precision The precision of the currency. It should be a number that represents the number
	// of decimal places used for the currency, such as 2 for US Dollar or Euro.
	Precision uint32 `json:"precision"`

	// Symbol The symbol of the currency. It should be a string that represents the symbol of
	// the currency, such as "$" for US Dollar or "€" for Euro.
	Symbol *string `json:"symbol,omitempty"`

	// ThousandSeparator The thousand separator for the currency. It should be a string that represents
	// the thousand separator of the currency, such as "," for US Dollar or "." for
	// Euro.
	ThousandSeparator string `json:"thousand_separator"`

	// Type The type of the currency.
	Type BillingCurrencyCustomType `json:"type"`
}

type BillingCurrencyCustomType string

type BillingCurrencyExpand string

type BillingCurrencyFiat struct {
	Code CurrencyCode `json:"code"`

	// DecimalMark The decimal mark for the currency. It should be a string that represents the
	// decimal mark of the currency, such as "." for US Dollar or "," for Euro.
	DecimalMark string `json:"decimal_mark"`

	// Name The name of the currency. It should be a human-readable string that represents
	// the name of the currency, such as "US Dollar" or "Euro".
	Name string `json:"name"`

	// Precision The precision of the currency. It should be a number that represents the number
	// of decimal places used for the currency, such as 2 for US Dollar or Euro.
	Precision uint32 `json:"precision"`

	// Symbol The symbol of the currency. It should be a string that represents the symbol of
	// the currency, such as "$" for US Dollar or "€" for Euro.
	Symbol *string `json:"symbol,omitempty"`

	// ThousandSeparator The thousand separator for the currency. It should be a string that represents
	// the thousand separator of the currency, such as "," for US Dollar or "." for
	// Euro.
	ThousandSeparator string `json:"thousand_separator"`

	// Type The type of the currency.
	Type BillingCurrencyFiatType `json:"type"`
}

type BillingCurrencyFiatType string

type BillingCurrencyType string

type BillingCustomer struct {
	// BillingAddress The billing address of the customer. Used for tax and invoicing.
	BillingAddress *Address `json:"billing_address,omitempty"`

	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// Currency Currency of the customer. Used for billing, tax and invoicing.
	Currency *CurrencyCode `json:"currency,omitempty"`

	// DeletedAt An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`
	Id          ULID    `json:"id"`

	// Key ExternalResourceKey is a unique string that is used to identify a resource in an
	// external system.
	Key ExternalResourceKey `json:"key"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// PrimaryEmail The primary email address of the customer.
	PrimaryEmail *string `json:"primary_email,omitempty"`

	// UpdatedAt An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt DateTime `json:"updated_at"`

	// UsageAttribution Mapping to attribute metered usage to the customer by the event subject.
	UsageAttribution *BillingCustomerUsageAttribution `json:"usage_attribution,omitempty"`
}

type BillingCustomerData struct {
	// AppData App customer data.
	AppData *BillingAppCustomerData `json:"app_data,omitempty"`

	// BillingProfile The billing profile for the customer.
	//
	// If not provided, the default billing profile will be used.
	BillingProfile *BillingProfileReference `json:"billing_profile,omitempty"`
}

type BillingCustomerStripeCreateCheckoutSessionRequest struct {
	// StripeOptions Options for configuring the Stripe Checkout Session.
	//
	// These options are passed directly to Stripe's
	// [checkout session creation API](https://docs.stripe.com/api/checkout/sessions/create).
	StripeOptions BillingAppStripeCreateCheckoutSessionRequestOptions `json:"stripe_options"`
}

type BillingCustomerStripeCreateCustomerPortalSessionRequest struct {
	// StripeOptions Options for configuring the Stripe Customer Portal Session.
	StripeOptions BillingAppStripeCreateCustomerPortalSessionOptions `json:"stripe_options"`
}

type BillingCustomerUsageAttribution struct {
	// SubjectKeys The subjects that are attributed to the customer. Can be empty when no usage
	// event subjects are associated with the customer.
	SubjectKeys []UsageAttributionSubjectKey `json:"subject_keys"`
}

type BillingEntitlement struct {
	// contains filtered or unexported fields
}