@usehercules/sdk 1.3.0 → 1.4.0

package/resources/beta/pay/products/variants.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variants.d.mts","sourceRoot":"","sources":["../../../../src/resources/beta/pay/products/variants.ts"],"names":[],"mappings":"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"}

package/resources/beta/pay/products/variants.d.ts

@@ -0,0 +1,206 @@
+import { APIResource } from "../../../../core/resource.js";
+import { APIPromise } from "../../../../core/api-promise.js";
+import { CursorIDPage, type CursorIDPageParams, PagePromise } from "../../../../core/pagination.js";
+import { RequestOptions } from "../../../../internal/request-options.js";
+export declare class Variants extends APIResource {
+    /**
+     * Creates a new variant with pricing for a product. Use variants to offer multiple
+     * pricing tiers or configurations (e.g., Basic at $10/month, Pro at $25/month). A
+     * Stripe Price is automatically created.
+     */
+    create(productID: string, body: VariantCreateParams, options?: RequestOptions): APIPromise<Variant>;
+    /**
+     * Updates an existing variant. Use this to modify the name, description, or active
+     * status. Pricing cannot be changed after creation—create a new variant instead.
+     */
+    update(variantID: string, params: VariantUpdateParams, options?: RequestOptions): APIPromise<Variant>;
+    /**
+     * Retrieves all variants for a product. Variants represent different pricing tiers
+     * or configurations (e.g., Basic, Pro, Enterprise) within a single product.
+     */
+    list(productID: string, query?: VariantListParams | null | undefined, options?: RequestOptions): PagePromise<VariantsCursorIDPage, Variant>;
+    /**
+     * Archives a variant, preventing new subscriptions. The associated Stripe Price is
+     * also archived. Existing subscriptions remain active.
+     */
+    archive(variantID: string, params: VariantArchiveParams, options?: RequestOptions): APIPromise<Variant>;
+    /**
+     * Retrieves a variant by ID. Returns the variant object including pricing details
+     * and status.
+     */
+    get(variantID: string, params: VariantGetParams, options?: RequestOptions): APIPromise<Variant>;
+}
+export type VariantsCursorIDPage = CursorIDPage<Variant>;
+/**
+ * A product variant representing a specific tier or configuration. Each variant
+ * has its own pricing. Variants allow a single product to have multiple pricing
+ * options (e.g., Basic, Pro, Enterprise tiers).
+ */
+export interface Variant {
+    /**
+     * Unique identifier for the price
+     */
+    id: string;
+    /**
+     * Whether the variant is available for new purchases
+     */
+    active: boolean;
+    /**
+     * Timestamp when the variant was created
+     */
+    created: string;
+    /**
+     * Display name for the variant (e.g., Basic, Standard, Premium)
+     */
+    name: string;
+    /**
+     * Price configuration for a product. Can be one-time or recurring (subscription).
+     */
+    default_price?: Variant.DefaultPrice | null;
+    /**
+     * Detailed description of what this variant includes
+     */
+    description?: string | null;
+}
+export declare namespace Variant {
+    /**
+     * Price configuration for a product. Can be one-time or recurring (subscription).
+     */
+    interface DefaultPrice {
+        /**
+         * Unique identifier for the price
+         */
+        id: string;
+        /**
+         * How to handle the billing cycle when switching plans. 'now' resets to current
+         * time, 'unchanged' keeps the original anchor. Null for one-time prices.
+         */
+        billing_cycle_anchor: 'now' | 'unchanged' | null;
+        /**
+         * Three-letter ISO currency code (e.g., usd, eur)
+         */
+        currency: string;
+        /**
+         * Billing frequency for recurring prices: day, week, month, or year. Null for
+         * one-time prices.
+         */
+        interval: 'day' | 'week' | 'month' | 'year' | null;
+        /**
+         * Number of intervals between billings for recurring prices. Null for one-time
+         * prices.
+         */
+        interval_count: number | null;
+        /**
+         * How to handle prorations when switching plans. 'default' creates prorations,
+         * 'none' disables them. Null for one-time prices.
+         */
+        proration_behavior: 'default' | 'none' | null;
+        /**
+         * When to calculate proration. 'now' uses current time, 'start_of_period' uses the
+         * billing period start. Null for one-time prices or to use Stripe's default.
+         */
+        proration_date: 'now' | 'start_of_period' | null;
+        /**
+         * Price type: one_time for single purchases, recurring for subscriptions
+         */
+        type: 'one_time' | 'recurring';
+        /**
+         * Price amount in the smallest currency unit (e.g., cents)
+         */
+        unit_amount: number | null;
+    }
+}
+export interface VariantCreateParams {
+    /**
+     * Display name for the variant (e.g., Basic, Standard, Premium)
+     */
+    name: string;
+    /**
+     * Price amount in the smallest currency unit (e.g., cents). Use 0 for free
+     * variants.
+     */
+    unit_amount: number;
+    /**
+     * Optional custom ID for the variant. If not provided, one will be generated.
+     */
+    id?: string;
+    /**
+     * Default billing cycle anchor behavior when switching to this price. 'now' resets
+     * to current time, 'unchanged' keeps original anchor. Only applies to recurring
+     * prices.
+     */
+    billing_cycle_anchor?: 'now' | 'unchanged';
+    /**
+     * Three-letter ISO currency code
+     */
+    currency?: string;
+    /**
+     * Detailed description of what this variant includes
+     */
+    description?: string;
+    /**
+     * Billing frequency for recurring prices: day, week, month, or year. Required for
+     * recurring type, ignored for one_time.
+     */
+    interval?: 'day' | 'week' | 'month' | 'year';
+    /**
+     * Number of intervals between billings for recurring prices. Required for
+     * recurring type, ignored for one_time.
+     */
+    interval_count?: number;
+    /**
+     * Default proration behavior when switching to this price. 'default' creates
+     * prorations, 'none' disables them. Only applies to recurring prices.
+     */
+    proration_behavior?: 'default' | 'none';
+    /**
+     * Default proration date calculation when switching to this price. 'now' uses
+     * current time, 'start_of_period' uses billing period start. Only applies to
+     * recurring prices.
+     */
+    proration_date?: 'now' | 'start_of_period';
+    /**
+     * Price type: one_time for single purchases, recurring for subscriptions
+     */
+    type?: 'one_time' | 'recurring';
+}
+export interface VariantUpdateParams {
+    /**
+     * Path param: The unique identifier of the product
+     */
+    product_id: string;
+    /**
+     * Body param: Whether the variant is available for new purchases
+     */
+    active?: boolean;
+    /**
+     * Body param: Detailed description of what this variant includes
+     */
+    description?: string;
+    /**
+     * Body param: Display name for the variant
+     */
+    name?: string;
+}
+export interface VariantListParams extends CursorIDPageParams {
+    /**
+     * Filter by active status
+     */
+    active?: 'true' | 'false';
+}
+export interface VariantArchiveParams {
+    /**
+     * The unique identifier of the product
+     */
+    product_id: string;
+}
+export interface VariantGetParams {
+    /**
+     * The unique identifier of the product
+     */
+    product_id: string;
+}
+export declare namespace Variants {
+    export { type Variant as Variant, type VariantsCursorIDPage as VariantsCursorIDPage, type VariantCreateParams as VariantCreateParams, type VariantUpdateParams as VariantUpdateParams, type VariantListParams as VariantListParams, type VariantArchiveParams as VariantArchiveParams, type VariantGetParams as VariantGetParams, };
+}
+//# sourceMappingURL=variants.d.ts.map

package/resources/beta/pay/products/variants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variants.d.ts","sourceRoot":"","sources":["../../../../src/resources/beta/pay/products/variants.ts"],"names":[],"mappings":"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"}

package/resources/beta/pay/products/variants.js

@@ -0,0 +1,56 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Variants = void 0;
+const resource_1 = require("../../../../core/resource.js");
+const pagination_1 = require("../../../../core/pagination.js");
+const path_1 = require("../../../../internal/utils/path.js");
+class Variants extends resource_1.APIResource {
+    /**
+     * Creates a new variant with pricing for a product. Use variants to offer multiple
+     * pricing tiers or configurations (e.g., Basic at $10/month, Pro at $25/month). A
+     * Stripe Price is automatically created.
+     */
+    create(productID, body, options) {
+        return this._client.post((0, path_1.path) `/v1/pay/products/${productID}/variants`, { body, ...options });
+    }
+    /**
+     * Updates an existing variant. Use this to modify the name, description, or active
+     * status. Pricing cannot be changed after creation—create a new variant instead.
+     */
+    update(variantID, params, options) {
+        const { product_id, ...body } = params;
+        return this._client.patch((0, path_1.path) `/v1/pay/products/${product_id}/variants/${variantID}`, {
+            body,
+            ...options,
+        });
+    }
+    /**
+     * Retrieves all variants for a product. Variants represent different pricing tiers
+     * or configurations (e.g., Basic, Pro, Enterprise) within a single product.
+     */
+    list(productID, query = {}, options) {
+        return this._client.getAPIList((0, path_1.path) `/v1/pay/products/${productID}/variants`, (pagination_1.CursorIDPage), {
+            query,
+            ...options,
+        });
+    }
+    /**
+     * Archives a variant, preventing new subscriptions. The associated Stripe Price is
+     * also archived. Existing subscriptions remain active.
+     */
+    archive(variantID, params, options) {
+        const { product_id } = params;
+        return this._client.delete((0, path_1.path) `/v1/pay/products/${product_id}/variants/${variantID}`, options);
+    }
+    /**
+     * Retrieves a variant by ID. Returns the variant object including pricing details
+     * and status.
+     */
+    get(variantID, params, options) {
+        const { product_id } = params;
+        return this._client.get((0, path_1.path) `/v1/pay/products/${product_id}/variants/${variantID}`, options);
+    }
+}
+exports.Variants = Variants;
+//# sourceMappingURL=variants.js.map

package/resources/beta/pay/products/variants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variants.js","sourceRoot":"","sources":["../../../../src/resources/beta/pay/products/variants.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,2DAAwD;AAExD,+DAAiG;AAEjG,6DAAuD;AAEvD,MAAa,QAAS,SAAQ,sBAAW;IACvC;;;;OAIG;IACH,MAAM,CAAC,SAAiB,EAAE,IAAyB,EAAE,OAAwB;QAC3E,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,oBAAoB,SAAS,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,SAAiB,EAAE,MAA2B,EAAE,OAAwB;QAC7E,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,oBAAoB,UAAU,aAAa,SAAS,EAAE,EAAE;YACpF,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,IAAI,CACF,SAAiB,EACjB,QAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAA,WAAI,EAAA,oBAAoB,SAAS,WAAW,EAAE,CAAA,yBAAqB,CAAA,EAAE;YAClG,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,SAAiB,EAAE,MAA4B,EAAE,OAAwB;QAC/E,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,oBAAoB,UAAU,aAAa,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IAClG,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,SAAiB,EAAE,MAAwB,EAAE,OAAwB;QACvE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,oBAAoB,UAAU,aAAa,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/F,CAAC;CACF;AAtDD,4BAsDC"}

package/resources/beta/pay/products/variants.mjs

@@ -0,0 +1,52 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../../../core/resource.mjs";
+import { CursorIDPage } from "../../../../core/pagination.mjs";
+import { path } from "../../../../internal/utils/path.mjs";
+export class Variants extends APIResource {
+    /**
+     * Creates a new variant with pricing for a product. Use variants to offer multiple
+     * pricing tiers or configurations (e.g., Basic at $10/month, Pro at $25/month). A
+     * Stripe Price is automatically created.
+     */
+    create(productID, body, options) {
+        return this._client.post(path `/v1/pay/products/${productID}/variants`, { body, ...options });
+    }
+    /**
+     * Updates an existing variant. Use this to modify the name, description, or active
+     * status. Pricing cannot be changed after creation—create a new variant instead.
+     */
+    update(variantID, params, options) {
+        const { product_id, ...body } = params;
+        return this._client.patch(path `/v1/pay/products/${product_id}/variants/${variantID}`, {
+            body,
+            ...options,
+        });
+    }
+    /**
+     * Retrieves all variants for a product. Variants represent different pricing tiers
+     * or configurations (e.g., Basic, Pro, Enterprise) within a single product.
+     */
+    list(productID, query = {}, options) {
+        return this._client.getAPIList(path `/v1/pay/products/${productID}/variants`, (CursorIDPage), {
+            query,
+            ...options,
+        });
+    }
+    /**
+     * Archives a variant, preventing new subscriptions. The associated Stripe Price is
+     * also archived. Existing subscriptions remain active.
+     */
+    archive(variantID, params, options) {
+        const { product_id } = params;
+        return this._client.delete(path `/v1/pay/products/${product_id}/variants/${variantID}`, options);
+    }
+    /**
+     * Retrieves a variant by ID. Returns the variant object including pricing details
+     * and status.
+     */
+    get(variantID, params, options) {
+        const { product_id } = params;
+        return this._client.get(path `/v1/pay/products/${product_id}/variants/${variantID}`, options);
+    }
+}
+//# sourceMappingURL=variants.mjs.map

package/resources/beta/pay/products/variants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"variants.mjs","sourceRoot":"","sources":["../../../../src/resources/beta/pay/products/variants.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,EAAE,YAAY,EAAwC;OAEtD,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;OAIG;IACH,MAAM,CAAC,SAAiB,EAAE,IAAyB,EAAE,OAAwB;QAC3E,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,oBAAoB,SAAS,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,SAAiB,EAAE,MAA2B,EAAE,OAAwB;QAC7E,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,oBAAoB,UAAU,aAAa,SAAS,EAAE,EAAE;YACpF,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,IAAI,CACF,SAAiB,EACjB,QAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAA,oBAAoB,SAAS,WAAW,EAAE,CAAA,YAAqB,CAAA,EAAE;YAClG,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,SAAiB,EAAE,MAA4B,EAAE,OAAwB;QAC/E,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,oBAAoB,UAAU,aAAa,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IAClG,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,SAAiB,EAAE,MAAwB,EAAE,OAAwB;QACvE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,oBAAoB,UAAU,aAAa,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/F,CAAC;CACF"}

package/src/resources/beta/pay/coupons.ts

@@ -67,7 +67,7 @@ export type CouponsCursorIDPage = CursorIDPage<Coupon>;
  */
 export interface Coupon {
   /**
-   * Unique identifier for the entitlement
+   * Unique identifier for the price
    */
   id: string;
 

package/src/resources/beta/pay/customers.ts

@@ -82,7 +82,7 @@ export type CustomersCursorIDPage = CursorIDPage<Customer>;
  */
 export interface Customer {
   /**
-   * Unique identifier for the entitlement
+   * Unique identifier for the price
    */
   id: string;
 

package/src/resources/beta/pay/entitlements.ts

@@ -19,7 +19,7 @@ export class Entitlements extends APIResource {
 
   /**
    * Updates an existing entitlement. Use this to modify the name or deactivate the
-   * entitlement. The key cannot be changed after creation.
+   * entitlement.
    */
   update(
     entitlementID: string,
@@ -31,8 +31,7 @@ export class Entitlements extends APIResource {
 
   /**
    * Retrieves a paginated list of all entitlements. Entitlements represent features
-   * or capabilities in your app that can be gated by subscription. Use the key
-   * filter to find a specific entitlement by its key.
+   * or capabilities in your app that can be gated by subscription.
    */
   list(
     query: EntitlementListParams | null | undefined = {},
@@ -43,7 +42,7 @@ export class Entitlements extends APIResource {
 
   /**
    * Retrieves an entitlement by ID. Returns the entitlement object including its
-   * lookup key and active status.
+   * active status.
    */
   get(entitlementID: string, options?: RequestOptions): APIPromise<Entitlement> {
     return this._client.get(path`/v1/pay/entitlements/${entitlementID}`, options);
@@ -57,7 +56,7 @@ export type EntitlementsCursorIDPage = CursorIDPage<Entitlement>;
  */
 export interface Entitlement {
   /**
-   * Unique identifier for the entitlement
+   * Unique identifier for the price
    */
   id: string;
 
@@ -66,16 +65,6 @@ export interface Entitlement {
    */
   active: boolean;
 
-  /**
-   * Unique key to identify the entitlement when checking access in your app
-   */
-  key: string;
-
-  /**
-   * Whether this is a live mode entitlement (vs test mode)
-   */
-  livemode: boolean;
-
   /**
    * Display name for the entitlement (e.g., API Access, Premium Support)
    */
@@ -83,12 +72,6 @@ export interface Entitlement {
 }
 
 export interface EntitlementCreateParams {
-  /**
-   * Unique key to identify the entitlement when checking access. Use a descriptive,
-   * stable key (e.g., api_access, premium_support).
-   */
-  key: string;
-
   /**
    * Display name for the entitlement (e.g., API Access, Premium Support)
    */
@@ -117,11 +100,6 @@ export interface EntitlementListParams extends CursorIDPageParams {
    * Filter by archived status
    */
   archived?: 'true' | 'false';
-
-  /**
-   * Filter by exact key match
-   */
-  key?: string;
 }
 
 export declare namespace Entitlements {

package/src/resources/beta/pay/pay.ts

@@ -108,34 +108,76 @@ export interface PayCancelResponse {
  */
 export interface PayCheckResponse {
   /**
-   * Whether the customer has the entitlement
-   */
-  has_entitlement: boolean;
-
-  /**
-   * The entitlement key that was checked
+   * The entitlement ID that was checked
    */
-  key: string;
+  entitlement_id: string;
 
   /**
-   * The active entitlement ID if present
+   * Whether the customer has the entitlement
    */
-  entitlement_id?: string | null;
+  has_entitlement: boolean;
 }
 
 /**
- * Checkout session response
+ * Checkout response. For new customers, returns a checkout URL. For existing
+ * subscribers, returns the updated subscription.
  */
 export interface PayCheckoutResponse {
   /**
-   * The checkout session ID
+   * The checkout session ID (for checkout action) or subscription ID (for update
+   * action)
    */
   id: string;
 
   /**
-   * The checkout URL to redirect the customer to
+   * The action taken: 'checkout' for new subscriptions (redirect to URL), 'update'
+   * for subscription changes (already applied)
+   */
+  action: 'checkout' | 'update';
+
+  /**
+   * The checkout mode: subscription for recurring prices, payment for one-time
+   * prices. Only present for 'checkout' action.
+   */
+  mode?: 'subscription' | 'payment' | null;
+
+  /**
+   * The updated subscription details. Only present for 'update' action.
+   */
+  subscription?: PayCheckoutResponse.Subscription | null;
+
+  /**
+   * The checkout URL to redirect the customer to. Only present for 'checkout'
+   * action.
+   */
+  url?: string | null;
+}
+
+export namespace PayCheckoutResponse {
+  /**
+   * The updated subscription details. Only present for 'update' action.
    */
-  url: string;
+  export interface Subscription {
+    /**
+     * The subscription ID
+     */
+    id: string;
+
+    /**
+     * The product ID
+     */
+    product_id: string;
+
+    /**
+     * The subscription status
+     */
+    status: string;
+
+    /**
+     * The variant ID if applicable
+     */
+    variant_id?: string | null;
+  }
 }
 
 export interface PayCancelParams {
@@ -163,9 +205,9 @@ export interface PayCheckParams {
   customer_id: string;
 
   /**
-   * The entitlement key to check for access
+   * The entitlement ID to check for access
    */
-  entitlement_key: string;
+  entitlement_id: string;
 }
 
 export interface PayCheckoutParams {
@@ -175,15 +217,23 @@ export interface PayCheckoutParams {
   customer_id: string;
 
   /**
-   * The product ID to subscribe to
+   * The product ID to purchase
    */
   product_id: string;
 
   /**
-   * Optional custom ID for the subscription. If not provided, one will be generated.
+   * Optional custom ID for the subscription or payment. If not provided, one will be
+   * generated.
    */
   id?: string;
 
+  /**
+   * Override billing cycle anchor behavior for subscription updates. 'now' resets to
+   * current time, 'unchanged' keeps original anchor. If not provided, uses the
+   * price's configured default.
+   */
+  billing_cycle_anchor?: 'now' | 'unchanged';
+
   /**
    * URL to redirect on cancel
    */
@@ -194,10 +244,30 @@ export interface PayCheckoutParams {
    */
   promotion_code?: string;
 
+  /**
+   * Override proration behavior for subscription updates. 'default' creates
+   * prorations, 'none' disables them. If not provided, uses the price's configured
+   * default.
+   */
+  proration_behavior?: 'default' | 'none';
+
+  /**
+   * Override proration date calculation for subscription updates. 'now' uses current
+   * time, 'start_of_period' uses billing period start. If not provided, uses the
+   * price's configured default.
+   */
+  proration_date?: 'now' | 'start_of_period';
+
   /**
    * URL to redirect on success
    */
   success_url?: string;
+
+  /**
+   * Optional variant ID to specify a particular pricing tier. If not provided, the
+   * product's default price is used.
+   */
+  variant_id?: string;
 }
 
 Pay.Customers = Customers;

package/src/resources/beta/pay/products/entitlements.ts

@@ -59,7 +59,7 @@ export type ProductEntitlementsCursorIDPage = CursorIDPage<ProductEntitlement>;
  */
 export interface ProductEntitlement {
   /**
-   * Unique identifier for the entitlement
+   * Unique identifier for the price
    */
   id: string;
 

package/src/resources/beta/pay/products/index.ts

@@ -16,3 +16,13 @@ export {
   type ProductListParams,
   type ProductsCursorIDPage,
 } from './products';
+export {
+  Variants,
+  type Variant,
+  type VariantCreateParams,
+  type VariantUpdateParams,
+  type VariantListParams,
+  type VariantArchiveParams,
+  type VariantGetParams,
+  type VariantsCursorIDPage,
+} from './variants';