acp

type Address struct {
	Name       string  `json:"name"`
	LineOne    string  `json:"line_one"`
	LineTwo    *string `json:"line_two,omitempty"`
	PostalCode string  `json:"postal_code"`
	City       string  `json:"city"`
	State      string  `json:"state"`
	Country    string  `json:"country"`
}

type Adjustment struct {
	// ID is the adjustment identifier.
	ID string `json:"id"`
	// Type classifies the adjustment.
	Type AdjustmentType `json:"type"`
	// OccurredAt is the RFC3339 timestamp for the adjustment event.
	OccurredAt time.Time `json:"occurred_at"`
	// Status is the adjustment processing status.
	Status AdjustmentStatus `json:"status"`
	// LineItems lists affected line items and quantities.
	LineItems []LineItemReference `json:"line_items,omitempty"`
	// Amount is the credited amount in minor units, inclusive of tax.
	Amount *int `json:"amount,omitempty"`
	// Currency is the ISO 4217 currency code for Amount.
	Currency *string `json:"currency,omitempty"`
	// Description is an optional human-readable explanation.
	Description *string `json:"description,omitempty"`
	// Reason is an optional structured reason code.
	Reason *string `json:"reason,omitempty"`
}

type AdjustmentStatus string

type AdjustmentType string

type AffiliateAttribution struct {
	// Provider is the attribution provider / affiliate network namespace (for example "impact.com").
	Provider string `json:"provider"`
	// Token is an opaque provider-issued token for fraud-resistant validation.
	Token *string `json:"token,omitempty"`
	// PublisherID is the provider-scoped affiliate/publisher identifier.
	PublisherID *string                      `json:"publisher_id,omitempty"`
	CampaignID  *string                      `json:"campaign_id,omitempty"`
	CreativeID  *string                      `json:"creative_id,omitempty"`
	SubID       *string                      `json:"sub_id,omitempty"`
	Source      *AffiliateAttributionSource  `json:"source,omitempty"`
	IssuedAt    *time.Time                   `json:"issued_at,omitempty"`
	ExpiresAt   *time.Time                   `json:"expires_at,omitempty"`
	Metadata    AffiliateAttributionMetadata `json:"metadata,omitempty"`
	// Touchpoint is the attribution touchpoint type ("first" or "last").
	Touchpoint *string `json:"touchpoint,omitempty"`
}

type AffiliateAttributionMetadata map[string]any

type AffiliateAttributionSource struct {
	Type string  `json:"type"`
	URL  *string `json:"url,omitempty"`
}

type Allowance struct {
	// Current possible values: "one_time".
	Reason AllowanceReason `json:"reason" validate:"required,eq=one_time"`
	// Max amount the payment method can be charged for.
	MaxAmount int `json:"max_amount" validate:"required,gt=0"`
	// Currency.
	Currency string `json:"currency" validate:"required,currency"`
	// Reference to checkout_session_id.
	CheckoutSessionID string `json:"checkout_session_id" validate:"required"`
	// Merchant identifying descriptor.
	MerchantID string `json:"merchant_id" validate:"required"`
	// Time formatted as an RFC 3339 string.
	ExpiresAt time.Time `json:"expires_at" validate:"required"`
}

type AllowanceReason string

type AuthenticationAcquirerDetails struct {
	// AcquirerBin is the acquirer BIN (directory-server specific).
	AcquirerBin string `json:"acquirer_bin"`
	// AcquirerCountry is the ISO 3166-1 alpha-2 country code.
	AcquirerCountry string `json:"acquirer_country"`
	// AcquirerMerchantId is the merchant ID assigned by the acquirer.
	AcquirerMerchantId string `json:"acquirer_merchant_id"`
	// MerchantName is the merchant name assigned by the acquirer.
	MerchantName string `json:"merchant_name"`
	// RequestorId is the requestor ID when required by the directory server.
	RequestorId *string `json:"requestor_id,omitempty"`
}

type AuthenticationChallengePreference struct {
	// Type is the challenge subtype preference.
	Type AuthenticationChallengePreferenceType `json:"type"`
}

type AuthenticationChallengePreferenceType string

type AuthenticationDirectoryServer string

type AuthenticationECI string

type AuthenticationFlowPreference struct {
	// Type is the preferred flow type: "challenge" or "frictionless".
	Type AuthenticationFlowPreferenceType `json:"type"`
	// Challenge captures details about a requested challenge flow.
	Challenge *AuthenticationChallengePreference `json:"challenge,omitempty"`
	// Frictionless captures details about a requested frictionless flow.
	Frictionless *AuthenticationFrictionlessPreference `json:"frictionless,omitempty"`
}

type AuthenticationFlowPreferenceType string

type AuthenticationFrictionlessPreference struct{}

type AuthenticationMetadata struct {
	// AcquirerDetails are details about the acquirer used for this 3DS Authentication.
	AcquirerDetails AuthenticationAcquirerDetails `json:"acquirer_details"`
	// DirectoryServer is the 3DS directory server used for this Authentication.
	DirectoryServer AuthenticationDirectoryServer `json:"directory_server"`
	// FlowPreference captures seller's preferred 3DS authentication flow, if any.
	FlowPreference *AuthenticationFlowPreference `json:"flow_preference,omitempty"`
}

type AuthenticationOutcome string

type AuthenticationOutcomeDetails struct {
	// ThreeDsCryptogram is 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"`
	// ElectronicCommerceIndicator is the ECI returned by the 3DS provider.
	ElectronicCommerceIndicator AuthenticationECI `json:"electronic_commerce_indicator"`
	// TransactionId is the 3DS transaction identifier (XID for 3DS1, dsTransID for 3DS2).
	TransactionId string `json:"transaction_id"`
	// Version is the 3D Secure version used for this authentication (for example "1.0.2" or "2.2.0").
	Version string `json:"version"`
}

type AuthenticationResult struct {
	// Outcome is the outcome of this 3DS Authentication.
	Outcome AuthenticationOutcome `json:"outcome"`
	// OutcomeDetails contains detailed authentication data.
	// Required when Outcome is authenticated, informational, or attempt_acknowledged.
	OutcomeDetails *AuthenticationOutcomeDetails `json:"outcome_details,omitempty"`
}

type Authenticator interface {
	Authenticate(ctx context.Context, apiKey string) error
}

type AuthenticatorFunc func(ctx context.Context, apiKey string) error

type AvailabilityStatus string

type AvailablePromotion struct {
	Code         string  `json:"code"`
	Description  string  `json:"description"`
	Requirements *string `json:"requirements,omitempty"`
}

type Buyer struct {
	Email                string                     `json:"email"`
	FirstName            *string                    `json:"first_name,omitempty"`
	LastName             *string                    `json:"last_name,omitempty"`
	FullName             *string                    `json:"full_name,omitempty"`
	PhoneNumber          *string                    `json:"phone_number,omitempty"`
	CustomerID           *string                    `json:"customer_id,omitempty"`
	AccountType          *BuyerAccountType          `json:"account_type,omitempty"`
	AuthenticationStatus *BuyerAuthenticationStatus `json:"authentication_status,omitempty"`
	Company              *CompanyInfo               `json:"company,omitempty"`
	Loyalty              *LoyaltyInfo               `json:"loyalty,omitempty"`
	TaxExemption         *TaxExemption              `json:"tax_exemption,omitempty"`
}

type BuyerAccountType string

type BuyerAuthenticationStatus string

type CancelSessionRequest struct {
	IntentTrace *IntentTrace `json:"intent_trace,omitempty"`
}

type CardChecksPerformed string

type CardFundingType string

type CardNumberType string

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

type CheckoutOrderStatus string

type CheckoutProvider interface {
	CreateSession(ctx context.Context, req CheckoutSessionCreateRequest) (*CheckoutSession, error)
	UpdateSession(ctx context.Context, id string, req CheckoutSessionUpdateRequest) (*CheckoutSession, error)
	GetSession(ctx context.Context, id string) (*CheckoutSession, error)
	CompleteSession(ctx context.Context, id string, req CheckoutSessionCompleteRequest) (*SessionWithOrder, error)
	CancelSession(ctx context.Context, id string, req *CancelSessionRequest) (*CheckoutSession, error)
}

type CheckoutSession struct {
	ID              string           `json:"id"`
	Protocol        *ProtocolVersion `json:"protocol,omitempty"`
	Buyer           *Buyer           `json:"buyer,omitempty"`
	PaymentProvider *PaymentProvider `json:"payment_provider,omitempty"`
	// Payment contains payment provider response data (if available).
	Payment  *PaymentResponse      `json:"payment,omitempty"`
	Status   CheckoutSessionStatus `json:"status"`
	Currency string                `json:"currency"`
	// PresentmentCurrency is the currency used for buyer-facing pricing.
	PresentmentCurrency *string `json:"presentment_currency,omitempty"`
	// ExchangeRate is the conversion rate from Currency to PresentmentCurrency.
	ExchangeRate *float64 `json:"exchange_rate,omitempty"`
	// ExchangeRateTimestamp is the time the exchange rate was captured.
	ExchangeRateTimestamp *time.Time          `json:"exchange_rate_timestamp,omitempty"`
	Locale                *string             `json:"locale,omitempty"`
	Timezone              *string             `json:"timezone,omitempty"`
	LineItems             []LineItem          `json:"line_items"`
	FulfillmentDetails    *FulfillmentDetails `json:"fulfillment_details,omitempty"`
	FulfillmentOptions    []FulfillmentOption `json:"fulfillment_options"`
	// SelectedFulfillmentOptions lists fulfillment choices by item group.
	SelectedFulfillmentOptions []SelectedFulfillmentOptions `json:"selected_fulfillment_options,omitempty"`
	// FulfillmentGroups allow splitting items across multiple destinations.
	FulfillmentGroups []FulfillmentGroup `json:"fulfillment_groups,omitempty"`
	Totals            []Total            `json:"totals"`
	Messages          []Message          `json:"messages"`
	Links             []Link             `json:"links"`
	// AuthenticationMetadata is seller-provided authentication metadata for 3DS flows.
	AuthenticationMetadata *AuthenticationMetadata `json:"authentication_metadata,omitempty"`
	// AvailablePromotions lists promotions applicable to the current cart.
	AvailablePromotions []AvailablePromotion `json:"available_promotions,omitempty"`
	CreatedAt           *time.Time           `json:"created_at,omitempty"`
	UpdatedAt           *time.Time           `json:"updated_at,omitempty"`
	ExpiresAt           *time.Time           `json:"expires_at,omitempty"`
	ContinueURL         *string              `json:"continue_url,omitempty"`
	Metadata            map[string]any       `json:"metadata,omitempty"`
	QuoteID             *string              `json:"quote_id,omitempty"`
	QuoteExpiresAt      *time.Time           `json:"quote_expires_at,omitempty"`
}

type CheckoutSessionCompleteRequest struct {
	Buyer       *Buyer      `json:"buyer,omitempty"`
	PaymentData PaymentData `json:"payment_data"`
	// AuthenticationResult is agent-provided 3DS authentication results for card payments.
	AuthenticationResult *AuthenticationResult `json:"authentication_result,omitempty"`
	// AffiliateAttribution contains optional attribution data for crediting third-party publishers.
	AffiliateAttribution *AffiliateAttribution `json:"affiliate_attribution,omitempty"`
	// RiskSignals captures client-provided signals for fraud analysis.
	RiskSignals *RiskSignals `json:"risk_signals,omitempty"`
}

type CheckoutSessionCreateRequest struct {
	Buyer *Buyer `json:"buyer,omitempty"`
	// LineItems is the list of requested items for the checkout session.
	LineItems []Item `json:"line_items"`
	// Currency is the ISO 4217 currency code for this checkout.
	Currency           string              `json:"currency"`
	FulfillmentDetails *FulfillmentDetails `json:"fulfillment_details,omitempty"`
	FulfillmentGroups  []FulfillmentGroup  `json:"fulfillment_groups,omitempty"`
	// AffiliateAttribution contains optional attribution data for crediting third-party publishers.
	AffiliateAttribution *AffiliateAttribution `json:"affiliate_attribution,omitempty"`
	Coupons              []string              `json:"coupons,omitempty"`
	Locale               *string               `json:"locale,omitempty"`
	Timezone             *string               `json:"timezone,omitempty"`
	QuoteID              *string               `json:"quote_id,omitempty"`
	Metadata             map[string]any        `json:"metadata,omitempty"`
}

type CheckoutSessionStatus string

type CheckoutSessionUpdateRequest struct {
	Buyer                      *Buyer                       `json:"buyer,omitempty"`
	LineItems                  *[]Item                      `json:"line_items,omitempty"`
	FulfillmentDetails         *FulfillmentDetails          `json:"fulfillment_details,omitempty"`
	FulfillmentGroups          []FulfillmentGroup           `json:"fulfillment_groups,omitempty"`
	SelectedFulfillmentOptions []SelectedFulfillmentOptions `json:"selected_fulfillment_options,omitempty"`
	Coupons                    []string                     `json:"coupons,omitempty"`
}

type CompanyInfo struct {
	Name       string  `json:"name"`
	TaxID      *string `json:"tax_id,omitempty"`
	Department *string `json:"department,omitempty"`
	CostCenter *string `json:"cost_center,omitempty"`
}

type CustomAttribute struct {
	DisplayName string `json:"display_name"`
	Value       string `json:"value"`
}

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

type DelegatedPaymentProvider interface {
	DelegatePayment(ctx context.Context, req PaymentRequest) (*VaultToken, error)
}

type DimensionsInfo struct {
	Length float64        `json:"length"`
	Width  float64        `json:"width"`
	Height float64        `json:"height"`
	Unit   DimensionsUnit `json:"unit"`
}

type DimensionsUnit string

type Disclosure struct {
	Type        DisclosureType        `json:"type"`
	ContentType DisclosureContentType `json:"content_type"`
	Content     string                `json:"content"`
}

type DisclosureContentType string

type DisclosureType string

type DiscountDetail struct {
	Code        *string               `json:"code,omitempty"`
	Type        DiscountDetailType    `json:"type"`
	Amount      int                   `json:"amount"`
	Description *string               `json:"description,omitempty"`
	Source      *DiscountDetailSource `json:"source,omitempty"`
}

type DiscountDetailSource string

type DiscountDetailType string

type Error struct {
	Type              ErrorType `json:"type"`
	Code              ErrorCode `json:"code"`
	Message           string    `json:"message"`
	Param             *string   `json:"param,omitempty"`
	SupportedVersions []string  `json:"supported_versions,omitempty"`

	Internal error `json:"-"`
	// contains filtered or unexported fields
}

type ErrorCode string

type ErrorType string

type EstimatedDelivery struct {
	Earliest time.Time `json:"earliest"`
	Latest   time.Time `json:"latest"`
}

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

type EventDataType string

type Fulfillment struct {
	// ID is the fulfillment identifier.
	ID string `json:"id"`
	// Type selects shipping, pickup, or digital delivery.
	Type FulfillmentType `json:"type"`
	// Status is the current fulfillment state.
	Status *FulfillmentStatus `json:"status,omitempty"`
	// LineItems lists included line items and quantities.
	LineItems []LineItemReference `json:"line_items,omitempty"`
	// Carrier is the shipping carrier name for shipping fulfillments.
	Carrier *string `json:"carrier,omitempty"`
	// TrackingNumber is the carrier tracking number for shipping fulfillments.
	TrackingNumber *string `json:"tracking_number,omitempty"`
	// TrackingURL is the external tracking URL for shipping fulfillments.
	TrackingURL *string `json:"tracking_url,omitempty"`
	// Destination is the destination address when applicable.
	Destination *Address `json:"destination,omitempty"`
	// EstimatedDelivery is the expected delivery window.
	EstimatedDelivery *EstimatedDelivery `json:"estimated_delivery,omitempty"`
	// DigitalDelivery contains digital access credentials/links.
	DigitalDelivery *FulfillmentDigitalDelivery `json:"digital_delivery,omitempty"`
	// Description is optional human-readable fulfillment context.
	Description *string `json:"description,omitempty"`
	// Events is an append-only progress log.
	Events []FulfillmentEvent `json:"events,omitempty"`
}

type FulfillmentDeliveryWindow struct {
	Start time.Time `json:"start"`
	End   time.Time `json:"end"`
}

type FulfillmentDetails struct {
	Name        *string  `json:"name,omitempty"`
	PhoneNumber *string  `json:"phone_number,omitempty"`
	Email       *string  `json:"email,omitempty"`
	Address     *Address `json:"address,omitempty"`
}

type FulfillmentDigitalDelivery struct {
	// AccessURL is the URL where the buyer can access the digital content.
	AccessURL *string `json:"access_url,omitempty"`
	// LicenseKey is an activation/license key when applicable.
	LicenseKey *string `json:"license_key,omitempty"`
	// ExpiresAt is the RFC3339 timestamp after which access expires.
	ExpiresAt *time.Time `json:"expires_at,omitempty"`
}

type FulfillmentEvent struct {
	// ID is the event identifier.
	ID string `json:"id"`
	// Type is the event type.
	Type FulfillmentEventType `json:"type"`
	// OccurredAt is the RFC3339 timestamp when the event occurred.
	OccurredAt time.Time `json:"occurred_at"`
	// Description is optional human-readable event detail.
	Description *string `json:"description,omitempty"`
	// Location is the optional location of the event.
	Location *string `json:"location,omitempty"`
}

type FulfillmentEventType string

type FulfillmentGroup struct {
	ID                 string                `json:"id"`
	ItemIDs            []string              `json:"item_ids"`
	DestinationType    FulfillmentOptionType `json:"destination_type"`
	FulfillmentDetails *FulfillmentDetails   `json:"fulfillment_details,omitempty"`
	LocationID         *string               `json:"location_id,omitempty"`
	Instructions       *string               `json:"instructions,omitempty"`
}

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

type FulfillmentOptionDigital struct {
	ID          string  `json:"id"`
	Title       string  `json:"title"`
	Description *string `json:"description,omitempty"`
	Totals      []Total `json:"totals"`
	Type        string  `json:"type"`
}

type FulfillmentOptionLocalDelivery struct {
	Type           string                     `json:"type"`
	ID             string                     `json:"id"`
	Title          string                     `json:"title"`
	Description    *string                    `json:"description,omitempty"`
	DeliveryWindow *FulfillmentDeliveryWindow `json:"delivery_window,omitempty"`
	ServiceArea    *FulfillmentServiceArea    `json:"service_area,omitempty"`
	Totals         []Total                    `json:"totals"`
}

type FulfillmentOptionPickup struct {
	Type        string                    `json:"type"`
	ID          string                    `json:"id"`
	Title       string                    `json:"title"`
	Description *string                   `json:"description,omitempty"`
	Location    FulfillmentPickupLocation `json:"location"`
	PickupType  *FulfillmentPickupType    `json:"pickup_type,omitempty"`
	ReadyBy     *time.Time                `json:"ready_by,omitempty"`
	PickupBy    *time.Time                `json:"pickup_by,omitempty"`
	Totals      []Total                   `json:"totals"`
}

type FulfillmentOptionShipping struct {
	ID                   string     `json:"id"`
	Title                string     `json:"title"`
	Description          *string    `json:"description,omitempty"`
	Carrier              *string    `json:"carrier,omitempty"`
	EarliestDeliveryTime *time.Time `json:"earliest_delivery_time,omitempty"`
	LatestDeliveryTime   *time.Time `json:"latest_delivery_time,omitempty"`
	Totals               []Total    `json:"totals"`
	Type                 string     `json:"type"`
}

type FulfillmentOptionType string

type FulfillmentPickupLocation struct {
	Name         string  `json:"name"`
	Address      Address `json:"address"`
	Phone        *string `json:"phone,omitempty"`
	Instructions *string `json:"instructions,omitempty"`
}

type FulfillmentPickupType string

type FulfillmentServiceArea struct {
	RadiusMiles      *float64 `json:"radius_miles,omitempty"`
	CenterPostalCode *string  `json:"center_postal_code,omitempty"`
}

type FulfillmentStatus string

type FulfillmentType string

type GiftWrap struct {
	Enabled bool    `json:"enabled"`
	Style   *string `json:"style,omitempty"`
	Charge  *int    `json:"charge,omitempty"`
}

type IntentTrace struct {
	ReasonCode   IntentTraceReasonCode `json:"reason_code"`
	TraceSummary *string               `json:"trace_summary,omitempty"`
	Metadata     map[string]any        `json:"metadata,omitempty"`
}

type IntentTraceReasonCode string

type Item struct {
	ID         string  `json:"id"`
	Name       *string `json:"name,omitempty"`
	UnitAmount *int    `json:"unit_amount,omitempty"`
}

type LineItem struct {
	ID                       string                    `json:"id"`
	Item                     Item                      `json:"item"`
	Quantity                 int                       `json:"quantity"`
	Name                     *string                   `json:"name,omitempty"`
	Description              *string                   `json:"description,omitempty"`
	Images                   []string                  `json:"images,omitempty"`
	UnitAmount               *int                      `json:"unit_amount,omitempty"`
	Disclosures              []Disclosure              `json:"disclosures,omitempty"`
	CustomAttributes         []CustomAttribute         `json:"custom_attributes,omitempty"`
	MarketplaceSellerDetails *MarketplaceSellerDetails `json:"marketplace_seller_details,omitempty"`
	ProductID                *string                   `json:"product_id,omitempty"`
	SKU                      *string                   `json:"sku,omitempty"`
	VariantID                *string                   `json:"variant_id,omitempty"`
	Category                 *string                   `json:"category,omitempty"`
	Tags                     []string                  `json:"tags,omitempty"`
	Weight                   *WeightInfo               `json:"weight,omitempty"`
	Dimensions               *DimensionsInfo           `json:"dimensions,omitempty"`
	AvailabilityStatus       *AvailabilityStatus       `json:"availability_status,omitempty"`
	AvailableQuantity        *int                      `json:"available_quantity,omitempty"`
	MaxQuantityPerOrder      *int                      `json:"max_quantity_per_order,omitempty"`
	FulfillableOn            *time.Time                `json:"fulfillable_on,omitempty"`
	VariantOptions           []VariantOption           `json:"variant_options,omitempty"`
	DiscountDetails          []DiscountDetail          `json:"discount_details,omitempty"`
	TaxExempt                *bool                     `json:"tax_exempt,omitempty"`
	TaxExemptionReason       *string                   `json:"tax_exemption_reason,omitempty"`
	ParentID                 *string                   `json:"parent_id,omitempty"`
	// Totals contains the line-item totals breakdown including base_amount, discount, subtotal, tax, and total.
	Totals []Total `json:"totals"`
}

type LineItemReference struct {
	// ID references an OrderLineItem.ID.
	ID string `json:"id"`
	// Quantity is the affected quantity for this reference.
	Quantity int `json:"quantity"`
}

type Link struct {
	Type  LinkType `json:"type"`
	Title *string  `json:"title,omitempty"`
	Url   string   `json:"url"`
}

type LinkType string

type LoyaltyInfo struct {
	Tier          *string    `json:"tier,omitempty"`
	PointsBalance *int       `json:"points_balance,omitempty"`
	MemberSince   *time.Time `json:"member_since,omitempty"`
}

type MarketplaceSellerDetails struct {
	Name string `json:"name"`
}

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

type MessageError struct {
	Code        MessageErrorCode        `json:"code"`
	Content     string                  `json:"content"`
	ContentType MessageErrorContentType `json:"content_type"`
	Severity    *MessageSeverity        `json:"severity,omitempty"`
	Resolution  *MessageResolution      `json:"resolution,omitempty"`
	Param       *string                 `json:"param,omitempty"`
	Type        string                  `json:"type"`
}

type MessageErrorCode string

type MessageErrorContentType string

type MessageInfo struct {
	Content     string                 `json:"content"`
	ContentType MessageInfoContentType `json:"content_type"`
	Severity    *MessageSeverity       `json:"severity,omitempty"`
	Resolution  *MessageResolution     `json:"resolution,omitempty"`

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

type MessageInfoContentType string

type MessageResolution string

type MessageSeverity string

type MessageWarning struct {
	Code        MessageWarningCode     `json:"code"`
	Content     string                 `json:"content"`
	ContentType MessageInfoContentType `json:"content_type"`
	Severity    *MessageSeverity       `json:"severity,omitempty"`
	Resolution  *MessageResolution     `json:"resolution,omitempty"`
	// Param RFC 9535 JSONPath
	Param *string `json:"param,omitempty"`
	Type  string  `json:"type"`
}

type MessageWarningCode string

type Middleware func(http.HandlerFunc) http.HandlerFunc

type Option func(*config)

type Order struct {
	// Type is the discriminator for webhook payloads when present.
	Type *EventDataType `json:"type,omitempty"`
	// ID is the order identifier.
	ID string `json:"id"`
	// CheckoutSessionId identifies the checkout session used to create this order.
	CheckoutSessionId string `json:"checkout_session_id"`
	// OrderNumber is a human-readable order reference.
	OrderNumber *string `json:"order_number,omitempty"`
	// PermalinkUrl is the buyer-facing URL to view order details.
	PermalinkUrl string `json:"permalink_url"`
	// Status is the order-level lifecycle state.
	Status *CheckoutOrderStatus `json:"status,omitempty"`
	// EstimatedDelivery is the expected delivery window for this order.
	EstimatedDelivery *EstimatedDelivery `json:"estimated_delivery,omitempty"`
	// Confirmation contains confirmation metadata such as receipt URL.
	Confirmation *OrderConfirmation `json:"confirmation,omitempty"`
	// Support contains merchant support contact details for this order.
	Support *SupportInfo `json:"support,omitempty"`
	// LineItems tracks ordered items and fulfillment progress.
	LineItems []OrderLineItem `json:"line_items,omitempty"`
	// Fulfillments tracks shipping, pickup, and digital delivery.
	Fulfillments []Fulfillment `json:"fulfillments,omitempty"`
	// Adjustments tracks post-order changes like refunds/returns/disputes.
	Adjustments []Adjustment `json:"adjustments,omitempty"`
	// Totals captures order-level financial breakdown, including amount_refunded.
	Totals []Total `json:"totals,omitempty"`
}

type OrderConfirmation struct {
	ConfirmationNumber    *string `json:"confirmation_number,omitempty"`
	ConfirmationEmailSent *bool   `json:"confirmation_email_sent,omitempty"`
	ReceiptURL            *string `json:"receipt_url,omitempty"`
	InvoiceNumber         *string `json:"invoice_number,omitempty"`
}

type OrderCreate struct {
	// Type is the webhook payload discriminator and is always "order".
	Type EventDataType `json:"type"`
	// ID is the order identifier.
	ID *string `json:"id,omitempty"`
	// CheckoutSessionID identifies the checkout session that produced this order.
	CheckoutSessionID string `json:"checkout_session_id"`
	// OrderNumber is a human-readable order reference.
	OrderNumber *string `json:"order_number,omitempty"`
	// PermalinkURL is the buyer-facing order URL.
	PermalinkURL string `json:"permalink_url"`
	// Status is the order lifecycle state at event emission time.
	Status OrderStatus `json:"status"`
	// EstimatedDelivery is the expected delivery window.
	EstimatedDelivery *EstimatedDelivery `json:"estimated_delivery,omitempty"`
	// Confirmation contains receipt and confirmation metadata.
	Confirmation *OrderConfirmation `json:"confirmation,omitempty"`
	// Support contains merchant support contact details.
	Support *SupportInfo `json:"support,omitempty"`
	// LineItems describes ordered items and item-level fulfillment progress.
	LineItems []OrderLineItem `json:"line_items,omitempty"`
	// Fulfillments describes shipping/pickup/digital delivery state.
	Fulfillments []Fulfillment `json:"fulfillments,omitempty"`
	// Adjustments describes refunds, credits, returns, and disputes.
	Adjustments []Adjustment `json:"adjustments,omitempty"`
	// Totals is an order-level totals breakdown.
	Totals []Total `json:"totals,omitempty"`
}

type OrderLineItem struct {
	// ID is the line item identifier for references in fulfillments/adjustments.
	ID string `json:"id"`
	// Title is the product name.
	Title string `json:"title"`
	// ProductID is the merchant catalog product identifier.
	ProductID *string `json:"product_id,omitempty"`
	// Description is the product description.
	Description *string `json:"description,omitempty"`
	// ImageURL is the product image URL.
	ImageURL *string `json:"image_url,omitempty"`
	// URL is the product page URL.
	URL *string `json:"url,omitempty"`
	// Quantity tracks ordered vs shipped units.
	Quantity OrderLineItemQuantity `json:"quantity"`
	// UnitPrice is the price per unit in minor currency units.
	UnitPrice *int `json:"unit_price,omitempty"`
	// Subtotal is quantity.ordered * unit_price in minor currency units.
	Subtotal *int `json:"subtotal,omitempty"`
	// Totals is the optional line-item totals breakdown.
	Totals []Total `json:"totals,omitempty"`
	// Status is the current fulfillment state for this line item.
	Status *OrderLineItemStatus `json:"status,omitempty"`
}

type OrderLineItemQuantity struct {
	// Ordered is the quantity originally purchased.
	Ordered int `json:"ordered"`
	// Shipped is the quantity handed to carrier/fulfilled so far.
	Shipped *int `json:"shipped,omitempty"`
}

type OrderLineItemStatus string

type OrderStatus = CheckoutOrderStatus

type OrderUpdated struct {
	// Type is the webhook payload discriminator and is always "order".
	Type EventDataType `json:"type"`
	// ID is the order identifier.
	ID *string `json:"id,omitempty"`
	// CheckoutSessionID identifies the checkout session that produced this order.
	CheckoutSessionID string `json:"checkout_session_id"`
	// OrderNumber is a human-readable order reference.
	OrderNumber *string `json:"order_number,omitempty"`
	// PermalinkURL is the buyer-facing order URL.
	PermalinkURL string `json:"permalink_url"`
	// Status is the order lifecycle state at event emission time.
	Status OrderStatus `json:"status"`
	// EstimatedDelivery is the expected delivery window.
	EstimatedDelivery *EstimatedDelivery `json:"estimated_delivery,omitempty"`
	// Confirmation contains receipt and confirmation metadata.
	Confirmation *OrderConfirmation `json:"confirmation,omitempty"`
	// Support contains merchant support contact details.
	Support *SupportInfo `json:"support,omitempty"`
	// LineItems describes ordered items and item-level fulfillment progress.
	LineItems []OrderLineItem `json:"line_items,omitempty"`
	// Fulfillments describes shipping/pickup/digital delivery state.
	Fulfillments []Fulfillment `json:"fulfillments,omitempty"`
	// Adjustments describes refunds, credits, returns, and disputes.
	Adjustments []Adjustment `json:"adjustments,omitempty"`
	// Totals is an order-level totals breakdown.
	Totals []Total `json:"totals,omitempty"`
}

type PaymentCardNetwork string

type PaymentCredential struct {
	// Type is the credential type (for example "spt" or "wallet_token").
	Type string `json:"type"`
	// Token is the opaque credential/token value.
	Token string `json:"token"`
}

type PaymentData struct {
	// HandlerID identifies which advertised payment handler to use.
	HandlerID *string `json:"handler_id,omitempty"`
	// Instrument carries handler-specific payment instrument details.
	Instrument *PaymentInstrument `json:"instrument,omitempty"`
	// Deprecated: prefer handler_id + instrument for ACP payment handlers.
	// Token is a provider-issued payment token (required with Provider).
	Token *string `json:"token,omitempty"`
	// Deprecated: prefer handler_id + instrument for ACP payment handlers.
	// Provider identifies the payment provider that issued Token.
	Provider       *PaymentDataProvider `json:"provider,omitempty"`
	BillingAddress *Address             `json:"billing_address,omitempty"`
	// PurchaseOrderNumber enables non-tokenized payment flows (B2B).
	PurchaseOrderNumber *string `json:"purchase_order_number,omitempty"`
	// PaymentTerms specify invoice payment terms (for example "net_30").
	PaymentTerms *PaymentTerms `json:"payment_terms,omitempty"`
	// DueDate is the payment due date for invoice flows.
	DueDate *time.Time `json:"due_date,omitempty"`
	// ApprovalRequired signals whether buyer approval is required before payment capture.
	ApprovalRequired *bool `json:"approval_required,omitempty"`
}

type PaymentDataProvider string

type PaymentInstrument struct {
	// Type is the instrument type (for example "card" or "wallet_token").
	Type string `json:"type"`
	// Credential carries the credential required by the selected handler.
	Credential PaymentCredential `json:"credential"`
}

type PaymentMethod struct {
	SupportedCardNetworks []PaymentCardNetwork `json:"supported_card_networks,omitempty"`
	Type                  PaymentMethodType    `json:"type"`
}

type PaymentMethodCard struct {
	// The type of payment method used. Currently only card.
	Type PaymentMethodCardType `json:"type" validate:"required,eq=card"`
	// The type of card number. Network tokens are preferred with fallback to FPAN. See [PCI Scope] for more details.
	//
	// [PCI Scope]: https://developers.openai.com/commerce/guides/production#security-and-compliance
	CardNumberType CardNumberType `json:"card_number_type" validate:"required,oneof=fpan network_token"`
	// Card number.
	Number secret.Secret[string] `json:"number" validate:"required"`
	// Expiry month.
	ExpMonth *string `json:"exp_month,omitempty" validate:"omitempty,len=2,numeric"`
	// Expiry year.
	ExpYear *string `json:"exp_year,omitempty" validate:"omitempty,len=4,numeric"`
	// Cardholder name.
	Name *string `json:"name,omitempty"`
	// Card CVC number.
	CVC *string `json:"cvc,omitempty" validate:"omitempty,numeric"`
	// In case of non-PAN, this is the original last 4 digits of the card for customer display.
	DisplayLast4 *string `json:"display_last4,omitempty" validate:"omitempty,len=4"`
	// Funding type of the card to display.
	DisplayCardFundingType CardFundingType `json:"display_card_funding_type" validate:"required,oneof=credit debit prepaid"`
	// Brand of the card to display.
	//
	// Exapmple: "Visa", "amex", "discover"
	DisplayBrand *string `json:"display_brand,omitempty"`
	// If the card came via a digital wallet, what type of wallet.
	DisplayWalletType *string `json:"display_wallet_type,omitempty"`
	// Institution Identification Number (aka BIN). The first 6-8 digits on a card identifying the issuer.
	IIN *string `json:"iin,omitempty" validate:"omitempty,max=8"`
	// Cryptogram provided with network tokens.
	Cryptogram *string `json:"cryptogram,omitempty"`
	// Electronic Commerce Indicator / Security Level Indicator provided with network tokens.
	ECIValue *string `json:"eci_value,omitempty"`
	// Checks already performed on the card.
	ChecksPerformed []CardChecksPerformed `json:"checks_performed,omitempty" validate:"omitempty,dive,required"`
	// Arbitrary key/value pairs.
	Metadata map[string]string `json:"metadata" validate:"required,map_present"`
}

type PaymentMethodCardType string

type PaymentMethodType string

type PaymentProvider struct {
	Provider                PaymentProviderProvider `json:"provider"`
	SupportedPaymentMethods []PaymentMethod         `json:"supported_payment_methods"`
}

type PaymentProviderProvider string

type PaymentRequest struct {
	// Type of credential. The only accepted value is "CARD".
	PaymentMethod PaymentMethodCard `json:"payment_method" validate:"required"`
	// Use cases that the stored credential can be applied to.
	Allowance Allowance `json:"allowance" validate:"required"`
	// Address associated with the payment method.
	BillingAddress *Address `json:"billing_address,omitempty" validate:"omitempty"`
	// Arbitrary key/value pairs.
	Metadata map[string]string `json:"metadata" validate:"required,map_present"`
	// List of risk signals.
	RiskSignals []RiskSignal `json:"risk_signals" validate:"required,min=1,dive"`
}

type PaymentResponse struct {
	Provider    *string          `json:"provider,omitempty"`
	Instruments []map[string]any `json:"instruments,omitempty"`
	Handlers    []map[string]any `json:"handlers,omitempty"`
}

type PaymentTerms string

type ProtocolVersion struct {
	Version      string   `json:"version"`
	Capabilities []string `json:"capabilities,omitempty"`
}

type RequestContext struct {
	// API Key used to make requests
	//
	// Example: Bearer api_key_123
	Authorization string
	// The preferred locale for content like messages and errors
	//
	// Example: en-US
	AcceptLanguage string
	// Information about the client making this request
	//
	// Example: ChatGPT/2.0 (Mac OS X 15.0.1; arm64; build 0)
	UserAgent string
	// Key used to ensure requests are idempotent
	//
	// Example: idempotency_key_123
	IdempotencyKey string
	// Unique key for each request for tracing purposes
	//
	// Example: request_id_123
	RequestID string
	// Base64 encoded signature of the request body
	//
	// Example: eyJtZX...
	Signature string
	// Formatted as an RFC 3339 string.
	//
	// Example: 2025-09-25T10:30:00Z
	Timestamp string
	// API version
	//
	// Example: 2026-01-30
	APIVersion string
}

type RiskSignal struct {
	// The type of risk signal.
	Type RiskSignalType `json:"type" validate:"required,oneof=card_testing"`
	// Action taken.
	Action RiskSignalAction `json:"action" validate:"required,oneof=manual_review authorized blocked"`
	// Details of the risk signal.
	Score int `json:"score" validate:"gte=0"`
}

type RiskSignalAction string

type RiskSignalType string

type RiskSignals struct {
	IPAddress         *string `json:"ip_address,omitempty"`
	UserAgent         *string `json:"user_agent,omitempty"`
	AcceptLanguage    *string `json:"accept_language,omitempty"`
	SessionID         *string `json:"session_id,omitempty"`
	DeviceFingerprint *string `json:"device_fingerprint,omitempty"`
}

type SelectedFulfillmentOptions struct {
	Type     FulfillmentOptionType `json:"type"`
	OptionID string                `json:"option_id"`
	ItemIDs  []string              `json:"item_ids"`
}

type SessionWithOrder struct {
	CheckoutSession
	Order Order `json:"order"`
}

type SplitPayment struct {
	Amount int `json:"amount"`
}

type SupportInfo struct {
	Email         *string `json:"email,omitempty"`
	Phone         *string `json:"phone,omitempty"`
	Hours         *string `json:"hours,omitempty"`
	HelpCenterURL *string `json:"help_center_url,omitempty"`
}

type TaxBreakdownItem struct {
	Jurisdiction string  `json:"jurisdiction"`
	Rate         float64 `json:"rate"`
	Amount       int     `json:"amount"`
}

type TaxExemption struct {
	CertificateID   string     `json:"certificate_id"`
	CertificateType string     `json:"certificate_type"`
	ExemptRegions   []string   `json:"exempt_regions,omitempty"`
	ExpiresAt       *time.Time `json:"expires_at,omitempty"`
}

type Total struct {
	Amount            int                `json:"amount"`
	PresentmentAmount *int               `json:"presentment_amount,omitempty"`
	Description       *string            `json:"description,omitempty"`
	DisplayText       string             `json:"display_text"`
	Type              TotalType          `json:"type"`
	Breakdown         []TaxBreakdownItem `json:"breakdown,omitempty"`
}

type TotalType string

type VariantOption struct {
	Name  string `json:"name"`
	Value string `json:"value"`
}

type VaultToken struct {
	// Unique vault token identifier vt_….
	ID string `json:"id" validate:"required"`
	// Time formatted as an RFC 3339 string.
	Created time.Time `json:"created" validate:"required"`
	// Arbitrary key/value pairs for correlation (e.g., source, merchant_id, idempotency_key).
	Metadata map[string]string `json:"metadata" validate:"omitempty"`
}

type WebhookEventType string

type WebhookOption func(*webhookSender)

type WebhookSender interface {
	// Send sends webhook to the configured webhook endpoint.
	Send(context.Context, EventData) error
}

type WeightInfo struct {
	Value float64    `json:"value"`
	Unit  WeightUnit `json:"unit"`
}

type WeightUnit string