acpcheckout

type APIVersion = string

type AcceptLanguage = string

type Address struct {
	// City City name
	City string `json:"city"`

	// Country ISO 3166-1 alpha-2 country code
	Country string `json:"country"`

	// LineOne Primary street address line
	LineOne string `json:"line_one"`

	// LineTwo Secondary address line (apartment, suite, etc.)
	LineTwo *string `json:"line_two,omitempty"`

	// Name Recipient name for this address
	Name string `json:"name"`

	// PostalCode Postal or ZIP code
	PostalCode string `json:"postal_code"`

	// State State or province code
	State string `json:"state"`
}

type Adjustment struct {
	// Amount Total amount credited to the buyer in minor currency units, inclusive of any applicable tax
	Amount *int `json:"amount,omitempty"`

	// Currency ISO 4217 currency code
	Currency *string `json:"currency,omitempty"`

	// Description Human-readable reason (e.g., 'Defective item')
	Description *string `json:"description,omitempty"`

	// Id Adjustment identifier
	Id string `json:"id"`

	// LineItems Which line items and quantities are affected (optional for order-level adjustments)
	LineItems *[]LineItemReference `json:"line_items,omitempty"`

	// OccurredAt RFC 3339 timestamp when this adjustment occurred
	OccurredAt time.Time `json:"occurred_at"`

	// Reason Structured reason code
	Reason *string `json:"reason,omitempty"`

	// Status Adjustment status. Implementations MUST accept unrecognized values gracefully. Defined values: 'pending', 'completed', 'failed'.
	Status string `json:"status"`

	// Type Type of adjustment. Implementations MUST accept unrecognized values gracefully. Defined values: 'refund', 'credit', 'return', 'exchange', 'price_adjustment', 'cancellation', 'dispute'. Use 'refund' for both full and partial refunds (distinguish by amount). 'credit' replaces 'store_credit'. 'dispute' covers chargebacks.
	Type string `json:"type"`
}

type AffiliateAttribution struct {
	// CampaignId Provider-scoped campaign identifier.
	CampaignId *string `json:"campaign_id,omitempty"`

	// CreativeId Provider-scoped creative identifier.
	CreativeId *string `json:"creative_id,omitempty"`

	// ExpiresAt RFC3339 timestamp when the attribution token expires.
	ExpiresAt *time.Time `json:"expires_at,omitempty"`

	// IssuedAt RFC3339 timestamp when the attribution token was issued.
	IssuedAt *time.Time `json:"issued_at,omitempty"`

	// Metadata Flat key/value map for additional non-sensitive context.
	// Keys must be strings; values must be strings, numbers, or booleans.
	// Arrays and nested objects are NOT permitted.
	Metadata *AffiliateAttributionMetadata `json:"metadata,omitempty"`

	// Provider Identifier for the attribution provider / affiliate network namespace (e.g., 'impact.com').
	Provider string `json:"provider"`

	// PublisherId Provider-scoped affiliate/publisher identifier. Required if token is omitted.
	PublisherId *string `json:"publisher_id,omitempty"`

	// Source Context about where the attribution originated.
	Source *AffiliateAttributionSource `json:"source,omitempty"`

	// SubId Provider-scoped sub-tracking identifier.
	SubId *string `json:"sub_id,omitempty"`

	// Token Opaque provider-issued token for fraud-resistant validation. Treat as secret.
	Token *string `json:"token,omitempty"`

	// Touchpoint Attribution touchpoint type. Use 'first' when capturing at session creation,
	// 'last' when capturing at completion. Enables multi-touch attribution models.
	Touchpoint *AffiliateAttributionTouchpoint `json:"touchpoint,omitempty"`
	// contains filtered or unexported fields
}

type AffiliateAttribution0 = interface{}

type AffiliateAttribution1 = interface{}

type AffiliateAttributionMetadata map[string]AffiliateAttributionMetadata_AdditionalProperties

type AffiliateAttributionMetadata0 = string

type AffiliateAttributionMetadata1 = float32

type AffiliateAttributionMetadata2 = bool

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

type AffiliateAttributionSource struct {
	// Type The type of attribution source.
	Type AffiliateAttributionSourceType `json:"type"`

	// Url Canonical content URL when type is 'url'.
	Url *string `json:"url,omitempty"`
}

type AffiliateAttributionSourceType string

type AffiliateAttributionTouchpoint string

type AppliedDiscount struct {
	// Allocations Breakdown of where this discount was allocated. Sum of allocation amounts equals total amount.
	Allocations *[]DiscountAllocation `json:"allocations,omitempty"`

	// Amount Total discount amount in minor (cents) currency units.
	Amount int `json:"amount"`

	// Automatic True if applied automatically by merchant rules (no code required).
	Automatic *bool `json:"automatic,omitempty"`

	// Code The discount code entered by the user. Omitted for automatic discounts.
	Code *string `json:"code,omitempty"`

	// Coupon Coupon details describing the discount terms.
	Coupon Coupon `json:"coupon"`

	// End RFC 3339 timestamp when the discount expires.
	End *time.Time `json:"end,omitempty"`

	// Id Unique identifier for this applied discount instance.
	Id string `json:"id"`

	// Method Allocation method. 'each' = applied independently per item. 'across' = split proportionally by value.
	Method *AppliedDiscountMethod `json:"method,omitempty"`

	// Priority Stacking order for discount calculation. Lower numbers applied first (1 = first).
	Priority *int `json:"priority,omitempty"`

	// Start RFC 3339 timestamp when the discount became active.
	Start *time.Time `json:"start,omitempty"`
}

type AppliedDiscountMethod string

type AuthenticationMetadata struct {
	// AcquirerDetails Details about the acquirer used for this 3DS Authentication. This object MUST be present.
	AcquirerDetails struct {
		// AcquirerBin The Acquirer BIN (directory-server specific).
		AcquirerBin string `json:"acquirer_bin"`

		// AcquirerCountry Two-letter ISO 3166-1 alpha-2 country code.
		AcquirerCountry string `json:"acquirer_country"`

		// AcquirerMerchantId The Merchant ID assigned by the acquirer.
		AcquirerMerchantId string `json:"acquirer_merchant_id"`

		// MerchantName Merchant name assigned by the acquirer.
		MerchantName string `json:"merchant_name"`

		// RequestorId Requestor ID (if required by the directory server).
		RequestorId *string `json:"requestor_id,omitempty"`
	} `json:"acquirer_details"`

	// DirectoryServer The 3DS directory server used for this Authentication.
	DirectoryServer AuthenticationMetadataDirectoryServer `json:"directory_server"`

	// FlowPreference Contains additional details on the seller's preference for the 3DS authentication flow. Sellers MAY request a preference, but issuers ultimately decide the actual flow.
	FlowPreference *struct {
		// Challenge Details about the requested challenge flow.
		Challenge *struct {
			// Type Subtype of challenge preference.
			Type *AuthenticationMetadataFlowPreferenceChallengeType `json:"type,omitempty"`
		} `json:"challenge,omitempty"`

		// Frictionless Details about the requested frictionless flow.
		Frictionless *struct {
			// Type Subtype of frictionless preference.
			Type *AuthenticationMetadataFlowPreferenceFrictionlessType `json:"type,omitempty"`
		} `json:"frictionless,omitempty"`

		// Type Type of flow requested for this 3DS Authentication. "challenge" requests a challenge flow; "frictionless" requests a frictionless flow.
		Type AuthenticationMetadataFlowPreferenceType `json:"type"`
	} `json:"flow_preference,omitempty"`
	AdditionalProperties map[string]interface{} `json:"-"`
}

type AuthenticationMetadataDirectoryServer string

type AuthenticationMetadataFlowPreferenceChallengeType string

type AuthenticationMetadataFlowPreferenceFrictionlessType string

type AuthenticationMetadataFlowPreferenceType string

type AuthenticationResult struct {
	// Outcome The outcome of this 3DS Authentication.
	Outcome AuthenticationResultOutcome `json:"outcome"`

	// OutcomeDetails Detailed authentication data. This field is required when the outcome is 'authenticated', 'informational', or 'attempt_acknowledged'.
	OutcomeDetails *struct {
		// ElectronicCommerceIndicator Electronic Commerce Indicator (ECI) returned by the 3D Secure provider. Indicates the degree/type of authentication performed.
		ElectronicCommerceIndicator AuthenticationResultOutcomeDetailsElectronicCommerceIndicator `json:"electronic_commerce_indicator"`

		// ThreeDsCryptogram The 3DS cryptogram (authentication value / AAV/CAVV/AEVV). This value is 20 bytes, base64-encoded into a 28-character string.
		ThreeDsCryptogram string `json:"three_ds_cryptogram"`

		// TransactionId Transaction identifier returned by the 3DS system: - For 3DS1: the XID - For 3DS2: the Directory Server Transaction ID (dsTransID)
		TransactionId string `json:"transaction_id"`

		// Version The 3D Secure version used for this authentication (for example "1.0.2" or "2.2.0").
		Version string `json:"version"`
	} `json:"outcome_details,omitempty"`
}

type AuthenticationResultOutcome string

type AuthenticationResultOutcomeDetailsElectronicCommerceIndicator string

type Authorization = string

type Buyer struct {
	// AccountType Type of buyer account
	AccountType *BuyerAccountType `json:"account_type,omitempty"`

	// AuthenticationStatus Buyer's authentication status
	AuthenticationStatus *BuyerAuthenticationStatus `json:"authentication_status,omitempty"`

	// Company Information about a company or organization associated with the buyer
	Company *CompanyInfo `json:"company,omitempty"`

	// CustomerId Merchant's internal customer identifier
	CustomerId *string `json:"customer_id,omitempty"`

	// Email Buyer's email address
	Email openapi_types.Email `json:"email"`

	// FirstName Buyer's first name
	FirstName *string `json:"first_name,omitempty"`

	// FullName Buyer's full name
	FullName *string `json:"full_name,omitempty"`

	// LastName Buyer's last name
	LastName *string `json:"last_name,omitempty"`

	// Loyalty Loyalty program information including membership details and rewards balance
	Loyalty *LoyaltyInfo `json:"loyalty,omitempty"`

	// PhoneNumber Buyer's phone number
	PhoneNumber *string `json:"phone_number,omitempty"`

	// TaxExemption Tax exemption information including exemption type and applicable regions
	TaxExemption *TaxExemption `json:"tax_exemption,omitempty"`
}

type BuyerAccountType string

type BuyerAuthenticationStatus string

type CancelCheckoutSessionJSONRequestBody = CancelSessionRequest

type CancelCheckoutSessionParams struct {
	// Authorization Bearer token for API authentication
	Authorization  Authorization   `json:"Authorization"`
	AcceptLanguage *AcceptLanguage `json:"Accept-Language,omitempty"`
	UserAgent      *UserAgent      `json:"User-Agent,omitempty"`

	// IdempotencyKey Idempotency key. MUST be present on all POST requests. Opaque string, max 255 characters. UUID v4 recommended. Scoped to authenticated identity + endpoint.
	IdempotencyKey IdempotencyKey `json:"Idempotency-Key"`
	RequestId      *RequestId     `json:"Request-Id,omitempty"`

	// Signature HMAC signature for webhook verification
	Signature *Signature `json:"Signature,omitempty"`

	// Timestamp RFC 3339 date-time string for request timing validation
	Timestamp  *Timestamp `json:"Timestamp,omitempty"`
	APIVersion APIVersion `json:"API-Version"`
}

type CancelSessionRequest struct {
	// IntentTrace Structured reason for why a buyer action was taken, used for analytics and debugging
	IntentTrace *IntentTrace `json:"intent_trace,omitempty"`
}

type Capabilities struct {
	// Extensions Extensions supported by the party.
	// Requests: array of extension identifiers.
	// Responses: array of extension declaration objects.
	Extensions *Capabilities_Extensions `json:"extensions,omitempty"`

	// Interventions Intervention capabilities.
	// Context-specific fields: display_context, redirect_context, max_redirects, max_interaction_depth (requests only).
	// required, enforcement (responses only).
	// supported field contains intersection in responses.
	Interventions *InterventionCapabilities `json:"interventions,omitempty"`

	// Payment Payment configuration with handlers
	Payment *Payment `json:"payment,omitempty"`
}

type CapabilitiesExtensions0 = []string

type CapabilitiesExtensions1 = []ExtensionDeclaration

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

type CheckoutSession = CheckoutSessionBase

type CheckoutSessionBase struct {
	// AuthenticationMetadata Seller-provided authentication metadata for 3DS flows.
	AuthenticationMetadata *AuthenticationMetadata `json:"authentication_metadata,omitempty"`

	// Buyer Information about the buyer including contact details, company info, and loyalty status
	Buyer *Buyer `json:"buyer,omitempty"`

	// Capabilities Capabilities object used in requests and responses.
	// Context determines the party: requests are from Agents, responses are from Sellers.
	// Seller responses contain the intersection of supported interventions.
	Capabilities Capabilities `json:"capabilities"`

	// ContinueUrl URL to continue or resume the checkout session
	ContinueUrl *string `json:"continue_url,omitempty"`

	// CreatedAt RFC 3339 timestamp when the session was created
	CreatedAt *time.Time `json:"created_at,omitempty"`

	// Currency ISO 4217 settlement currency code
	Currency string `json:"currency"`

	// Discounts Discount codes input and applied discounts output in checkout responses.
	Discounts *DiscountsResponse `json:"discounts,omitempty"`

	// ExchangeRate Exchange rate from presentment to settlement currency
	ExchangeRate *float32 `json:"exchange_rate,omitempty"`

	// ExchangeRateTimestamp RFC 3339 timestamp when exchange rate was determined
	ExchangeRateTimestamp *time.Time `json:"exchange_rate_timestamp,omitempty"`

	// ExpiresAt RFC 3339 timestamp when the session expires
	ExpiresAt *time.Time `json:"expires_at,omitempty"`

	// FulfillmentDetails Details about how items will be fulfilled (shipping, pickup, or delivery information)
	FulfillmentDetails *FulfillmentDetails `json:"fulfillment_details,omitempty"`

	// FulfillmentGroups Optional grouping of line items by fulfillment method
	FulfillmentGroups *[]FulfillmentGroup `json:"fulfillment_groups,omitempty"`

	// FulfillmentOptions Available fulfillment options
	FulfillmentOptions []CheckoutSessionBase_FulfillmentOptions_Item `json:"fulfillment_options"`

	// Id Unique identifier for the checkout session
	Id string `json:"id"`

	// LineItems Line items in the checkout session
	LineItems []LineItem `json:"line_items"`

	// Links Relevant links (terms, policies, support)
	Links []Link `json:"links"`

	// Locale Locale code (e.g., 'en-US') for localizing content
	Locale *string `json:"locale,omitempty"`

	// MarketingConsentOptions Marketing consent options the seller offers. When present, the agent SHOULD display these to the buyer before checkout completion. Agents MAY selectively surface a subset of options; options not surfaced MUST be omitted from marketing_consents. When absent, the agent MUST NOT surface any marketing consent UI. An empty array is equivalent to absent.
	MarketingConsentOptions *[]MarketingConsentOption `json:"marketing_consent_options,omitempty"`

	// Messages Messages to communicate with the buyer (info, warnings, errors)
	Messages []CheckoutSessionBase_Messages_Item `json:"messages"`

	// Metadata Arbitrary metadata for merchant use
	Metadata *map[string]interface{} `json:"metadata,omitempty"`

	// PresentmentCurrency ISO 4217 presentment currency code if different from settlement currency
	PresentmentCurrency *string `json:"presentment_currency,omitempty"`

	// Protocol Protocol metadata included in checkout responses. Indicates the ACP version.
	Protocol *ProtocolVersion `json:"protocol,omitempty"`

	// QuoteExpiresAt RFC 3339 timestamp when the quote expires
	QuoteExpiresAt *time.Time `json:"quote_expires_at,omitempty"`

	// QuoteId Quote identifier if this session is based on a quote
	QuoteId *string `json:"quote_id,omitempty"`

	// SelectedFulfillmentOptions Currently selected fulfillment options
	SelectedFulfillmentOptions *[]SelectedFulfillmentOption `json:"selected_fulfillment_options,omitempty"`

	// Status Current status of the checkout session
	Status CheckoutSessionBaseStatus `json:"status"`

	// Timezone IANA timezone identifier (e.g., 'America/New_York')
	Timezone *string `json:"timezone,omitempty"`

	// Totals Cart-level totals breakdown
	Totals []Total `json:"totals"`

	// UpdatedAt RFC 3339 timestamp of last update
	UpdatedAt *time.Time `json:"updated_at,omitempty"`
}

type CheckoutSessionBaseStatus string

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

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

type CheckoutSessionCompleteRequest struct {
	// AffiliateAttribution Optional affiliate attribution data for crediting third-party publishers.
	// Write-only: not returned in responses. See RFC: Affiliate Attribution.
	//
	// Forward compatibility: Servers SHOULD ignore unknown fields to support future extensions (per RFC §8.2).
	AffiliateAttribution *AffiliateAttribution `json:"affiliate_attribution,omitempty"`

	// AuthenticationResult Agent-provided authentication results returned to the seller for card-based 3D Secure.
	AuthenticationResult *AuthenticationResult `json:"authentication_result,omitempty"`

	// Buyer Information about the buyer including contact details, company info, and loyalty status
	Buyer *Buyer `json:"buyer,omitempty"`

	// MarketingConsents Buyer's marketing consent decisions. Agents SHOULD include an entry for each consent option surfaced to the buyer. Options not surfaced MUST be omitted -- omission preserves existing subscription state. Sellers SHOULD ignore entries in marketing_consents that do not correspond to a channel in marketing_consent_options.
	MarketingConsents *[]MarketingConsent `json:"marketing_consents,omitempty"`

	// PaymentData Payment instrument data collected from the buyer (e.g., card details, wallet tokens)
	PaymentData PaymentData `json:"payment_data"`

	// RiskSignals Risk and fraud detection signals for the checkout session
	RiskSignals *RiskSignals `json:"risk_signals,omitempty"`
}

type CheckoutSessionCreateRequest struct {
	// AffiliateAttribution Optional affiliate attribution data for crediting third-party publishers.
	// Write-only: not returned in responses. See RFC: Affiliate Attribution.
	//
	// Forward compatibility: Servers SHOULD ignore unknown fields to support future extensions (per RFC §8.2).
	AffiliateAttribution *AffiliateAttribution `json:"affiliate_attribution,omitempty"`

	// Buyer Information about the buyer including contact details, company info, and loyalty status
	Buyer *Buyer `json:"buyer,omitempty"`

	// Capabilities Capabilities object used in requests and responses.
	// Context determines the party: requests are from Agents, responses are from Sellers.
	// Seller responses contain the intersection of supported interventions.
	Capabilities Capabilities `json:"capabilities"`

	// Coupons DEPRECATED: Use discounts.codes instead. Discount codes to apply.
	Coupons *[]string `json:"coupons,omitempty"`

	// Currency ISO 4217 currency code
	Currency string `json:"currency"`

	// Discounts Discount codes input for checkout create/update requests.
	Discounts *DiscountsRequest `json:"discounts,omitempty"`

	// FulfillmentDetails Details about how items will be fulfilled (shipping, pickup, or delivery information)
	FulfillmentDetails *FulfillmentDetails `json:"fulfillment_details,omitempty"`

	// FulfillmentGroups Grouping of items by fulfillment method
	FulfillmentGroups *[]FulfillmentGroup `json:"fulfillment_groups,omitempty"`

	// LineItems Items to add to the checkout session
	LineItems []Item `json:"line_items"`

	// Locale Locale code for localizing content (e.g., 'en-US')
	Locale *string `json:"locale,omitempty"`

	// Metadata Arbitrary metadata for merchant use
	Metadata *map[string]interface{} `json:"metadata,omitempty"`

	// QuoteId Quote identifier if this session is based on a quote
	QuoteId *string `json:"quote_id,omitempty"`

	// Timezone IANA timezone identifier (e.g., 'America/New_York')
	Timezone *string `json:"timezone,omitempty"`
}

type CheckoutSessionUpdateRequest struct {
	// Buyer Information about the buyer including contact details, company info, and loyalty status
	Buyer *Buyer `json:"buyer,omitempty"`

	// Coupons DEPRECATED: Use discounts.codes instead. Discount codes to apply.
	Coupons *[]string `json:"coupons,omitempty"`

	// Discounts Discount codes input for checkout create/update requests.
	Discounts *DiscountsRequest `json:"discounts,omitempty"`

	// FulfillmentDetails Details about how items will be fulfilled (shipping, pickup, or delivery information)
	FulfillmentDetails *FulfillmentDetails `json:"fulfillment_details,omitempty"`

	// FulfillmentGroups Updated fulfillment groupings
	FulfillmentGroups *[]FulfillmentGroup `json:"fulfillment_groups,omitempty"`

	// LineItems Items to update in the checkout session
	LineItems *[]Item `json:"line_items,omitempty"`

	// SelectedFulfillmentOptions Fulfillment option selected by the buyer
	SelectedFulfillmentOptions *[]SelectedFulfillmentOption `json:"selected_fulfillment_options,omitempty"`
}

type CheckoutSessionWithOrder struct {
	// AuthenticationMetadata Seller-provided authentication metadata for 3DS flows.
	AuthenticationMetadata *AuthenticationMetadata `json:"authentication_metadata,omitempty"`

	// Buyer Information about the buyer including contact details, company info, and loyalty status
	Buyer *Buyer `json:"buyer,omitempty"`

	// Capabilities Capabilities object used in requests and responses.
	// Context determines the party: requests are from Agents, responses are from Sellers.
	// Seller responses contain the intersection of supported interventions.
	Capabilities Capabilities `json:"capabilities"`

	// ContinueUrl URL to continue or resume the checkout session
	ContinueUrl *string `json:"continue_url,omitempty"`

	// CreatedAt RFC 3339 timestamp when the session was created
	CreatedAt *time.Time `json:"created_at,omitempty"`

	// Currency ISO 4217 settlement currency code
	Currency string `json:"currency"`

	// Discounts Discount codes input and applied discounts output in checkout responses.
	Discounts *DiscountsResponse `json:"discounts,omitempty"`

	// ExchangeRate Exchange rate from presentment to settlement currency
	ExchangeRate *float32 `json:"exchange_rate,omitempty"`

	// ExchangeRateTimestamp RFC 3339 timestamp when exchange rate was determined
	ExchangeRateTimestamp *time.Time `json:"exchange_rate_timestamp,omitempty"`

	// ExpiresAt RFC 3339 timestamp when the session expires
	ExpiresAt *time.Time `json:"expires_at,omitempty"`

	// FulfillmentDetails Details about how items will be fulfilled (shipping, pickup, or delivery information)
	FulfillmentDetails *FulfillmentDetails `json:"fulfillment_details,omitempty"`

	// FulfillmentGroups Optional grouping of line items by fulfillment method
	FulfillmentGroups *[]FulfillmentGroup `json:"fulfillment_groups,omitempty"`

	// FulfillmentOptions Available fulfillment options
	FulfillmentOptions []CheckoutSessionWithOrder_FulfillmentOptions_Item `json:"fulfillment_options"`

	// Id Unique identifier for the checkout session
	Id string `json:"id"`

	// LineItems Line items in the checkout session
	LineItems []LineItem `json:"line_items"`

	// Links Relevant links (terms, policies, support)
	Links []Link `json:"links"`

	// Locale Locale code (e.g., 'en-US') for localizing content
	Locale *string `json:"locale,omitempty"`

	// MarketingConsentOptions Marketing consent options the seller offers. When present, the agent SHOULD display these to the buyer before checkout completion. Agents MAY selectively surface a subset of options; options not surfaced MUST be omitted from marketing_consents. When absent, the agent MUST NOT surface any marketing consent UI. An empty array is equivalent to absent.
	MarketingConsentOptions *[]MarketingConsentOption `json:"marketing_consent_options,omitempty"`

	// Messages Messages to communicate with the buyer (info, warnings, errors)
	Messages []CheckoutSessionWithOrder_Messages_Item `json:"messages"`

	// Metadata Arbitrary metadata for merchant use
	Metadata *map[string]interface{} `json:"metadata,omitempty"`

	// Order Order returned after checkout completion. Contains order details and optional
	// rich post-purchase tracking (line items, fulfillments, adjustments).
	Order Order `json:"order"`

	// PresentmentCurrency ISO 4217 presentment currency code if different from settlement currency
	PresentmentCurrency *string `json:"presentment_currency,omitempty"`

	// Protocol Protocol metadata included in checkout responses. Indicates the ACP version.
	Protocol *ProtocolVersion `json:"protocol,omitempty"`

	// QuoteExpiresAt RFC 3339 timestamp when the quote expires
	QuoteExpiresAt *time.Time `json:"quote_expires_at,omitempty"`

	// QuoteId Quote identifier if this session is based on a quote
	QuoteId *string `json:"quote_id,omitempty"`

	// SelectedFulfillmentOptions Currently selected fulfillment options
	SelectedFulfillmentOptions *[]SelectedFulfillmentOption `json:"selected_fulfillment_options,omitempty"`

	// Status Current status of the checkout session
	Status CheckoutSessionWithOrderStatus `json:"status"`

	// Timezone IANA timezone identifier (e.g., 'America/New_York')
	Timezone *string `json:"timezone,omitempty"`

	// Totals Cart-level totals breakdown
	Totals []Total `json:"totals"`

	// UpdatedAt RFC 3339 timestamp of last update
	UpdatedAt *time.Time `json:"updated_at,omitempty"`
}

type CheckoutSessionWithOrderStatus string

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

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

type CompanyInfo struct {
	// CostCenter Cost center code for internal accounting
	CostCenter *string `json:"cost_center,omitempty"`

	// Department Department within the organization
	Department *string `json:"department,omitempty"`

	// Name Company or organization name
	Name string `json:"name"`

	// TaxId Business tax identification number
	TaxId *string `json:"tax_id,omitempty"`
}

type CompleteCheckoutSessionJSONRequestBody = CheckoutSessionCompleteRequest

type CompleteCheckoutSessionParams struct {
	// Authorization Bearer token for API authentication
	Authorization  Authorization   `json:"Authorization"`
	ContentType    ContentType     `json:"Content-Type"`
	AcceptLanguage *AcceptLanguage `json:"Accept-Language,omitempty"`
	UserAgent      *UserAgent      `json:"User-Agent,omitempty"`

	// IdempotencyKey Idempotency key. MUST be present on all POST requests. Opaque string, max 255 characters. UUID v4 recommended. Scoped to authenticated identity + endpoint.
	IdempotencyKey IdempotencyKey `json:"Idempotency-Key"`
	RequestId      *RequestId     `json:"Request-Id,omitempty"`

	// Signature HMAC signature for webhook verification
	Signature *Signature `json:"Signature,omitempty"`

	// Timestamp RFC 3339 date-time string for request timing validation
	Timestamp  *Timestamp `json:"Timestamp,omitempty"`
	APIVersion APIVersion `json:"API-Version"`
}

type ContentType = string

type Coupon struct {
	// AmountOff Fixed discount amount in minor currency units. Mutually exclusive with percent_off.
	AmountOff *int `json:"amount_off,omitempty"`

	// Currency ISO 4217 currency code for amount_off. Required if amount_off is set.
	Currency *string `json:"currency,omitempty"`

	// Duration How long the discount applies. 'once' = single use, 'repeating' = multiple billing periods, 'forever' = indefinitely.
	Duration *CouponDuration `json:"duration,omitempty"`

	// DurationInMonths Number of months the coupon applies if duration is 'repeating'.
	DurationInMonths *int `json:"duration_in_months,omitempty"`

	// Id Unique identifier for the coupon.
	Id string `json:"id"`

	// MaxRedemptions Maximum number of times this coupon can be redeemed across all customers.
	MaxRedemptions *int `json:"max_redemptions,omitempty"`

	// Metadata Arbitrary key-value metadata attached to the coupon.
	Metadata *map[string]string `json:"metadata,omitempty"`

	// Name Human-readable coupon name (e.g., 'Summer Sale 20% Off').
	Name string `json:"name"`

	// PercentOff Percentage discount (0-100). Mutually exclusive with amount_off.
	PercentOff *float32 `json:"percent_off,omitempty"`

	// TimesRedeemed Number of times this coupon has been redeemed.
	TimesRedeemed *int `json:"times_redeemed,omitempty"`
}

type CouponDuration string

type CreateCheckoutSessionJSONRequestBody = CheckoutSessionCreateRequest

type CreateCheckoutSessionParams struct {
	// Authorization Bearer token for API authentication
	Authorization  Authorization   `json:"Authorization"`
	ContentType    ContentType     `json:"Content-Type"`
	AcceptLanguage *AcceptLanguage `json:"Accept-Language,omitempty"`
	UserAgent      *UserAgent      `json:"User-Agent,omitempty"`

	// IdempotencyKey Idempotency key. MUST be present on all POST requests. Opaque string, max 255 characters. UUID v4 recommended. Scoped to authenticated identity + endpoint.
	IdempotencyKey IdempotencyKey `json:"Idempotency-Key"`
	RequestId      *RequestId     `json:"Request-Id,omitempty"`

	// Signature HMAC signature for webhook verification
	Signature *Signature `json:"Signature,omitempty"`

	// Timestamp RFC 3339 date-time string for request timing validation
	Timestamp  *Timestamp `json:"Timestamp,omitempty"`
	APIVersion APIVersion `json:"API-Version"`
}

type CustomAttribute struct {
	// DisplayName Human-readable label for the attribute
	DisplayName string `json:"display_name"`

	// Value Attribute value
	Value string `json:"value"`
}

type DimensionsInfo struct {
	// Height Height dimension
	Height float32 `json:"height"`

	// Length Length dimension
	Length float32 `json:"length"`

	// Unit Unit of measurement for dimensions
	Unit DimensionsInfoUnit `json:"unit"`

	// Width Width dimension
	Width float32 `json:"width"`
}

type DimensionsInfoUnit string

type Disclosure struct {
	// Content The disclosure text content. When content_type is 'markdown', this MUST be valid CommonMark with no raw HTML. Agents MUST render using a CommonMark-compliant parser with raw HTML output disabled or sanitized.
	Content string `json:"content"`

	// ContentType Format of the disclosure content. When set to 'markdown', content MUST conform to CommonMark (https://spec.commonmark.org/0.31.2/). Raw HTML elements MUST NOT be included. When set to 'plain', content is plain text with no formatting.
	ContentType DisclosureContentType `json:"content_type"`

	// Type Type of disclosure
	Type DisclosureType `json:"type"`
}

type DisclosureContentType string

type DisclosureType string

type DiscountAllocation struct {
	// Amount Amount allocated to this target in minor (cents) currency units.
	Amount int `json:"amount"`

	// Path JSONPath to the allocation target (e.g., '$.line_items[0]', '$.totals.shipping').
	Path string `json:"path"`
}

type DiscountDetail struct {
	// Amount Discount amount in minor currency units (e.g. 100 cents for $1.00 or 100 for ¥100)
	Amount int `json:"amount"`

	// Code Discount code if applicable
	Code *string `json:"code,omitempty"`

	// Description Human-readable discount description
	Description *string `json:"description,omitempty"`

	// Source Source of the discount
	Source *DiscountDetailSource `json:"source,omitempty"`

	// Type Type of discount
	Type DiscountDetailType `json:"type"`
}

type DiscountDetailSource string

type DiscountDetailType string

type DiscountErrorCode string

type DiscountsRequest struct {
	// Codes Discount codes to apply. Case-insensitive. Replaces previously submitted codes. Send empty array to clear.
	Codes *[]string `json:"codes,omitempty"`
}

type DiscountsResponse struct {
	// Applied Discounts successfully applied (code-based and automatic).
	Applied *[]AppliedDiscount `json:"applied,omitempty"`

	// Codes Echo of submitted discount codes.
	Codes *[]string `json:"codes,omitempty"`

	// Rejected Discount codes that could not be applied, with reasons.
	Rejected *[]RejectedDiscount `json:"rejected,omitempty"`
}

type Error = acp.Error

type EstimatedDelivery struct {
	// Earliest RFC 3339 timestamp for earliest expected delivery
	Earliest time.Time `json:"earliest"`

	// Latest RFC 3339 timestamp for latest expected delivery
	Latest time.Time `json:"latest"`
}

type ExtensionDeclaration struct {
	// Extends JSONPath expressions identifying the schema fields added by this extension.
	// Format: $.<SchemaName>.<fieldName> (e.g., $.CheckoutSession.discounts).
	Extends *[]string `json:"extends,omitempty"`

	// Name Unique identifier for the extension.
	Name string `json:"name"`

	// Schema URL to the extension's JSON Schema definition.
	Schema *string `json:"schema,omitempty"`

	// Spec URL to the extension's specification document.
	Spec *string `json:"spec,omitempty"`
}

type Fulfillment struct {
	// Carrier Carrier name (e.g., 'FedEx', 'UPS', 'USPS'). Applies to type: shipping.
	Carrier *string `json:"carrier,omitempty"`

	// Description Human-readable description (e.g., 'Backordered - ships Feb 15')
	Description *string `json:"description,omitempty"`

	// Destination Physical address for shipping, billing, or pickup locations
	Destination *Address `json:"destination,omitempty"`

	// DigitalDelivery Digital delivery details. Applies to type: digital.
	DigitalDelivery *struct {
		// AccessUrl URL to access digital content (download link, streaming page, etc.)
		AccessUrl *string `json:"access_url,omitempty"`

		// ExpiresAt When access expires (RFC 3339 timestamp)
		ExpiresAt *time.Time `json:"expires_at,omitempty"`

		// LicenseKey License or activation key
		LicenseKey *string `json:"license_key,omitempty"`
	} `json:"digital_delivery,omitempty"`

	// EstimatedDelivery Estimated delivery date range for a fulfillment option
	EstimatedDelivery *EstimatedDelivery `json:"estimated_delivery,omitempty"`

	// Events Append-only event log tracking fulfillment progress
	Events *[]FulfillmentEvent `json:"events,omitempty"`

	// Id Fulfillment identifier
	Id string `json:"id"`

	// LineItems Which line items and quantities are in this fulfillment
	LineItems *[]LineItemReference `json:"line_items,omitempty"`

	// Status Current fulfillment status. Implementations MUST accept unrecognized values gracefully. Defined values: 'pending', 'processing', 'shipped', 'in_transit', 'out_for_delivery', 'ready_for_pickup', 'delivered', 'failed', 'canceled'. Not all statuses apply to all types:
	// - shipping: pending, processing, shipped, in_transit, out_for_delivery, delivered, failed, canceled
	// - pickup: pending, processing, ready_for_pickup, delivered, failed, canceled
	// - digital: pending, processing, delivered, failed, canceled
	Status *string `json:"status,omitempty"`

	// TrackingNumber Carrier tracking number. Applies to type: shipping.
	TrackingNumber *string `json:"tracking_number,omitempty"`

	// TrackingUrl URL to track this shipment. Applies to type: shipping.
	TrackingUrl *string `json:"tracking_url,omitempty"`

	// Type Fulfillment method type
	Type FulfillmentType `json:"type"`
}

type FulfillmentDetails struct {
	// Address Physical address for shipping, billing, or pickup locations
	Address *Address `json:"address,omitempty"`

	// Email Contact email address
	Email *openapi_types.Email `json:"email,omitempty"`

	// Name Full name for fulfillment contact
	Name *string `json:"name,omitempty"`

	// PhoneNumber Contact phone number
	PhoneNumber *string `json:"phone_number,omitempty"`
}

type FulfillmentEvent struct {
	// Description Human-readable description (e.g., 'Left at front door')
	Description *string `json:"description,omitempty"`

	// Id Event identifier
	Id string `json:"id"`

	// Location Location where this event occurred (e.g., 'Memphis, TN')
	Location *string `json:"location,omitempty"`

	// OccurredAt RFC 3339 timestamp when this event occurred
	OccurredAt time.Time `json:"occurred_at"`

	// Type Event type. Implementations MUST accept unrecognized values gracefully. Defined values: 'processing', 'shipped', 'in_transit', 'out_for_delivery', 'ready_for_pickup', 'delivered', 'failed_attempt', 'returned_to_sender', 'canceled', 'undeliverable'. 'out_for_delivery' and 'ready_for_pickup' are ACP extensions for richer agent experiences.
	Type string `json:"type"`
}

type FulfillmentGroup struct {
	// DestinationType Type of fulfillment for this group
	DestinationType FulfillmentGroupDestinationType `json:"destination_type"`

	// FulfillmentDetails Details about how items will be fulfilled (shipping, pickup, or delivery information)
	FulfillmentDetails *FulfillmentDetails `json:"fulfillment_details,omitempty"`

	// Id Unique identifier for this fulfillment group
	Id string `json:"id"`

	// Instructions Special fulfillment instructions
	Instructions *string `json:"instructions,omitempty"`

	// ItemIds List of line item IDs in this fulfillment group
	ItemIds []string `json:"item_ids"`

	// LocationId Location identifier for pickup or local delivery
	LocationId *string `json:"location_id,omitempty"`
}

type FulfillmentGroupDestinationType string

type FulfillmentOptionDigital struct {
	// Description Additional details about digital delivery method
	Description *string `json:"description,omitempty"`

	// Id Unique identifier for this fulfillment option
	Id string `json:"id"`

	// Title Display title for this digital delivery option
	Title string `json:"title"`

	// Totals Cost breakdown for this fulfillment option
	Totals []Total `json:"totals"`

	// Type Fulfillment type discriminator
	Type FulfillmentOptionDigitalType `json:"type"`
}

type FulfillmentOptionDigitalType string

type FulfillmentOptionLocalDelivery struct {
	// DeliveryWindow Expected delivery time window
	DeliveryWindow *struct {
		// End RFC 3339 timestamp for delivery window end
		End time.Time `json:"end"`

		// Start RFC 3339 timestamp for delivery window start
		Start time.Time `json:"start"`
	} `json:"delivery_window,omitempty"`

	// Description Additional details about this delivery option
	Description *string `json:"description,omitempty"`

	// Id Unique identifier for this fulfillment option
	Id string `json:"id"`

	// ServiceArea Geographic service area for local delivery
	ServiceArea *struct {
		// CenterPostalCode Center point postal code for delivery radius
		CenterPostalCode *string `json:"center_postal_code,omitempty"`

		// RadiusMiles Delivery radius in miles
		RadiusMiles *float32 `json:"radius_miles,omitempty"`
	} `json:"service_area,omitempty"`

	// Title Display title for this local delivery option
	Title string `json:"title"`

	// Totals Cost breakdown for this fulfillment option
	Totals []Total `json:"totals"`

	// Type Fulfillment type discriminator
	Type FulfillmentOptionLocalDeliveryType `json:"type"`
}

type FulfillmentOptionLocalDeliveryType string

type FulfillmentOptionPickup struct {
	// Description Additional details about this pickup option
	Description *string `json:"description,omitempty"`

	// Id Unique identifier for this fulfillment option
	Id string `json:"id"`

	// Location Pickup location details
	Location struct {
		// Address Physical address for shipping, billing, or pickup locations
		Address Address `json:"address"`

		// Instructions Special pickup instructions
		Instructions *string `json:"instructions,omitempty"`

		// Name Location name
		Name string `json:"name"`

		// Phone Location phone number
		Phone *string `json:"phone,omitempty"`
	} `json:"location"`

	// PickupBy RFC 3339 timestamp by which order must be picked up
	PickupBy *time.Time `json:"pickup_by,omitempty"`

	// PickupType Type of pickup method
	PickupType *FulfillmentOptionPickupPickupType `json:"pickup_type,omitempty"`

	// ReadyBy RFC 3339 timestamp when order will be ready for pickup
	ReadyBy *time.Time `json:"ready_by,omitempty"`

	// Title Display title for this pickup option
	Title string `json:"title"`

	// Totals Cost breakdown for this fulfillment option
	Totals []Total `json:"totals"`

	// Type Fulfillment type discriminator
	Type FulfillmentOptionPickupType `json:"type"`
}

type FulfillmentOptionPickupPickupType string

type FulfillmentOptionPickupType string

type FulfillmentOptionShipping struct {
	// Carrier Shipping carrier name (e.g., 'USPS', 'FedEx')
	Carrier *string `json:"carrier,omitempty"`

	// Description Additional details about this shipping option
	Description *string `json:"description,omitempty"`

	// EarliestDeliveryTime RFC 3339 timestamp for earliest expected delivery
	EarliestDeliveryTime *time.Time `json:"earliest_delivery_time,omitempty"`

	// Id Unique identifier for this fulfillment option
	Id string `json:"id"`

	// LatestDeliveryTime RFC 3339 timestamp for latest expected delivery
	LatestDeliveryTime *time.Time `json:"latest_delivery_time,omitempty"`

	// Title Display title for this shipping option (e.g., 'Standard Shipping', 'Express')
	Title string `json:"title"`

	// Totals Cost breakdown for this fulfillment option
	Totals []Total `json:"totals"`

	// Type Fulfillment type discriminator
	Type FulfillmentOptionShippingType `json:"type"`
}

type FulfillmentOptionShippingType string

type FulfillmentType string

type GetCheckoutSessionParams struct {
	// Authorization Bearer token for API authentication
	Authorization  Authorization   `json:"Authorization"`
	AcceptLanguage *AcceptLanguage `json:"Accept-Language,omitempty"`
	UserAgent      *UserAgent      `json:"User-Agent,omitempty"`
	RequestId      *RequestId      `json:"Request-Id,omitempty"`

	// Signature HMAC signature for webhook verification
	Signature *Signature `json:"Signature,omitempty"`

	// Timestamp RFC 3339 date-time string for request timing validation
	Timestamp  *Timestamp `json:"Timestamp,omitempty"`
	APIVersion APIVersion `json:"API-Version"`
}

type GiftWrap struct {
	// Charge Additional charge for gift wrapping in minor currency units (e.g. 100 cents for $1.00 or 100 for ¥100)
	Charge *int `json:"charge,omitempty"`

	// Enabled Whether gift wrapping is enabled for this order
	Enabled bool `json:"enabled"`

	// Style Gift wrap style selected
	Style *GiftWrapStyle `json:"style,omitempty"`
}

type GiftWrapStyle string

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

type IdempotencyConflict = Error

type IdempotencyInFlight = Error

type IdempotencyKey = string

type IdempotencyKeyRequired = Error

type IntentTrace struct {
	// Metadata Additional structured metadata about the intent
	Metadata *map[string]interface{} `json:"metadata,omitempty"`

	// ReasonCode Reason for abandonment. This enum is extensible: servers SHOULD accept
	// unrecognized values and treat them as "other" (see RFC Section 7.2).
	// Validators SHOULD be configured for lenient enum handling.
	ReasonCode IntentTraceReasonCode `json:"reason_code"`

	// TraceSummary A generated summary of the specific objection or negotiation gap.
	TraceSummary *string `json:"trace_summary,omitempty"`
}

type IntentTraceReasonCode string

type InterventionCapabilities struct {
	// DisplayContext How the Agent presents interventions (agent only).
	DisplayContext *InterventionCapabilitiesDisplayContext `json:"display_context,omitempty"`

	// Enforcement When required interventions are enforced (seller only).
	Enforcement *InterventionCapabilitiesEnforcement `json:"enforcement,omitempty"`

	// MaxInteractionDepth Maximum depth of nested interactions the Agent can handle (agent only).
	MaxInteractionDepth *int `json:"max_interaction_depth,omitempty"`

	// MaxRedirects Maximum number of redirects the Agent can handle (agent only).
	MaxRedirects *int `json:"max_redirects,omitempty"`

	// RedirectContext How the Agent handles redirects (agent only).
	RedirectContext *InterventionCapabilitiesRedirectContext `json:"redirect_context,omitempty"`

	// Required Intervention methods required for this session (seller only).
	Required *[]InterventionCapabilitiesRequired `json:"required,omitempty"`

	// Supported Intervention types supported.
	// - Agent request: Interventions the agent can handle
	// - Seller response: Intersection of supported interventions
	Supported *[]InterventionCapabilitiesSupported `json:"supported,omitempty"`
}

type InterventionCapabilitiesDisplayContext string

type InterventionCapabilitiesEnforcement string

type InterventionCapabilitiesRedirectContext string

type InterventionCapabilitiesRequired string

type InterventionCapabilitiesSupported string

type Item struct {
	// Id Unique identifier for the item
	Id string `json:"id"`

	// Name Display name of the item
	Name *string `json:"name,omitempty"`

	// UnitAmount Price per unit in minor currency units (e.g. 100 cents for $1.00 or 100 for ¥100)
	UnitAmount *int `json:"unit_amount,omitempty"`
}

type LineItem struct {
	// AvailabilityStatus Current availability status of the item
	AvailabilityStatus *LineItemAvailabilityStatus `json:"availability_status,omitempty"`

	// AvailableQuantity Quantity currently available for purchase
	AvailableQuantity *int `json:"available_quantity,omitempty"`

	// Category Product category
	Category *string `json:"category,omitempty"`

	// CustomAttributes Custom attributes specific to this line item
	CustomAttributes *[]CustomAttribute `json:"custom_attributes,omitempty"`

	// Description Detailed description of the line item
	Description *string `json:"description,omitempty"`

	// Dimensions Physical dimensions of a product with unit of measurement
	Dimensions *DimensionsInfo `json:"dimensions,omitempty"`

	// Disclosures Legal disclosures or disclaimers for this item
	Disclosures *[]Disclosure `json:"disclosures,omitempty"`

	// DiscountDetails Line-item level discount details
	DiscountDetails *[]DiscountDetail `json:"discount_details,omitempty"`

	// FulfillableOn RFC 3339 timestamp when item becomes available for fulfillment
	FulfillableOn *time.Time `json:"fulfillable_on,omitempty"`

	// Id Unique identifier for the line item
	Id string `json:"id"`

	// Images Array of image URLs for this line item
	Images *[]string `json:"images,omitempty"`

	// Item A purchasable item with variant options (e.g., size, color) and quantity
	Item Item `json:"item"`

	// MarketplaceSellerDetails Information about a third-party seller in a marketplace model
	MarketplaceSellerDetails *MarketplaceSellerDetails `json:"marketplace_seller_details,omitempty"`

	// MaxQuantityPerOrder Maximum quantity allowed per order
	MaxQuantityPerOrder *int `json:"max_quantity_per_order,omitempty"`

	// Name Display name of the line item
	Name *string `json:"name,omitempty"`

	// ParentId Reference to parent line item for bundled products
	ParentId *string `json:"parent_id,omitempty"`

	// ProductId Merchant's product identifier
	ProductId *string `json:"product_id,omitempty"`

	// Quantity Number of units for this line item
	Quantity int `json:"quantity"`

	// Sku Stock keeping unit identifier
	Sku *string `json:"sku,omitempty"`

	// Tags Product tags or labels
	Tags *[]string `json:"tags,omitempty"`

	// TaxExempt Whether this line item is tax exempt
	TaxExempt *bool `json:"tax_exempt,omitempty"`

	// TaxExemptionReason Reason for tax exemption if applicable
	TaxExemptionReason *string `json:"tax_exemption_reason,omitempty"`

	// Totals Line-item level totals breakdown including base_amount, discount, subtotal, tax, and total
	Totals []Total `json:"totals"`

	// UnitAmount The unit price of the line item in the smallest currency unit (e.g., cents for USD)
	UnitAmount *int `json:"unit_amount,omitempty"`

	// VariantId Product variant identifier
	VariantId *string `json:"variant_id,omitempty"`

	// VariantOptions Selected product variant options (e.g., size, color)
	VariantOptions *[]VariantOption `json:"variant_options,omitempty"`

	// Weight Product weight with unit of measurement
	Weight *WeightInfo `json:"weight,omitempty"`
}

type LineItemAvailabilityStatus string

type LineItemReference struct {
	// Id Line item ID reference
	Id string `json:"id"`

	// Quantity Quantity in this fulfillment or adjustment
	Quantity int `json:"quantity"`
}

type Link struct {
	// Title Display text for the link
	Title *string `json:"title,omitempty"`

	// Type Type of link
	Type LinkType `json:"type"`

	// Url URL destination
	Url string `json:"url"`
}

type LinkType string

type LoyaltyInfo struct {
	// MemberSince RFC 3339 timestamp when the customer joined the loyalty program
	MemberSince *time.Time `json:"member_since,omitempty"`

	// PointsBalance Current loyalty points balance
	PointsBalance *int `json:"points_balance,omitempty"`

	// Tier Loyalty program tier level
	Tier *string `json:"tier,omitempty"`
}

type MarketingConsent struct {
	// Channel Channel matching the consent option channel.
	//
	// Examples: email, sms, whatsapp
	Channel string `json:"channel"`

	// OptedIn Whether the buyer consented to receive marketing via this channel.
	OptedIn bool `json:"opted_in"`
}

type MarketingConsentOption struct {
	// Channel Channel for marketing consent.
	//
	// Examples: email, sms, whatsapp
	Channel string `json:"channel"`

	// DisplayText What the buyer is consenting to receive, e.g., 'promotional emails, product launches, and exclusive offers'. Agents MAY use this to compose their own consent prompt.
	DisplayText string `json:"display_text"`

	// IsSubscribed Whether the buyer is currently subscribed to marketing via this channel. When true, agents SHOULD render the consent checkbox as pre-checked. Defaults to false if omitted.
	IsSubscribed *bool `json:"is_subscribed,omitempty"`

	// PrivacyPolicyUrl URL to the seller's privacy policy governing use of the buyer's contact information for marketing.
	PrivacyPolicyUrl string `json:"privacy_policy_url"`
}

type MarketplaceSellerDetails struct {
	// Name Name of the marketplace seller or vendor
	Name string `json:"name"`
}

type MessageError struct {
	// Code Error code indicating the type of error
	Code MessageErrorCode `json:"code"`

	// Content Error message text. When content_type is 'markdown', this MUST be valid CommonMark with no raw HTML. Agents MUST render using a CommonMark-compliant parser with raw HTML output disabled or sanitized.
	Content string `json:"content"`

	// ContentType Format of the error message content. When set to 'markdown', content MUST conform to CommonMark (https://spec.commonmark.org/0.31.2/). Raw HTML elements MUST NOT be included. When set to 'plain', content is plain text with no formatting.
	ContentType MessageErrorContentType `json:"content_type"`

	// Param RFC 9535 JSONPath
	Param *string `json:"param,omitempty"`

	// Resolution Who resolves this message. 'recoverable': agent can fix via API. 'requires_buyer_input': buyer must provide info. 'requires_buyer_review': buyer must authorize.
	Resolution *MessageErrorResolution `json:"resolution,omitempty"`

	// Severity Severity level of this error
	Severity *MessageErrorSeverity `json:"severity,omitempty"`

	// Type Message type discriminator
	Type MessageErrorType `json:"type"`
}

type MessageErrorCode string

type MessageErrorContentType string

type MessageErrorResolution string

type MessageErrorSeverity string

type MessageErrorType string

type MessageInfo struct {
	// Content Informational message text. When content_type is 'markdown', this MUST be valid CommonMark with no raw HTML. Agents MUST render using a CommonMark-compliant parser with raw HTML output disabled or sanitized.
	Content string `json:"content"`

	// ContentType Format of the message content. When set to 'markdown', content MUST conform to CommonMark (https://spec.commonmark.org/0.31.2/). Raw HTML elements MUST NOT be included. When set to 'plain', content is plain text with no formatting.
	ContentType MessageInfoContentType `json:"content_type"`

	// Param RFC 9535 JSONPath
	Param *string `json:"param,omitempty"`

	// Resolution Who resolves this message. 'recoverable': agent can fix via API. 'requires_buyer_input': buyer must provide info. 'requires_buyer_review': buyer must authorize.
	Resolution *MessageInfoResolution `json:"resolution,omitempty"`

	// Severity Severity level of this informational message
	Severity *MessageInfoSeverity `json:"severity,omitempty"`

	// Type Message type discriminator
	Type MessageInfoType `json:"type"`
}

type MessageInfoContentType string

type MessageInfoResolution string

type MessageInfoSeverity string

type MessageInfoType string

type MessageWarning struct {
	// Code Warning code indicating the type of warning
	Code MessageWarningCode `json:"code"`

	// Content Warning message text. When content_type is 'markdown', this MUST be valid CommonMark with no raw HTML. Agents MUST render using a CommonMark-compliant parser with raw HTML output disabled or sanitized.
	Content string `json:"content"`

	// ContentType Format of the warning message content. When set to 'markdown', content MUST conform to CommonMark (https://spec.commonmark.org/0.31.2/). Raw HTML elements MUST NOT be included. When set to 'plain', content is plain text with no formatting.
	ContentType MessageWarningContentType `json:"content_type"`

	// Param RFC 9535 JSONPath
	Param *string `json:"param,omitempty"`

	// Resolution Who resolves this message. 'recoverable': agent can fix via API. 'requires_buyer_input': buyer must provide info. 'requires_buyer_review': buyer must authorize.
	Resolution *MessageWarningResolution `json:"resolution,omitempty"`

	// Severity Severity level of this warning
	Severity *MessageWarningSeverity `json:"severity,omitempty"`

	// Type Message type discriminator
	Type MessageWarningType `json:"type"`
}

type MessageWarningCode string

type MessageWarningContentType string

type MessageWarningResolution string

type MessageWarningSeverity string

type MessageWarningType string

type Option func(*config)

type Order struct {
	// Adjustments Post-order changes: refunds, credits, returns, disputes
	Adjustments *[]Adjustment `json:"adjustments,omitempty"`

	// CheckoutSessionId ID of the checkout session that created this order
	CheckoutSessionId string `json:"checkout_session_id"`

	// Confirmation Order confirmation details including order number and tracking information
	Confirmation *OrderConfirmation `json:"confirmation,omitempty"`

	// EstimatedDelivery Estimated delivery date range for a fulfillment option
	EstimatedDelivery *EstimatedDelivery `json:"estimated_delivery,omitempty"`

	// Fulfillments How items are being delivered (shipping, pickup, digital)
	Fulfillments *[]Fulfillment `json:"fulfillments,omitempty"`

	// Id Unique identifier for the order
	Id string `json:"id"`

	// LineItems What was ordered, with per-item fulfillment tracking
	LineItems *[]OrderLineItem `json:"line_items,omitempty"`

	// OrderNumber Human-readable order number for customer reference
	OrderNumber *string `json:"order_number,omitempty"`

	// PermalinkUrl Permanent URL where the customer can view order details
	PermalinkUrl string `json:"permalink_url"`

	// Status Order-level status. Implementations MUST accept unrecognized values gracefully. Defined values: 'created', 'confirmed', 'manual_review', 'processing', 'shipped', 'completed', 'canceled'. 'completed' means all items have been delivered/received regardless of fulfillment method. Distinct from LineItem.status 'fulfilled', which indicates the seller has dispatched the item.
	Status *string `json:"status,omitempty"`

	// Support Customer support contact information including email, phone, and URL
	Support *SupportInfo `json:"support,omitempty"`

	// Totals Order-level totals using the same Total schema as checkout. The 'total' entry is always the original charged amount. 'amount_refunded' tracks cumulative refunds.
	Totals *[]Total `json:"totals,omitempty"`

	// Type Discriminator field for webhook payloads. Always 'order' when present.
	Type *OrderType `json:"type,omitempty"`
}

type OrderConfirmation struct {
	// ConfirmationEmailSent Whether a confirmation email has been sent
	ConfirmationEmailSent *bool `json:"confirmation_email_sent,omitempty"`

	// ConfirmationNumber Order confirmation number
	ConfirmationNumber *string `json:"confirmation_number,omitempty"`

	// InvoiceNumber Invoice number if generated
	InvoiceNumber *string `json:"invoice_number,omitempty"`

	// ReceiptUrl URL to the order receipt
	ReceiptUrl *string `json:"receipt_url,omitempty"`
}

type OrderLineItem struct {
	// Description Product description
	Description *string `json:"description,omitempty"`

	// Id Line item identifier, used for references in fulfillments and adjustments
	Id string `json:"id"`

	// ImageUrl Product image URL
	ImageUrl *string `json:"image_url,omitempty"`

	// ProductId Catalog product ID
	ProductId *string `json:"product_id,omitempty"`

	// Quantity Quantity tracking for an order line item. Uses a 3-field model: ordered (original), current (active after cancellations/returns), fulfilled (completed).
	Quantity OrderLineItemQuantity `json:"quantity"`

	// Status Derived from quantity fields. Implementations MUST accept unrecognized values gracefully. Defined values: 'processing', 'partial', 'fulfilled', 'removed'. Rules: 'removed' if current==0, 'fulfilled' if fulfilled==current, 'partial' if 0<fulfilled<current, 'processing' otherwise.
	Status *string `json:"status,omitempty"`

	// Subtotal Line total in minor currency units (quantity.ordered * unit_price)
	Subtotal *int `json:"subtotal,omitempty"`

	// Title Product name
	Title string `json:"title"`

	// Totals Optional line-item level totals breakdown using the same Total schema as checkout. Merchants who can provide richer breakdowns MAY use this alongside or instead of unit_price/subtotal.
	Totals *[]Total `json:"totals,omitempty"`

	// UnitPrice Price per unit in minor currency units (cents)
	UnitPrice *int `json:"unit_price,omitempty"`

	// Url Product page URL
	Url *string `json:"url,omitempty"`
}

type OrderLineItemQuantity struct {
	// Current Current active quantity on the order. May be less than ordered due to cancellations or returns. A value of 0 means the line item has been fully removed.
	Current int `json:"current"`

	// Fulfilled Quantity that has been fulfilled (shipped, picked up, or digitally delivered). Applies to all fulfillment types, not just shipping.
	Fulfilled *int `json:"fulfilled,omitempty"`

	// Ordered Quantity originally ordered by the customer
	Ordered int `json:"ordered"`
}

type OrderType string

type Payment struct {
	// Handlers Available payment handlers
	Handlers []PaymentHandler `json:"handlers"`
}

type PaymentData struct {
	// ApprovalRequired Whether this payment requires approval
	ApprovalRequired *bool `json:"approval_required,omitempty"`

	// BillingAddress Physical address for shipping, billing, or pickup locations
	BillingAddress *Address `json:"billing_address,omitempty"`

	// DueDate RFC 3339 timestamp when payment is due
	DueDate *time.Time `json:"due_date,omitempty"`

	// HandlerId ID of the payment handler to use
	HandlerId *string `json:"handler_id,omitempty"`

	// Instrument Payment instrument details
	Instrument *struct {
		// Credential Payment credential
		Credential struct {
			// Token Credential token value
			Token string `json:"token"`

			// Type Credential type (e.g., spt, wallet_token)
			Type string `json:"type"`
		} `json:"credential"`

		// Type Instrument type (e.g., card, wallet_token)
		Type string `json:"type"`
	} `json:"instrument,omitempty"`

	// PaymentTerms Payment terms for B2B transactions
	PaymentTerms *PaymentDataPaymentTerms `json:"payment_terms,omitempty"`

	// PurchaseOrderNumber Purchase order number
	PurchaseOrderNumber *string `json:"purchase_order_number,omitempty"`
	// contains filtered or unexported fields
}

type PaymentData0 = interface{}

type PaymentData1 = interface{}

type PaymentDataPaymentTerms string

type PaymentHandler struct {
	// Config Handler-specific configuration
	Config map[string]interface{} `json:"config"`

	// ConfigSchema URL to JSON Schema for handler configuration
	ConfigSchema string `json:"config_schema"`

	// DisplayName Human-readable name for UI (e.g., Credit Card). Use when showing payment options to the buyer.
	DisplayName *string `json:"display_name,omitempty"`

	// Id Seller-defined handler identifier
	Id string `json:"id"`

	// InstrumentSchemas URLs to JSON Schemas for payment instruments
	InstrumentSchemas []string `json:"instrument_schemas"`

	// Name Handler name in reverse-DNS format (e.g., dev.acp.tokenized.card)
	Name string `json:"name"`

	// Psp Payment Service Provider identifier
	Psp string `json:"psp"`

	// RequiresDelegatePayment Whether this handler requires using delegate_payment API
	RequiresDelegatePayment bool `json:"requires_delegate_payment"`

	// RequiresPciCompliance Whether this handler routes PCI DSS sensitive data
	RequiresPciCompliance bool `json:"requires_pci_compliance"`

	// Spec URL to handler specification
	Spec string `json:"spec"`

	// Version Handler version in YYYY-MM-DD format
	Version string `json:"version"`
}

type PaymentMethodObject struct {
	// Brands Specific card brands/networks accepted
	Brands *[]PaymentMethodObjectBrands `json:"brands,omitempty"`

	// FundingTypes For card methods, funding types accepted
	FundingTypes *[]PaymentMethodObjectFundingTypes `json:"funding_types,omitempty"`

	// Method The payment method identifier
	Method string `json:"method"`

	// Providers Optional PSP routing information
	Providers *[]string `json:"providers,omitempty"`
}

type PaymentMethodObjectBrands string

type PaymentMethodObjectFundingTypes string

type PaymentResponse struct {
	// Handlers Available payment handlers
	Handlers *[]map[string]interface{} `json:"handlers,omitempty"`

	// Instruments Available payment instruments
	Instruments *[]map[string]interface{} `json:"instruments,omitempty"`

	// Provider Payment provider identifier
	Provider *string `json:"provider,omitempty"`
}

type ProtocolVersion struct {
	// Version ACP protocol version in YYYY-MM-DD format.
	Version string `json:"version"`
}

type Provider interface {
	// CreateSession initializes a new checkout session from items and (optionally) buyer and fulfillment info.
	// MUST return [CheckoutSessionBase] with a rich, authoritative cart state.
	CreateSession(ctx context.Context, req CheckoutSessionCreateRequest) (*CheckoutSessionBase, error)

	// UpdateSession applies changes (items, fulfillment address, fulfillment option) and returns an updated authoritative cart state.
	UpdateSession(ctx context.Context, id string, req CheckoutSessionUpdateRequest) (*CheckoutSessionBase, error)

	// GetSession returns the latest authoritative state for the checkout session.
	GetSession(ctx context.Context, id string) (*CheckoutSessionBase, error)

	// CompleteSession finalizes the checkout by applying a payment method. MUST create an order and return [CheckoutSessionWithOrder] on success.
	//
	// Agents MAY include [CheckoutSessionCompleteRequest.AffiliateAttribution] to ensure the merchant receives final attribution context.
	// Attribution is stored alongside the resulting order but not returned in the response.
	CompleteSession(ctx context.Context, id string, req CheckoutSessionCompleteRequest) (CheckoutSessionWithOrder, error)

	// CancelSession cancels a session if not already completed or canceled.
	// Agents MAY include an [CancelSessionRequest.IntentTrace] to communicate why the session is being abandoned.
	CancelSession(ctx context.Context, id string, req *CancelSessionRequest) (*CheckoutSessionBase, error)
}

type RejectedDiscount struct {
	// Code The discount code that was rejected.
	Code string `json:"code"`

	// Message Human-readable explanation of why the code was rejected.
	Message *string `json:"message,omitempty"`

	// Reason Error codes for rejected discount codes, used in messages[].code.
	Reason DiscountErrorCode `json:"reason"`
}

type RequestId = string

type RiskSignals struct {
	// AcceptLanguage Accept-Language header from the buyer's browser
	AcceptLanguage *string `json:"accept_language,omitempty"`

	// DeviceFingerprint Device fingerprint for fraud detection
	DeviceFingerprint *string `json:"device_fingerprint,omitempty"`

	// IpAddress IP address of the buyer
	IpAddress *string `json:"ip_address,omitempty"`

	// SessionId Session identifier for the buyer
	SessionId *string `json:"session_id,omitempty"`

	// UserAgent User agent string of the buyer's browser
	UserAgent *string `json:"user_agent,omitempty"`
}

type SelectedFulfillmentOption struct {
	// ItemIds List of line item IDs associated with this fulfillment option
	ItemIds []string `json:"item_ids"`

	// OptionId ID of the selected fulfillment option
	OptionId string `json:"option_id"`

	// Type Type of fulfillment option selected
	Type SelectedFulfillmentOptionType `json:"type"`
}

type SelectedFulfillmentOptionType string

type Signature = string

type SplitPayment struct {
	// Amount Payment amount in minor currency units (e.g. 100 cents for $1.00 or 100 for ¥100) for this split
	Amount int `json:"amount"`
}

type SupportInfo struct {
	// Email Support contact email
	Email *openapi_types.Email `json:"email,omitempty"`

	// HelpCenterUrl URL to merchant's help center
	HelpCenterUrl *string `json:"help_center_url,omitempty"`

	// Hours Support hours of operation
	Hours *string `json:"hours,omitempty"`

	// Phone Support contact phone number
	Phone *string `json:"phone,omitempty"`
}

type TaxBreakdownItem struct {
	// Amount Tax amount in minor currency units (e.g. 100 cents for $1.00 or 100 for ¥100)
	Amount int `json:"amount"`

	// Jurisdiction Tax jurisdiction name (e.g., 'California State Tax', 'City of San Francisco')
	Jurisdiction string `json:"jurisdiction"`

	// Rate Tax rate as a decimal (e.g., 0.0875 for 8.75%)
	Rate float32 `json:"rate"`
}

type TaxExemption struct {
	// CertificateId Unique identifier for the tax exemption certificate
	CertificateId string `json:"certificate_id"`

	// CertificateType Type of tax exemption certificate
	CertificateType TaxExemptionCertificateType `json:"certificate_type"`

	// ExemptRegions List of regions where the exemption applies (e.g., state codes)
	ExemptRegions *[]string `json:"exempt_regions,omitempty"`

	// ExpiresAt RFC 3339 timestamp when the exemption certificate expires
	ExpiresAt *time.Time `json:"expires_at,omitempty"`
}

type TaxExemptionCertificateType string

type Timestamp = time.Time

type Total struct {
	// Amount Amount in minor currency units (e.g. 100 cents for $1.00 or 100 for ¥100)
	Amount int `json:"amount"`

	// Breakdown Detailed breakdown for tax totals
	Breakdown *[]TaxBreakdownItem `json:"breakdown,omitempty"`

	// Description Additional descriptive text for this total
	Description *string `json:"description,omitempty"`

	// DisplayText Localized display text for this total
	DisplayText string `json:"display_text"`

	// PresentmentAmount Amount in presentment currency minor units if different from settlement currency
	PresentmentAmount *int `json:"presentment_amount,omitempty"`

	// Type Type of total line item
	Type TotalType `json:"type"`
}

type TotalType string

type UpdateCheckoutSessionJSONRequestBody = CheckoutSessionUpdateRequest

type UpdateCheckoutSessionParams struct {
	// IdempotencyKey Idempotency key. MUST be present on all POST requests. Opaque string, max 255 characters. UUID v4 recommended. Scoped to authenticated identity + endpoint.
	IdempotencyKey IdempotencyKey `json:"Idempotency-Key"`

	// Authorization Bearer token for API authentication
	Authorization  Authorization   `json:"Authorization"`
	AcceptLanguage *AcceptLanguage `json:"Accept-Language,omitempty"`
	UserAgent      *UserAgent      `json:"User-Agent,omitempty"`
	RequestId      *RequestId      `json:"Request-Id,omitempty"`

	// Signature HMAC signature for webhook verification
	Signature *Signature `json:"Signature,omitempty"`

	// Timestamp RFC 3339 date-time string for request timing validation
	Timestamp  *Timestamp `json:"Timestamp,omitempty"`
	APIVersion APIVersion `json:"API-Version"`
}

type UserAgent = string

type VariantOption struct {
	// Name Variant attribute name (e.g., 'Size', 'Color')
	Name string `json:"name"`

	// Value Variant attribute value (e.g., 'Large', 'Blue')
	Value string `json:"value"`
}

type WeightInfo struct {
	// Unit Unit of measurement for weight
	Unit WeightInfoUnit `json:"unit"`

	// Value Numeric weight value
	Value float32 `json:"value"`
}

type WeightInfoUnit string