billing

type BillingServiceClient interface {
	// ListPricingPlans returns a paginated list of currently active pricing plans.
	ListPricingPlans(ctx context.Context, in *ListPricingPlansRequest, opts ...grpc.CallOption) (*ListPricingPlansResponse, error)
	// GetPlanByCode returns a single pricing plan by its plan type code.
	GetPlanByCode(ctx context.Context, in *GetPlanByCodeRequest, opts ...grpc.CallOption) (*GetPlanByCodeResponse, error)
	// ProcessWebhookEvent verifies and processes an incoming Stripe webhook event.
	ProcessWebhookEvent(ctx context.Context, in *ProcessWebhookEventRequest, opts ...grpc.CallOption) (*ProcessWebhookEventResponse, error)
	// CreateCustomer creates a Stripe customer for a registration session.
	CreateCustomer(ctx context.Context, in *CreateCustomerRequest, opts ...grpc.CallOption) (*CreateCustomerResponse, error)
	// GetAccountUsage returns current resource usage for an account with plan
	// limits and subscription info.
	GetAccountUsage(ctx context.Context, in *GetAccountUsageRequest, opts ...grpc.CallOption) (*GetAccountUsageResponse, error)
	// CreateBillingPortalSession creates a Stripe billing portal session for
	// managing subscriptions.
	CreateBillingPortalSession(ctx context.Context, in *CreateBillingPortalSessionRequest, opts ...grpc.CallOption) (*CreateBillingPortalSessionResponse, error)
	// PreviewPlanChange returns a cost preview for switching to a different plan
	// using the billing intent reserve+void pattern.
	PreviewPlanChange(ctx context.Context, in *PreviewPlanChangeRequest, opts ...grpc.CallOption) (*PreviewPlanChangeResponse, error)
	// RequestEnterpriseUpgrade sends an enterprise plan inquiry to the sales
	// team on behalf of the requesting admin.
	RequestEnterpriseUpgrade(ctx context.Context, in *RequestEnterpriseUpgradeRequest, opts ...grpc.CallOption) (*RequestEnterpriseUpgradeResponse, error)
	// EnsureBillingCustomer links or fetches a Stripe customer for an account.
	// If the account already has a Stripe customer ID it is returned; otherwise
	// a new Stripe customer is created and linked.
	EnsureBillingCustomer(ctx context.Context, in *EnsureBillingCustomerRequest, opts ...grpc.CallOption) (*EnsureBillingCustomerResponse, error)
	// GetAgentSpend returns the marked-up token spend an account has accrued in
	// the current billing period, as it will be billed in Stripe. Used by
	// agent-service to enforce the spending cap against the same figure the
	// dashboard displays.
	GetAgentSpend(ctx context.Context, in *GetAgentSpendRequest, opts ...grpc.CallOption) (*GetAgentSpendResponse, error)
	// SwitchPlan initiates a plan switch using v2 billing intents.
	SwitchPlan(ctx context.Context, in *SwitchPlanRequest, opts ...grpc.CallOption) (*SwitchPlanResponse, error)
	// SetupBillingProfile creates a billing profile and cadence for an account.
	SetupBillingProfile(ctx context.Context, in *SetupBillingProfileRequest, opts ...grpc.CallOption) (*SetupBillingProfileResponse, error)
	// SubscribeToPricingPlan creates a v2 pricing plan subscription for an account.
	SubscribeToPricingPlan(ctx context.Context, in *SubscribeToPricingPlanRequest, opts ...grpc.CallOption) (*SubscribeToPricingPlanResponse, error)
	// CreateSetupIntent creates a Stripe Setup Intent for collecting a payment
	// method during registration.
	CreateSetupIntent(ctx context.Context, in *CreateSetupIntentRequest, opts ...grpc.CallOption) (*CreateSetupIntentResponse, error)
	// GetSetupIntentStatus returns the current status of a Stripe Setup Intent.
	GetSetupIntentStatus(ctx context.Context, in *GetSetupIntentStatusRequest, opts ...grpc.CallOption) (*GetSetupIntentStatusResponse, error)
	// ValidateStripePricingPlan checks whether the Stripe pricing plan for a
	// given plan code is accessible before account creation.
	ValidateStripePricingPlan(ctx context.Context, in *ValidateStripePricingPlanRequest, opts ...grpc.CallOption) (*ValidateStripePricingPlanResponse, error)
}

type BillingServiceServer interface {
	// ListPricingPlans returns a paginated list of currently active pricing plans.
	ListPricingPlans(context.Context, *ListPricingPlansRequest) (*ListPricingPlansResponse, error)
	// GetPlanByCode returns a single pricing plan by its plan type code.
	GetPlanByCode(context.Context, *GetPlanByCodeRequest) (*GetPlanByCodeResponse, error)
	// ProcessWebhookEvent verifies and processes an incoming Stripe webhook event.
	ProcessWebhookEvent(context.Context, *ProcessWebhookEventRequest) (*ProcessWebhookEventResponse, error)
	// CreateCustomer creates a Stripe customer for a registration session.
	CreateCustomer(context.Context, *CreateCustomerRequest) (*CreateCustomerResponse, error)
	// GetAccountUsage returns current resource usage for an account with plan
	// limits and subscription info.
	GetAccountUsage(context.Context, *GetAccountUsageRequest) (*GetAccountUsageResponse, error)
	// CreateBillingPortalSession creates a Stripe billing portal session for
	// managing subscriptions.
	CreateBillingPortalSession(context.Context, *CreateBillingPortalSessionRequest) (*CreateBillingPortalSessionResponse, error)
	// PreviewPlanChange returns a cost preview for switching to a different plan
	// using the billing intent reserve+void pattern.
	PreviewPlanChange(context.Context, *PreviewPlanChangeRequest) (*PreviewPlanChangeResponse, error)
	// RequestEnterpriseUpgrade sends an enterprise plan inquiry to the sales
	// team on behalf of the requesting admin.
	RequestEnterpriseUpgrade(context.Context, *RequestEnterpriseUpgradeRequest) (*RequestEnterpriseUpgradeResponse, error)
	// EnsureBillingCustomer links or fetches a Stripe customer for an account.
	// If the account already has a Stripe customer ID it is returned; otherwise
	// a new Stripe customer is created and linked.
	EnsureBillingCustomer(context.Context, *EnsureBillingCustomerRequest) (*EnsureBillingCustomerResponse, error)
	// GetAgentSpend returns the marked-up token spend an account has accrued in
	// the current billing period, as it will be billed in Stripe. Used by
	// agent-service to enforce the spending cap against the same figure the
	// dashboard displays.
	GetAgentSpend(context.Context, *GetAgentSpendRequest) (*GetAgentSpendResponse, error)
	// SwitchPlan initiates a plan switch using v2 billing intents.
	SwitchPlan(context.Context, *SwitchPlanRequest) (*SwitchPlanResponse, error)
	// SetupBillingProfile creates a billing profile and cadence for an account.
	SetupBillingProfile(context.Context, *SetupBillingProfileRequest) (*SetupBillingProfileResponse, error)
	// SubscribeToPricingPlan creates a v2 pricing plan subscription for an account.
	SubscribeToPricingPlan(context.Context, *SubscribeToPricingPlanRequest) (*SubscribeToPricingPlanResponse, error)
	// CreateSetupIntent creates a Stripe Setup Intent for collecting a payment
	// method during registration.
	CreateSetupIntent(context.Context, *CreateSetupIntentRequest) (*CreateSetupIntentResponse, error)
	// GetSetupIntentStatus returns the current status of a Stripe Setup Intent.
	GetSetupIntentStatus(context.Context, *GetSetupIntentStatusRequest) (*GetSetupIntentStatusResponse, error)
	// ValidateStripePricingPlan checks whether the Stripe pricing plan for a
	// given plan code is accessible before account creation.
	ValidateStripePricingPlan(context.Context, *ValidateStripePricingPlanRequest) (*ValidateStripePricingPlanResponse, error)
	// contains filtered or unexported methods
}

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

type CreateBillingPortalSessionResponse struct {
	Url string `protobuf:"bytes,1,opt,name=url,proto3" json:"url,omitempty"`
	// contains filtered or unexported fields
}

type CreateCustomerRequest struct {
	Email          string            `protobuf:"bytes,1,opt,name=email,proto3" json:"email,omitempty"`
	Name           string            `protobuf:"bytes,2,opt,name=name,proto3" json:"name,omitempty"`
	IdempotencyKey string            `protobuf:"bytes,3,opt,name=idempotency_key,json=idempotencyKey,proto3" json:"idempotency_key,omitempty"`
	Metadata       map[string]string `` /* 143-byte string literal not displayed */
	// contains filtered or unexported fields
}

type CreateCustomerResponse struct {
	CustomerId string `protobuf:"bytes,1,opt,name=customer_id,json=customerId,proto3" json:"customer_id,omitempty"`
	// contains filtered or unexported fields
}

type CreateSetupIntentRequest struct {
	CustomerId     string `protobuf:"bytes,1,opt,name=customer_id,json=customerId,proto3" json:"customer_id,omitempty"`
	IdempotencyKey string `protobuf:"bytes,2,opt,name=idempotency_key,json=idempotencyKey,proto3" json:"idempotency_key,omitempty"`
	// contains filtered or unexported fields
}

type CreateSetupIntentResponse struct {
	SetupIntentId  string `protobuf:"bytes,1,opt,name=setup_intent_id,json=setupIntentId,proto3" json:"setup_intent_id,omitempty"`
	ClientSecret   string `protobuf:"bytes,2,opt,name=client_secret,json=clientSecret,proto3" json:"client_secret,omitempty"`
	PublishableKey string `protobuf:"bytes,3,opt,name=publishable_key,json=publishableKey,proto3" json:"publishable_key,omitempty"`
	// contains filtered or unexported fields
}

type EnsureBillingCustomerRequest struct {
	AccountId *string `protobuf:"bytes,1,opt,name=account_id,json=accountId,proto3,oneof" json:"account_id,omitempty"`
	// contains filtered or unexported fields
}

type EnsureBillingCustomerResponse struct {
	StripeCustomerId string `protobuf:"bytes,1,opt,name=stripe_customer_id,json=stripeCustomerId,proto3" json:"stripe_customer_id,omitempty"`
	Created          bool   `protobuf:"varint,2,opt,name=created,proto3" json:"created,omitempty"`
	// The billing profile ID, present if a billing profile was created or already exists.
	BillingProfileId *string `protobuf:"bytes,3,opt,name=billing_profile_id,json=billingProfileId,proto3,oneof" json:"billing_profile_id,omitempty"`
	// contains filtered or unexported fields
}

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

type GetAccountUsageResponse struct {
	Seats                    *UsageItem        `protobuf:"bytes,1,opt,name=seats,proto3" json:"seats,omitempty"`
	Invoices                 *UsageItem        `protobuf:"bytes,2,opt,name=invoices,proto3" json:"invoices,omitempty"`
	Batches                  *UsageItem        `protobuf:"bytes,3,opt,name=batches,proto3" json:"batches,omitempty"`
	Sandboxes                *UsageItem        `protobuf:"bytes,4,opt,name=sandboxes,proto3" json:"sandboxes,omitempty"`
	Subscription             *SubscriptionInfo `protobuf:"bytes,5,opt,name=subscription,proto3,oneof" json:"subscription,omitempty"`
	AgentTokens              *UsageItem        `protobuf:"bytes,6,opt,name=agent_tokens,json=agentTokens,proto3" json:"agent_tokens,omitempty"`
	EstimatedAgentSpendCents int64             `` /* 138-byte string literal not displayed */
	// Plan display name resolved live from Stripe (e.g. the pricing plan's display_name). Empty when the account has no Stripe pricing plan.
	PlanName string `protobuf:"bytes,9,opt,name=plan_name,json=planName,proto3" json:"plan_name,omitempty"`
	// Flat base fee in cents charged per base_fee_interval, resolved from the pricing plan's license fee component. 0 when the plan has no base fee (e.g. per-seat pricing).
	BaseFeeCents int64 `protobuf:"varint,10,opt,name=base_fee_cents,json=baseFeeCents,proto3" json:"base_fee_cents,omitempty"`
	// Billing interval the base fee is charged on (e.g. "month", "year"). Empty when there is no base fee.
	BaseFeeInterval string `protobuf:"bytes,11,opt,name=base_fee_interval,json=baseFeeInterval,proto3" json:"base_fee_interval,omitempty"`
	// contains filtered or unexported fields
}

type GetAgentSpendRequest struct {
	AccountId *string `protobuf:"bytes,1,opt,name=account_id,json=accountId,proto3,oneof" json:"account_id,omitempty"`
	// contains filtered or unexported fields
}

type GetAgentSpendResponse struct {
	EstimatedSpendCents int64 `protobuf:"varint,1,opt,name=estimated_spend_cents,json=estimatedSpendCents,proto3" json:"estimated_spend_cents,omitempty"`
	// Marked-up per-token rates from the account's plan rate card. Empty when the plan has no rate card. Lets the caller price in-flight usage against the cap without a per-turn round trip.
	TokenRates []*TokenRate `protobuf:"bytes,2,rep,name=token_rates,json=tokenRates,proto3" json:"token_rates,omitempty"`
	// contains filtered or unexported fields
}

type GetPlanByCodeRequest struct {
	PlanCode string `protobuf:"bytes,1,opt,name=plan_code,json=planCode,proto3" json:"plan_code,omitempty"`
	// contains filtered or unexported fields
}

type GetPlanByCodeResponse struct {
	Plan *PricingPlan `protobuf:"bytes,1,opt,name=plan,proto3" json:"plan,omitempty"`
	// contains filtered or unexported fields
}

type GetSetupIntentStatusRequest struct {
	SetupIntentId string `protobuf:"bytes,1,opt,name=setup_intent_id,json=setupIntentId,proto3" json:"setup_intent_id,omitempty"`
	// contains filtered or unexported fields
}

type GetSetupIntentStatusResponse struct {
	Status          string  `protobuf:"bytes,1,opt,name=status,proto3" json:"status,omitempty"`
	PaymentMethodId *string `protobuf:"bytes,2,opt,name=payment_method_id,json=paymentMethodId,proto3,oneof" json:"payment_method_id,omitempty"`
	// contains filtered or unexported fields
}

type ListPricingPlansRequest struct {
	Cursor *string `protobuf:"bytes,1,opt,name=cursor,proto3,oneof" json:"cursor,omitempty"`
	Limit  int32   `protobuf:"varint,2,opt,name=limit,proto3" json:"limit,omitempty"`
	Query  *string `protobuf:"bytes,3,opt,name=query,proto3,oneof" json:"query,omitempty"`
	// contains filtered or unexported fields
}

type ListPricingPlansResponse struct {
	Plans    []*PricingPlan `protobuf:"bytes,1,rep,name=plans,proto3" json:"plans,omitempty"`
	PageInfo *PageInfo      `protobuf:"bytes,2,opt,name=page_info,json=pageInfo,proto3" json:"page_info,omitempty"`
	// contains filtered or unexported fields
}

type PageInfo struct {
	NextCursor  *string `protobuf:"bytes,1,opt,name=next_cursor,json=nextCursor,proto3,oneof" json:"next_cursor,omitempty"`
	PrevCursor  *string `protobuf:"bytes,2,opt,name=prev_cursor,json=prevCursor,proto3,oneof" json:"prev_cursor,omitempty"`
	HasNextPage bool    `protobuf:"varint,3,opt,name=has_next_page,json=hasNextPage,proto3" json:"has_next_page,omitempty"`
	HasPrevPage bool    `protobuf:"varint,4,opt,name=has_prev_page,json=hasPrevPage,proto3" json:"has_prev_page,omitempty"`
	// contains filtered or unexported fields
}

type PlanChangePreview struct {
	NetAmount                  int64                        `protobuf:"varint,1,opt,name=net_amount,json=netAmount,proto3" json:"net_amount,omitempty"`
	FormattedNetAmount         string                       `protobuf:"bytes,2,opt,name=formatted_net_amount,json=formattedNetAmount,proto3" json:"formatted_net_amount,omitempty"`
	MonthlyBillAmount          int64                        `protobuf:"varint,3,opt,name=monthly_bill_amount,json=monthlyBillAmount,proto3" json:"monthly_bill_amount,omitempty"`
	FormattedMonthlyBillAmount string                       `` /* 143-byte string literal not displayed */
	LineItems                  []*PlanChangePreviewLineItem `protobuf:"bytes,5,rep,name=line_items,json=lineItems,proto3" json:"line_items,omitempty"`
	// True when the preview is a local estimate rather than a Stripe billing intent calculation.
	IsEstimate bool `protobuf:"varint,6,opt,name=is_estimate,json=isEstimate,proto3" json:"is_estimate,omitempty"`
	// contains filtered or unexported fields
}

type PlanChangePreviewLineItem struct {
	Description string `protobuf:"bytes,1,opt,name=description,proto3" json:"description,omitempty"`
	Amount      int64  `protobuf:"varint,2,opt,name=amount,proto3" json:"amount,omitempty"`
	// contains filtered or unexported fields
}

type PlanLimit struct {
	Key   string `protobuf:"bytes,1,opt,name=key,proto3" json:"key,omitempty"`
	Value *int32 `protobuf:"varint,2,opt,name=value,proto3,oneof" json:"value,omitempty"`
	// contains filtered or unexported fields
}

type PreviewPlanChangeRequest struct {
	PlanId string `protobuf:"bytes,1,opt,name=plan_id,json=planId,proto3" json:"plan_id,omitempty"`
	// contains filtered or unexported fields
}

type PreviewPlanChangeResponse struct {
	Preview *PlanChangePreview `protobuf:"bytes,1,opt,name=preview,proto3" json:"preview,omitempty"`
	// contains filtered or unexported fields
}

type PricingPlan struct {
	Id                   string       `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
	Name                 string       `protobuf:"bytes,2,opt,name=name,proto3" json:"name,omitempty"`
	PlanTypeCode         string       `protobuf:"bytes,3,opt,name=plan_type_code,json=planTypeCode,proto3" json:"plan_type_code,omitempty"`
	PricePerSeat         float64      `protobuf:"fixed64,4,opt,name=price_per_seat,json=pricePerSeat,proto3" json:"price_per_seat,omitempty"`
	PricePerMonth        *float64     `protobuf:"fixed64,5,opt,name=price_per_month,json=pricePerMonth,proto3,oneof" json:"price_per_month,omitempty"`
	SeatMinimum          *int32       `protobuf:"varint,6,opt,name=seat_minimum,json=seatMinimum,proto3,oneof" json:"seat_minimum,omitempty"`
	Limits               []*PlanLimit `protobuf:"bytes,7,rep,name=limits,proto3" json:"limits,omitempty"`
	DisplayFeatures      []string     `protobuf:"bytes,8,rep,name=display_features,json=displayFeatures,proto3" json:"display_features,omitempty"`
	DisplayOrder         int32        `protobuf:"varint,9,opt,name=display_order,json=displayOrder,proto3" json:"display_order,omitempty"`
	IsHighlighted        bool         `protobuf:"varint,10,opt,name=is_highlighted,json=isHighlighted,proto3" json:"is_highlighted,omitempty"`
	ButtonText           string       `protobuf:"bytes,11,opt,name=button_text,json=buttonText,proto3" json:"button_text,omitempty"`
	IncludesPreviousPlan *string      `` /* 130-byte string literal not displayed */
	// contains filtered or unexported fields
}

type ProcessWebhookEventRequest struct {
	RawPayload      []byte `protobuf:"bytes,1,opt,name=raw_payload,json=rawPayload,proto3" json:"raw_payload,omitempty"`
	StripeSignature string `protobuf:"bytes,2,opt,name=stripe_signature,json=stripeSignature,proto3" json:"stripe_signature,omitempty"`
	// contains filtered or unexported fields
}

type ProcessWebhookEventResponse struct {
	Success     bool `protobuf:"varint,1,opt,name=success,proto3" json:"success,omitempty"`
	IsDuplicate bool `protobuf:"varint,2,opt,name=is_duplicate,json=isDuplicate,proto3" json:"is_duplicate,omitempty"`
	// contains filtered or unexported fields
}

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

type RequestEnterpriseUpgradeResponse struct {
	Success bool `protobuf:"varint,1,opt,name=success,proto3" json:"success,omitempty"`
	// contains filtered or unexported fields
}

type SetupBillingProfileRequest struct {
	AccountId *string `protobuf:"bytes,1,opt,name=account_id,json=accountId,proto3,oneof" json:"account_id,omitempty"`
	// contains filtered or unexported fields
}

type SetupBillingProfileResponse struct {
	BillingProfileId string `protobuf:"bytes,1,opt,name=billing_profile_id,json=billingProfileId,proto3" json:"billing_profile_id,omitempty"`
	BillingCadenceId string `protobuf:"bytes,2,opt,name=billing_cadence_id,json=billingCadenceId,proto3" json:"billing_cadence_id,omitempty"`
	// contains filtered or unexported fields
}

type SubscribeToPricingPlanRequest struct {
	StripeCustomerId string `protobuf:"bytes,1,opt,name=stripe_customer_id,json=stripeCustomerId,proto3" json:"stripe_customer_id,omitempty"`
	PlanCode         string `protobuf:"bytes,2,opt,name=plan_code,json=planCode,proto3" json:"plan_code,omitempty"`
	// contains filtered or unexported fields
}

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

type SubscriptionInfo struct {
	ServicingStatus  string                 `protobuf:"bytes,1,opt,name=servicing_status,json=servicingStatus,proto3" json:"servicing_status,omitempty"`
	CollectionStatus string                 `protobuf:"bytes,2,opt,name=collection_status,json=collectionStatus,proto3" json:"collection_status,omitempty"`
	CurrentPeriodEnd *timestamppb.Timestamp `protobuf:"bytes,3,opt,name=current_period_end,json=currentPeriodEnd,proto3,oneof" json:"current_period_end,omitempty"`
	// contains filtered or unexported fields
}

type SwitchPlanRequest struct {
	PlanId string `protobuf:"bytes,1,opt,name=plan_id,json=planId,proto3" json:"plan_id,omitempty"`
	// contains filtered or unexported fields
}

type SwitchPlanResponse struct {
	Success  bool    `protobuf:"varint,1,opt,name=success,proto3" json:"success,omitempty"`
	IntentId *string `protobuf:"bytes,2,opt,name=intent_id,json=intentId,proto3,oneof" json:"intent_id,omitempty"`
	// contains filtered or unexported fields
}

type TokenRate struct {

	// Gateway model name the rate applies to (e.g. "anthropic/claude-sonnet-4.6").
	Model string `protobuf:"bytes,1,opt,name=model,proto3" json:"model,omitempty"`
	// Token type the rate applies to: input, output, cached_input, or cached_output.
	TokenType string `protobuf:"bytes,2,opt,name=token_type,json=tokenType,proto3" json:"token_type,omitempty"`
	// Price in cents per token, markup included.
	UnitAmountCents float64 `protobuf:"fixed64,3,opt,name=unit_amount_cents,json=unitAmountCents,proto3" json:"unit_amount_cents,omitempty"`
	// contains filtered or unexported fields
}

type UnimplementedBillingServiceServer struct{}

type UnsafeBillingServiceServer interface {
	// contains filtered or unexported methods
}

type UsageItem struct {
	Current int32  `protobuf:"varint,1,opt,name=current,proto3" json:"current,omitempty"`
	Limit   *int32 `protobuf:"varint,2,opt,name=limit,proto3,oneof" json:"limit,omitempty"`
	// contains filtered or unexported fields
}

type ValidateStripePricingPlanRequest struct {
	PlanCode string `protobuf:"bytes,1,opt,name=plan_code,json=planCode,proto3" json:"plan_code,omitempty"`
	// contains filtered or unexported fields
}

type ValidateStripePricingPlanResponse struct {
	Valid bool `protobuf:"varint,1,opt,name=valid,proto3" json:"valid,omitempty"`
	// contains filtered or unexported fields
}