@paynow-gg/typescript-sdk 2.1.1 → 2.1.3

package/dist/cjs/generated/management/types.d.ts

@@ -363,7 +363,7 @@ export type BanType = "unknown" | "steam" | "ip" | "customer" | "customer_name"
 /**
  * Query parameters
  */
-export type BillingGetStoreInvoicesQuery = {
+export type BillingGetStoreBillingOrdersQuery = {
     /**
      * The maximum number of items to return in a single request.
      * @format int32
@@ -2971,15 +2971,6 @@ export type InvoicesListInvoicesQuery = {
 };
 export type InvoiceStatusDto = "invalid" | "pending" | "generated" | "failed";
 export type InvoiceTypeDto = "invalid" | "invoice" | "credit_note";
-/**
- * Represents a freshly issued link to a hosted invoice.
- */
-export interface InvoiceUrlDto {
-    /**
-     * The hosted invoice URL.
-     */
-    url: string;
-}
 /**
  * Klarna payment method details
  */
@@ -4168,6 +4159,16 @@ export interface PaymentMethodTypeFeeOverrideDto {
      */
     ends_at?: string | null;
 }
+/**
+ * A customer portal session scoped to updating the payment method of the store's
+ * active subscription.
+ */
+export interface PaymentMethodUpdateSessionDto {
+    /**
+     * The URL the store owner has to visit to update the subscription's payment method.
+     */
+    session_url: string;
+}
 /**
  * Represents payout split results for multi-party payments
  */
@@ -4424,6 +4425,7 @@ export interface PlanDto {
     name: string;
     description?: string | null;
     is_custom: boolean;
+    inherits_from_plan_id?: string | null;
 }
 /**
  * Represents a publicly listed plan a store can subscribe to.
@@ -4488,6 +4490,7 @@ export interface PlanPricingDto {
      * @format date-time
      */
     ends_at?: string | null;
+    revenue_limit_exceeded?: boolean | null;
 }
 export type PlatformCapability = "invalid" | "connected_users";
 export interface PlatformStoreTypeAssociationDetailsDto {
@@ -5668,14 +5671,29 @@ export interface SetDiscordActionDto {
     role_id?: FlakeId;
     message?: string | null;
 }
+/**
+ * Represents a request to attach a custom domain to a webstore.
+ */
 export interface SetWebstoreCustomDomainRequestDto {
+    /**
+     * The domain to serve the webstore from, without a scheme (e.g., store.example.com).
+     */
     domain: string;
     verification_type: WebstoreCustomDomainVerificationTypeDto;
 }
+/**
+ * Represents a request to set the template a webstore renders.
+ */
 export interface SetWebstoreDefaultTemplateRequestDto {
     template_id: FlakeId;
 }
+/**
+ * Represents a request to change the slug a webstore is served from.
+ */
 export interface SetWebstoreSlugRequestDto {
+    /**
+     * The new slug to serve the webstore from. Slugs are unique across all webstores.
+     */
     slug: string;
 }
 export interface StartDataMigrationFromTebexRequestDto {
@@ -5813,11 +5831,11 @@ export interface StoreBillingStatusDto {
     revenue_usage: number;
     plan_limits: Record<string, number>;
     feature_flags: Array<string>;
+    alerts: Array<StoreAlertDto>;
     plan: PlanDto;
     plan_pricing: PlanPricingDto;
     subscription?: StoreSubscriptionDto;
-    alerts: Array<StoreAlertDto>;
-    payment_method?: SubscriptionPaymentMethodDto;
+    payment_method?: PaymentMethodDto;
 }
 /**
  * Query parameters
@@ -5913,195 +5931,561 @@ export interface StoreDto {
     platform_store_type_association?: PlatformStoreTypeAssociationDetailsDto;
 }
 /**
- * Represents a store entity within the storefront system.
+ * A storefront representation of a customer in the PayNow system with their associated profiles and metadata.
  */
-export interface StorefrontStoreDto {
+export interface StorefrontCustomerDto {
     id: FlakeId;
+    store_id: FlakeId;
+    profile?: CustomerGenericProfileDto;
+    steam_id?: SteamId;
+    steam?: StorefrontCustomerSteamProfileDto;
     /**
-     * The URL-friendly identifier for the store, used in store URLs.
-     * @example "m0ukas-awesome-store"
+     * The customer's Minecraft UUID, if they have linked their Minecraft account.
+     * Not set for offline Minecraft stores. If the platform type is Minecraft - Geyser,
+     * and the profile is a bedrock account, this will be a UUID generated from the Xbox XUID.
+     * @example "f84c6a79-0a4e-45e0-879b-cd49ebd4c4e2"
      */
-    slug: string;
+    minecraft_uuid?: string | null;
+    minecraft?: StorefrontCustomerMinecraftProfileDto;
+    minecraft_platform?: CustomerMinecraftPlatform;
     /**
-     * The display name of the store shown to customers.
-     * @example "m0uka's awesome store"
+     * The customer's Xbox XUID, if available.
      */
-    name: string;
+    xbox_xuid?: string | null;
     /**
-     * The platform or the game of the store.
-     * @example "rust"
+     * The display name for the customer.
+     * @example "m0uka"
      */
-    platform: string;
+    name?: string | null;
+}
+/**
+ * A storefront representation of a customers Minecraft profile.
+ */
+export interface StorefrontCustomerMinecraftProfileDto {
     /**
-     * The game of the store. Equivalent to the `platform` for backwards compatibility.
-     * @readonly Set by the API; ignored on write.
+     * The UUID of the Minecraft player.
+     * If the platform is Minecraft Offline, this will be the name itself.
+     * If the platform is Minecraft Geyser, and this is a Bedrock account, this ID will be an Xbox XUID.
+     * @example "f84c6a79-0a4e-45e0-879b-cd49ebd4c4e2"
      */
-    game: string;
+    id: string;
     /**
-     * The three-letter ISO currency code used for pricing in this store.
-     * If using the Adaptive Currency feature, this will be updated to reflect customer's local currency
-     * (based on passed in IP / country headers).
-     * @example "eur"
+     * The username of the Minecraft player.
+     * @example "notch"
      */
-    currency: string;
+    name: string;
     /**
-     * The three-letter ISO currency code signifying the main currency of the store.
-     * @example "usd"
+     * The URL to the player's Minecraft skin rendered as an avatar.
      */
-    creator_currency: string;
+    avatar_url: string;
+}
+/**
+ * A storefront representation of a customers Steam profile.
+ */
+export interface StorefrontCustomerSteamProfileDto {
+    id: SteamId;
     /**
-     * A detailed description of the store. Only present for some platform types.
+     * The display name of the user on Steam.
      */
-    description?: string | null;
+    name: string;
     /**
-     * The URL of the store's main website, if not using Hosted Webstores.
+     * The URL to the user's Steam avatar image.
      */
-    website_url?: string | null;
+    avatar_url: string;
+}
+/**
+ * Data transfer object representing a store order.
+ */
+export interface StorefrontOrderDto {
+    id: FlakeId;
     /**
-     * The email address customers can use to contact store support.
-     * @example "support@example.com"
+     * Human-readable identifier for the order.
+     * @readonly Set by the API; ignored on write.
      */
-    support_email?: string | null;
+    pretty_id: string;
+    store_id: FlakeId;
+    customer_id: FlakeId;
+    customer: StorefrontCustomerDto;
+    status: OrderStatus;
+    type: OrderType;
+    checkout_id?: FlakeId;
+    subscription_id?: FlakeId;
     /**
-     * The URL of the store's support page.
+     * Indicates whether this order is a subscription order.
      */
-    support_url?: string | null;
+    is_subscription: boolean;
     /**
-     * The type of integration this store uses with external systems.
+     * Currency code used for this order.
      */
-    integration_type?: string | null;
+    currency: string;
     /**
-     * Indicates whether the store is in live mode (true) or test mode (false).
+     * The total discount amount applied to this order in smallest currency unit
+     * @format int32
+     * @example 500
      */
-    live_mode: boolean;
+    discount_amount: number;
     /**
-     * The URL to the store's main logo image.
+     * The discount amount formatted as a string
+     * @example "$5.00"
      */
-    logo_url?: string | null;
+    discount_amount_str: string;
     /**
-     * The URL to the store's square logo image.
+     * The subtotal amount for this order in smallest currency unit
+     * @format int32
+     * @example 9995
      */
-    logo_square_url?: string | null;
+    subtotal_amount: number;
     /**
-     * The date and time when the store was created.
-     * @format date-time
+     * The subtotal amount formatted as a string
+     * @example "$99.95"
      */
-    created_at?: string | null;
+    subtotal_amount_str: string;
     /**
-     * The date and time when the store was last updated.
-     * @format date-time
+     * The tax amount for this order in smallest currency unit
+     * @format int32
+     * @example 999
      */
-    updated_at?: string | null;
-}
-/**
- * Represents an invoice raised against a store's own subscription.
- */
-export interface StoreInvoiceDto {
-    id: FlakeId;
-    subscription_id: FlakeId;
-    plan_pricing_id: FlakeId;
+    tax_amount: number;
     /**
-     * The payment gateway that issued the invoice.
+     * The tax amount formatted as a string
+     * @example "$9.99"
      */
-    gateway: string;
+    tax_amount_str: string;
     /**
-     * The identifier of the invoice within the payment gateway.
+     * The total amount for this order in smallest currency unit
+     * @format int32
+     * @example 10494
      */
-    gateway_invoice_id: string;
+    total_amount: number;
     /**
-     * The hosted invoice URL recorded when the invoice was raised. May expire; request
-     * 'invoices/{invoice_id}/url' for a freshly issued link.
+     * The total amount formatted as a string
+     * @example "$104.94"
      */
-    invoice_url: string;
+    total_amount_str: string;
     /**
-     * The description of what was billed.
+     * The amount of gift card value used for this order in smallest currency unit
+     * @format int32
+     * @example 0
      */
-    description: string;
+    giftcard_usage_amount: number;
     /**
-     * The currency the invoice was issued in.
+     * The gift card usage amount formatted as a string
+     * @example "$0.00"
      */
-    currency: string;
+    giftcard_usage_amount_str: string;
     /**
-     * The invoiced total, in the smallest currency unit.
-     * @format int64
+     * The presentment currency code used for this order (currency shown to customer)
+     * @example "eur"
      */
-    total: number;
+    presentment_currency: string;
     /**
-     * Whether the invoice has been paid.
+     * The presentment subtotal amount in smallest currency unit
+     * @format int32
+     * @example 9995
      */
-    is_paid: boolean;
+    presentment_subtotal_amount: number;
     /**
-     * When the invoice was raised.
-     * @format date-time
+     * The presentment subtotal amount formatted as a string
+     * @example "€99.95"
+     * @readonly Set by the API; ignored on write.
      */
-    created_at: string;
+    presentment_subtotal_amount_str: string;
     /**
-     * When the invoice was last updated.
-     * @format date-time
+     * The presentment discount amount in smallest currency unit
+     * @format int32
+     * @example 500
      */
-    updated_at?: string | null;
-}
-/**
- * Represents a member of a PayNow store.
- */
-export interface StoreMemberDto {
-    id: FlakeId;
-    user_id: FlakeId;
-    user: StoreMemberUserDto;
+    presentment_discount_amount: number;
     /**
-     * The UTC timestamp when the member was added to the store.
-     * @format date-time
+     * The presentment discount amount formatted as a string
+     * @example "€5.00"
+     * @readonly Set by the API; ignored on write.
      */
-    added_at?: string | null;
-    added_by?: ActorDto;
-    role_id?: FlakeId;
-}
-/**
- * Represents identity and profile information for a store member.
- */
-export interface StoreMemberUserDto {
-    type: PayNowActorType;
-    id: FlakeId;
+    presentment_discount_amount_str: string;
     /**
-     * The email address associated with the user.
-     * Only visible if you are the store owner.
+     * The presentment gift card usage amount in the smallest currency unit
+     * @format int32
+     * @example 0
      */
-    email?: string | null;
+    presentment_giftcard_usage_amount: number;
     /**
-     * The first name of the actor.
-     * Hidden if the user has a set nickname, and you are not the store owner.
+     * The presentment gift card usage amount formatted as a string
+     * @example "€0.00"
+     * @readonly Set by the API; ignored on write.
      */
-    first_name?: string | null;
+    presentment_giftcard_usage_amount_str: string;
     /**
-     * The last name of the actor.
-     * Hidden if the user has a set nickname, and you are not the store owner.
+     * The presentment tax amount in smallest currency unit
+     * @format int32
+     * @example 999
      */
-    last_name?: string | null;
+    presentment_tax_amount: number;
     /**
-     * The nickname of the user.
+     * The presentment tax amount formatted as a string
+     * @example "€9.99"
+     * @readonly Set by the API; ignored on write.
      */
-    nickname?: string | null;
-}
-/**
- * Store payment configuration settings.
- */
-export interface StorePaymentSettingsDto {
+    presentment_tax_amount_str: string;
     /**
-     * Whether to show all available payment methods for subscription purchases.
+     * The presentment total amount in the smallest currency unit
+     * @format int32
+     * @example 10494
      */
-    show_all_payment_methods_for_subscriptions: boolean;
+    presentment_total_amount: number;
     /**
-     * Whether store pricing is tax-inclusive.
+     * The presentment total amount formatted as a string
+     * @example "€104.94"
+     * @readonly Set by the API; ignored on write.
      */
-    store_tax_inclusive_pricing: boolean;
-    block_prepaid_cards: PrepaidCardsBlockingTypeDto;
-    promo_code_stacking_behavior: StorePromoCodeStackingBehaviorDto;
+    presentment_total_amount_str: string;
     /**
-     * Whether the 'Adaptive Currency' feature is enabled.
+     * Sequence number of the billing cycle, if this order is associated with a subscription.
+     * @format int32
      */
-    adaptive_currency_enabled: boolean;
+    billing_cycle_sequence?: number | null;
     /**
-     * Whether the displayed currency on the storefront should be the Adaptive Currency by default.
+     * Line items associated with this order.
+     */
+    lines: Array<StorefrontOrderLineDto>;
+    /**
+     * Date and time when the order was created.
+     * @format date-time
+     */
+    created_at?: string | null;
+    /**
+     * Date and time when the order was completed.
+     * @format date-time
+     */
+    completed_at?: string | null;
+    /**
+     * Date and time when the order was canceled.
+     * @format date-time
+     */
+    canceled_at?: string | null;
+}
+/**
+ * Represents a line item within an order.
+ */
+export interface StorefrontOrderLineDto {
+    id: FlakeId;
+    checkout_line_id: FlakeId;
+    subscription_line_id?: FlakeId;
+    trial_id?: FlakeId;
+    product_id: FlakeId;
+    product_version_id: FlakeId;
+    /**
+     * Name of the product associated with this order line.
+     */
+    product_name: string;
+    /**
+     * URL for the product image.
+     */
+    product_image_url: string;
+    /**
+     * Numeric value of the subscription billing interval, if this line is a subscription.
+     * @format int32
+     */
+    subscription_interval_value?: number | null;
+    /**
+     * Scale of the subscription billing interval (e.g., "day", "month", "year"), if applicable.
+     */
+    subscription_interval_scale?: string | null;
+    /**
+     * Indicates whether this order line is a gift to another customer.
+     */
+    gift: boolean;
+    gift_to_customer_id?: FlakeId;
+    gift_to_customer?: StorefrontCustomerDto;
+    /**
+     * The unit price of the product in the smallest currency unit (e.g., cents)
+     * @format int32
+     * @example 1999
+     */
+    price: number;
+    /**
+     * The unit price of the product formatted as a string
+     * @example "$19.99"
+     */
+    price_str: string;
+    /**
+     * The quantity of the product in this order line
+     * @format int32
+     * @example 1
+     */
+    quantity: number;
+    /**
+     * The discount amount (from sales, coupons, and affiliate links) applied to this order line
+     * @format int32
+     * @example 0
+     */
+    discount_amount: number;
+    /**
+     * The discount amount formatted as a string
+     * @example "$0.00"
+     */
+    discount_amount_str: string;
+    /**
+     * The amount of gift card used for this order line
+     * @format int32
+     * @example 0
+     */
+    giftcard_usage_amount: number;
+    /**
+     * The gift card usage amount formatted as a string
+     * @example "$0.00"
+     */
+    giftcard_usage_amount_str: string;
+    /**
+     * The subtotal amount for this order line
+     * @format int32
+     * @example 1999
+     */
+    subtotal_amount: number;
+    /**
+     * The subtotal amount formatted as a string
+     * @example "$19.99"
+     */
+    subtotal_amount_str: string;
+    /**
+     * The tax amount for this order line
+     * @format int32
+     * @example 200
+     */
+    tax_amount: number;
+    /**
+     * The tax amount formatted as a string
+     * @example "$2.00"
+     */
+    tax_amount_str: string;
+    /**
+     * The total amount for this order line
+     * @format int32
+     * @example 2199
+     */
+    total_amount: number;
+    /**
+     * The total amount formatted as a string
+     * @example "$21.99"
+     */
+    total_amount_str: string;
+    /**
+     * The presentment subtotal amount for this order line
+     * @format int32
+     * @example 1999
+     */
+    presentment_subtotal_amount: number;
+    /**
+     * The presentment subtotal amount formatted as a string
+     * @example "€19.99"
+     * @readonly Set by the API; ignored on write.
+     */
+    presentment_subtotal_amount_str: string;
+    /**
+     * The presentment discount amount for this order line
+     * @format int32
+     * @example 0
+     */
+    presentment_discount_amount: number;
+    /**
+     * The presentment discount amount formatted as a string
+     * @example "€0.00"
+     * @readonly Set by the API; ignored on write.
+     */
+    presentment_discount_amount_str: string;
+    /**
+     * The presentment tax amount for this order line
+     * @format int32
+     * @example 200
+     */
+    presentment_tax_amount: number;
+    /**
+     * The presentment tax amount formatted as a string
+     * @example "€2.00"
+     * @readonly Set by the API; ignored on write.
+     */
+    presentment_tax_amount_str: string;
+    /**
+     * The presentment gift card usage amount for this order line
+     * @format int32
+     * @example 0
+     */
+    presentment_giftcard_usage_amount: number;
+    /**
+     * The presentment gift card usage amount formatted as a string
+     * @example "€0.00"
+     * @readonly Set by the API; ignored on write.
+     */
+    presentment_giftcard_usage_amount_str: string;
+    /**
+     * The presentment total amount for this order line
+     * @format int32
+     * @example 2199
+     */
+    presentment_total_amount: number;
+    /**
+     * The presentment total amount formatted as a string
+     * @example "€21.99"
+     * @readonly Set by the API; ignored on write.
+     */
+    presentment_total_amount_str: string;
+    selected_gameserver_id?: FlakeId;
+    /**
+     * Indicates whether tax is included in the base price, or added on top
+     * @example false
+     */
+    tax_inclusive: boolean;
+    /**
+     * The regional pricing region ID for this order line, null if no regional pricing set
+     * @example "eu"
+     */
+    pricing_region_id?: string | null;
+    /**
+     * Key-value pair of selected custom variables for this order.
+     */
+    custom_variables?: Record<string, CustomVariableLineItemDto> | null;
+}
+/**
+ * Represents a store entity within the storefront system.
+ */
+export interface StorefrontStoreDto {
+    id: FlakeId;
+    /**
+     * The URL-friendly identifier for the store, used in store URLs.
+     * @example "m0ukas-awesome-store"
+     */
+    slug: string;
+    /**
+     * The display name of the store shown to customers.
+     * @example "m0uka's awesome store"
+     */
+    name: string;
+    /**
+     * The platform or the game of the store.
+     * @example "rust"
+     */
+    platform: string;
+    /**
+     * The game of the store. Equivalent to the `platform` for backwards compatibility.
+     * @readonly Set by the API; ignored on write.
+     */
+    game: string;
+    /**
+     * The three-letter ISO currency code used for pricing in this store.
+     * If using the Adaptive Currency feature, this will be updated to reflect customer's local currency
+     * (based on passed in IP / country headers).
+     * @example "eur"
+     */
+    currency: string;
+    /**
+     * The three-letter ISO currency code signifying the main currency of the store.
+     * @example "usd"
+     */
+    creator_currency: string;
+    /**
+     * A detailed description of the store. Only present for some platform types.
+     */
+    description?: string | null;
+    /**
+     * The URL of the store's main website, if not using Hosted Webstores.
+     */
+    website_url?: string | null;
+    /**
+     * The email address customers can use to contact store support.
+     * @example "support@example.com"
+     */
+    support_email?: string | null;
+    /**
+     * The URL of the store's support page.
+     */
+    support_url?: string | null;
+    /**
+     * The type of integration this store uses with external systems.
+     */
+    integration_type?: string | null;
+    /**
+     * Indicates whether the store is in live mode (true) or test mode (false).
+     */
+    live_mode: boolean;
+    /**
+     * The URL to the store's main logo image.
+     */
+    logo_url?: string | null;
+    /**
+     * The URL to the store's square logo image.
+     */
+    logo_square_url?: string | null;
+    /**
+     * The date and time when the store was created.
+     * @format date-time
+     */
+    created_at?: string | null;
+    /**
+     * The date and time when the store was last updated.
+     * @format date-time
+     */
+    updated_at?: string | null;
+}
+/**
+ * Represents a member of a PayNow store.
+ */
+export interface StoreMemberDto {
+    id: FlakeId;
+    user_id: FlakeId;
+    user: StoreMemberUserDto;
+    /**
+     * The UTC timestamp when the member was added to the store.
+     * @format date-time
+     */
+    added_at?: string | null;
+    added_by?: ActorDto;
+    role_id?: FlakeId;
+}
+/**
+ * Represents identity and profile information for a store member.
+ */
+export interface StoreMemberUserDto {
+    type: PayNowActorType;
+    id: FlakeId;
+    /**
+     * The email address associated with the user.
+     * Only visible if you are the store owner.
+     */
+    email?: string | null;
+    /**
+     * The first name of the actor.
+     * Hidden if the user has a set nickname, and you are not the store owner.
+     */
+    first_name?: string | null;
+    /**
+     * The last name of the actor.
+     * Hidden if the user has a set nickname, and you are not the store owner.
+     */
+    last_name?: string | null;
+    /**
+     * The nickname of the user.
+     */
+    nickname?: string | null;
+}
+/**
+ * Store payment configuration settings.
+ */
+export interface StorePaymentSettingsDto {
+    /**
+     * Whether to show all available payment methods for subscription purchases.
+     */
+    show_all_payment_methods_for_subscriptions: boolean;
+    /**
+     * Whether store pricing is tax-inclusive.
+     */
+    store_tax_inclusive_pricing: boolean;
+    block_prepaid_cards: PrepaidCardsBlockingTypeDto;
+    promo_code_stacking_behavior: StorePromoCodeStackingBehaviorDto;
+    /**
+     * Whether the 'Adaptive Currency' feature is enabled.
+     */
+    adaptive_currency_enabled: boolean;
+    /**
+     * Whether the displayed currency on the storefront should be the Adaptive Currency by default.
      */
     show_adaptive_currency_on_storefront: boolean;
     /**
@@ -6195,6 +6579,7 @@ export interface StoreResult {
 export interface StoreSubscriptionDto {
     id: FlakeId;
     store_id: FlakeId;
+    user_id: FlakeId;
     plan_id: string;
     gateway: string;
     gateway_subscription_id: string;
@@ -6202,6 +6587,7 @@ export interface StoreSubscriptionDto {
     gateway_payment_method_id: string;
     currency: string;
     status: StoreSubscriptionStatus;
+    renewal_period: StoreSubscriptionRenewalPeriod;
     downgrade_period_end_plan_id?: string | null;
     cancel_at_period_end: boolean;
     /**
@@ -6223,12 +6609,13 @@ export interface StoreSubscriptionDto {
     /**
      * @format date-time
      */
-    current_period_start: string;
+    current_period_start?: string | null;
     /**
      * @format date-time
      */
-    current_period_end: string;
+    current_period_end?: string | null;
 }
+export type StoreSubscriptionRenewalPeriod = "monthly" | "annually";
 export type StoreSubscriptionStatus = "incomplete" | "trialing" | "active" | "requires_action" | "canceled";
 export interface StoreTrustDto {
     store_id: FlakeId;
@@ -7120,37 +7507,6 @@ export interface SubscriptionLineDto {
      */
     initial_presentment_total_amount_str?: string | null;
 }
-/**
- * Represents the payment method a store's subscription is billed to.
- */
-export interface SubscriptionPaymentMethodDto {
-    /**
-     * The identifier of the payment method within the payment gateway.
-     */
-    id: string;
-    /**
-     * The kind of payment method, such as a card.
-     */
-    type: string;
-    /**
-     * The card network, when the payment method is a card.
-     */
-    card_brand?: string | null;
-    /**
-     * The month the card expires, when the payment method is a card.
-     * @format int64
-     */
-    card_exp_month?: number | null;
-    /**
-     * The year the card expires, when the payment method is a card.
-     * @format int64
-     */
-    card_exp_year?: number | null;
-    /**
-     * The last four digits of the card, when the payment method is a card.
-     */
-    card_last4?: string | null;
-}
 /**
  * Portal flow for updating the payment method of a specific subscription
  */
@@ -8347,49 +8703,160 @@ export interface WebhookVariablesDto {
     event_type: WebhookEventType;
     variables: Array<string>;
 }
+/**
+ * Represents a custom domain attached to a webstore, together with the state of its ownership and
+ * SSL verification.
+ */
 export interface WebstoreCustomDomainDto {
+    /**
+     * The identifier the domain was registered under with the hosting provider.
+     */
     id: string;
+    /**
+     * The domain the webstore is served from, without a scheme (e.g., store.example.com).
+     */
     hostname: string;
+    /**
+     * The verification state of the domain as reported by the hosting provider.
+     * The domain only serves the webstore once it is active.
+     */
     status: string;
     ssl?: WebstoreCustomDomainSslDto;
     ownership_verification?: WebstoreCustomDomainOwnershipVerificationDto;
     ownership_verification_http?: WebstoreCustomDomainOwnershipVerificationHttpDto;
+    /**
+     * The errors raised by the last ownership verification attempt. Empty when the last attempt
+     * raised none.
+     */
     verification_errors: Array<string>;
     /**
+     * The date and time the domain was attached to the webstore.
      * @format date-time
      */
     created_at?: string | null;
 }
+/**
+ * Represents the DNS record that has to be published to prove ownership of a webstore's custom domain.
+ */
 export interface WebstoreCustomDomainOwnershipVerificationDto {
+    /**
+     * The kind of DNS record to publish (e.g., txt).
+     */
     type: string;
+    /**
+     * The name to publish the record under.
+     */
     name: string;
+    /**
+     * The value the record has to hold.
+     */
     value: string;
 }
+/**
+ * Represents the token file that has to be served over HTTP to prove ownership of a webstore's
+ * custom domain.
+ */
 export interface WebstoreCustomDomainOwnershipVerificationHttpDto {
+    /**
+     * The URL on the domain the token file has to be served from.
+     */
     http_url: string;
+    /**
+     * The body that URL has to return.
+     */
     http_body: string;
 }
+/**
+ * Represents the SSL certificate issued for a webstore's custom domain.
+ */
 export interface WebstoreCustomDomainSslDto {
+    /**
+     * The identifier the certificate was issued under.
+     */
     id: string;
+    /**
+     * How control of the domain is validated for the certificate (e.g., txt, http, email).
+     */
     method: string;
+    /**
+     * The state of the certificate (e.g., pending_validation, active). The domain only serves
+     * traffic over HTTPS once it is active.
+     */
     status: string;
+    /**
+     * The authority issuing the certificate, or null while one has not been chosen.
+     */
     certificate_authority?: string | null;
+    /**
+     * The records that have to be published to validate the certificate. Empty once validation no
+     * longer needs them.
+     */
     validation_records: Array<WebstoreCustomDomainSslValidationRecordDto>;
+    /**
+     * The errors raised by the last certificate validation attempt. Empty when the last attempt
+     * raised none.
+     */
     validation_errors: Array<string>;
 }
+/**
+ * Represents one record that has to be published to validate a custom domain's SSL certificate.
+ * Which fields are populated depends on the 'ssl' block's 'method'.
+ */
 export interface WebstoreCustomDomainSslValidationRecordDto {
+    /**
+     * The name to publish the DNS TXT record under, or null when validation is not by TXT record.
+     */
     txt_name?: string | null;
+    /**
+     * The value that TXT record has to hold, or null when validation is not by TXT record.
+     */
     txt_value?: string | null;
+    /**
+     * The URL on the domain the token file has to be served from, or null when validation is not
+     * over HTTP.
+     */
     http_url?: string | null;
+    /**
+     * The body that URL has to return, or null when validation is not over HTTP.
+     */
     http_body?: string | null;
+    /**
+     * The addresses a validation link can be sent to. Empty when validation is not by email.
+     */
     emails: Array<string>;
 }
+/**
+ * Specifies how ownership of a webstore's custom domain is proven.
+ * The only officially supported method is the 'http' method.
+ * - `invalid`: No verification type specified. This value is typically used as a default or uninitialized state.
+ * - `http`: Ownership is proven by serving a token file over HTTP from the domain.
+            This is the RECOMMENDED way to prove ownership, and is used by the dashboard.
+ * - `txt`: Ownership is proven by publishing a DNS TXT record on the domain.
+ * - `email`: Ownership is proven by following a link sent to an administrative address on the domain.
+ * - `cname`: Ownership is proven by publishing a DNS CNAME record on the domain.
+ */
 export type WebstoreCustomDomainVerificationTypeDto = "invalid" | "http" | "txt" | "email" | "cname";
+/**
+ * Represents a store's webstore, the hosted storefront customers browse and buy from.
+ */
 export interface WebstoreDto {
     id: FlakeId;
+    /**
+     * The slug the webstore is served from, unique across all webstores.
+     */
     slug: string;
+    /**
+     * Indicates whether the webstore is being served to customers.
+     */
     is_active: boolean;
+    /**
+     * The custom domain the webstore is served from, or null when it is only reachable at its slug.
+     */
     custom_domain?: string | null;
+    /**
+     * Indicates whether ownership of 'custom_domain' has been verified. Until it is, the webstore is
+     * only served from its slug.
+     */
     custom_domain_verified: boolean;
     current_template_id?: FlakeId;
 }