@whop/sdk 0.0.9 → 0.0.10

package/src/resources/index.ts

@@ -179,12 +179,21 @@ export {
   type NotificationCreateResponse,
   type NotificationCreateParams,
 } from './notifications';
+export {
+  PaymentTokens,
+  type PaymentTokenRetrieveResponse,
+  type PaymentTokenListResponse,
+  type PaymentTokenRetrieveParams,
+  type PaymentTokenListParams,
+  type PaymentTokenListResponsesCursorPage,
+} from './payment-tokens';
 export {
   Payments,
   type BillingReasons,
   type CardBrands,
   type PaymentMethodTypes,
   type PaymentListResponse,
+  type PaymentCreateParams,
   type PaymentListParams,
   type PaymentRefundParams,
   type PaymentListResponsesCursorPage,
@@ -242,6 +251,14 @@ export {
   type ReviewListParams,
   type ReviewListResponsesCursorPage,
 } from './reviews';
+export {
+  SetupIntents,
+  type SetupIntent,
+  type SetupIntentStatus,
+  type SetupIntentListResponse,
+  type SetupIntentListParams,
+  type SetupIntentListResponsesCursorPage,
+} from './setup-intents';
 export {
   Shipments,
   type ShipmentListResponse,
@@ -281,6 +298,9 @@ export {
   type EntryApprovedWebhookEvent,
   type EntryDeniedWebhookEvent,
   type EntryDeletedWebhookEvent,
+  type SetupIntentRequiresActionWebhookEvent,
+  type SetupIntentSucceededWebhookEvent,
+  type SetupIntentCanceledWebhookEvent,
   type CourseLessonInteractionCompletedWebhookEvent,
   type PaymentSucceededWebhookEvent,
   type PaymentFailedWebhookEvent,

package/src/resources/payment-tokens.ts

@@ -0,0 +1,207 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import * as PaymentsAPI from './payments';
+import * as Shared from './shared';
+import { APIPromise } from '../core/api-promise';
+import { CursorPage, type CursorPageParams, PagePromise } from '../core/pagination';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
+
+export class PaymentTokens extends APIResource {
+  /**
+   * Retrieves a PaymentToken by ID
+   *
+   * Required permissions:
+   *
+   * - `member:payment_methods:read`
+   */
+  retrieve(
+    id: string,
+    query: PaymentTokenRetrieveParams,
+    options?: RequestOptions,
+  ): APIPromise<PaymentTokenRetrieveResponse> {
+    return this._client.get(path`/payment_tokens/${id}`, { query, ...options });
+  }
+
+  /**
+   * Lists PaymentTokens
+   *
+   * Required permissions:
+   *
+   * - `member:payment_methods:read`
+   */
+  list(
+    query: PaymentTokenListParams,
+    options?: RequestOptions,
+  ): PagePromise<PaymentTokenListResponsesCursorPage, PaymentTokenListResponse> {
+    return this._client.getAPIList('/payment_tokens', CursorPage<PaymentTokenListResponse>, {
+      query,
+      ...options,
+    });
+  }
+}
+
+export type PaymentTokenListResponsesCursorPage = CursorPage<PaymentTokenListResponse>;
+
+/**
+ * A payment token used to process payments.
+ */
+export interface PaymentTokenRetrieveResponse {
+  /**
+   * The ID of the payment token
+   */
+  id: string;
+
+  /**
+   * The card data associated with the payment token, if its a debit or credit card
+   * token.
+   */
+  card: PaymentTokenRetrieveResponse.Card | null;
+
+  /**
+   * The date and time the payment token was created
+   */
+  created_at: string;
+
+  /**
+   * The payment method type of the payment token
+   */
+  payment_method_type: PaymentsAPI.PaymentMethodTypes;
+}
+
+export namespace PaymentTokenRetrieveResponse {
+  /**
+   * The card data associated with the payment token, if its a debit or credit card
+   * token.
+   */
+  export interface Card {
+    /**
+     * Possible card brands that a payment token can have
+     */
+    brand: PaymentsAPI.CardBrands | null;
+
+    /**
+     * Card expiration month, like 03 for March.
+     */
+    exp_month: number | null;
+
+    /**
+     * Card expiration year, like 27 for 2027.
+     */
+    exp_year: number | null;
+
+    /**
+     * Last four digits of the card.
+     */
+    last4: string | null;
+  }
+}
+
+/**
+ * A payment token used to process payments.
+ */
+export interface PaymentTokenListResponse {
+  /**
+   * The ID of the payment token
+   */
+  id: string;
+
+  /**
+   * The card data associated with the payment token, if its a debit or credit card
+   * token.
+   */
+  card: PaymentTokenListResponse.Card | null;
+
+  /**
+   * The date and time the payment token was created
+   */
+  created_at: string;
+
+  /**
+   * The payment method type of the payment token
+   */
+  payment_method_type: PaymentsAPI.PaymentMethodTypes;
+}
+
+export namespace PaymentTokenListResponse {
+  /**
+   * The card data associated with the payment token, if its a debit or credit card
+   * token.
+   */
+  export interface Card {
+    /**
+     * Possible card brands that a payment token can have
+     */
+    brand: PaymentsAPI.CardBrands | null;
+
+    /**
+     * Card expiration month, like 03 for March.
+     */
+    exp_month: number | null;
+
+    /**
+     * Card expiration year, like 27 for 2027.
+     */
+    exp_year: number | null;
+
+    /**
+     * Last four digits of the card.
+     */
+    last4: string | null;
+  }
+}
+
+export interface PaymentTokenRetrieveParams {
+  /**
+   * The ID of the Member associated with the PaymentToken
+   */
+  member_id: string;
+}
+
+export interface PaymentTokenListParams extends CursorPageParams {
+  /**
+   * The ID of the Member to list payment tokens for
+   */
+  member_id: string;
+
+  /**
+   * Returns the elements in the list that come before the specified cursor.
+   */
+  before?: string | null;
+
+  /**
+   * The minimum creation date to filter by
+   */
+  created_after?: string | null;
+
+  /**
+   * The maximum creation date to filter by
+   */
+  created_before?: string | null;
+
+  /**
+   * The direction of the sort.
+   */
+  direction?: Shared.Direction | null;
+
+  /**
+   * Returns the first _n_ elements from the list.
+   */
+  first?: number | null;
+
+  /**
+   * Returns the last _n_ elements from the list.
+   */
+  last?: number | null;
+}
+
+export declare namespace PaymentTokens {
+  export {
+    type PaymentTokenRetrieveResponse as PaymentTokenRetrieveResponse,
+    type PaymentTokenListResponse as PaymentTokenListResponse,
+    type PaymentTokenListResponsesCursorPage as PaymentTokenListResponsesCursorPage,
+    type PaymentTokenRetrieveParams as PaymentTokenRetrieveParams,
+    type PaymentTokenListParams as PaymentTokenListParams,
+  };
+}

package/src/resources/payments.ts

@@ -1,6 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../core/resource';
+import * as PaymentsAPI from './payments';
 import * as Shared from './shared';
 import { APIPromise } from '../core/api-promise';
 import { CursorPage, type CursorPageParams, PagePromise } from '../core/pagination';
@@ -8,6 +9,38 @@ import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
 
 export class Payments extends APIResource {
+  /**
+   * Creates a payment. This endpoint will respond with a payment object immediately,
+   * but the payment is processed asynchronously in the background. Use webhooks to
+   * be notified when the payment succeeds or fails.
+   *
+   * Required permissions:
+   *
+   * - `payment:charge`
+   * - `plan:create`
+   * - `access_pass:create`
+   * - `access_pass:update`
+   * - `plan:basic:read`
+   * - `access_pass:basic:read`
+   * - `member:email:read`
+   * - `member:basic:read`
+   * - `member:phone:read`
+   * - `promo_code:basic:read`
+   *
+   * @example
+   * ```ts
+   * const payment = await client.payments.create({
+   *   company_id: 'biz_xxxxxxxxxxxxxx',
+   *   member_id: 'mber_xxxxxxxxxxxxx',
+   *   payment_token_id: 'payt_xxxxxxxxxxxxx',
+   *   plan: { currency: 'usd' },
+   * });
+   * ```
+   */
+  create(body: PaymentCreateParams, options?: RequestOptions): APIPromise<Shared.Payment> {
+    return this._client.post('/payments', { body, ...options });
+  }
+
   /**
    * Retrieves a payment by ID
    *
@@ -360,6 +393,11 @@ export interface PaymentListResponse {
    */
   payment_method_type: PaymentMethodTypes | null;
 
+  /**
+   * The payment token used for the payment, if available.
+   */
+  payment_token: PaymentListResponse.PaymentToken | null;
+
   /**
    * The plan attached to this payment.
    */
@@ -526,6 +564,60 @@ export namespace PaymentListResponse {
     status: Shared.MembershipStatus;
   }
 
+  /**
+   * The payment token used for the payment, if available.
+   */
+  export interface PaymentToken {
+    /**
+     * The ID of the payment token
+     */
+    id: string;
+
+    /**
+     * The card data associated with the payment token, if its a debit or credit card
+     * token.
+     */
+    card: PaymentToken.Card | null;
+
+    /**
+     * The date and time the payment token was created
+     */
+    created_at: string;
+
+    /**
+     * The payment method type of the payment token
+     */
+    payment_method_type: PaymentsAPI.PaymentMethodTypes;
+  }
+
+  export namespace PaymentToken {
+    /**
+     * The card data associated with the payment token, if its a debit or credit card
+     * token.
+     */
+    export interface Card {
+      /**
+       * Possible card brands that a payment token can have
+       */
+      brand: PaymentsAPI.CardBrands | null;
+
+      /**
+       * Card expiration month, like 03 for March.
+       */
+      exp_month: number | null;
+
+      /**
+       * Card expiration year, like 27 for 2027.
+       */
+      exp_year: number | null;
+
+      /**
+       * Last four digits of the card.
+       */
+      last4: string | null;
+    }
+  }
+
   /**
    * The plan attached to this payment.
    */
@@ -617,6 +709,219 @@ export namespace PaymentListResponse {
   }
 }
 
+export type PaymentCreateParams =
+  | PaymentCreateParams.CreatePaymentInputWithPlan
+  | PaymentCreateParams.CreatePaymentInputWithPlanID;
+
+export declare namespace PaymentCreateParams {
+  export interface CreatePaymentInputWithPlan {
+    /**
+     * The ID of the company to create the payment for.
+     */
+    company_id: string;
+
+    /**
+     * The ID of the member to create the payment for.
+     */
+    member_id: string;
+
+    /**
+     * The ID of the payment token to use for the payment. It must be connected to the
+     * Member being charged.
+     */
+    payment_token_id: string;
+
+    /**
+     * Pass this object to create a new plan for this payment
+     */
+    plan: CreatePaymentInputWithPlan.Plan;
+  }
+
+  export namespace CreatePaymentInputWithPlan {
+    /**
+     * Pass this object to create a new plan for this payment
+     */
+    export interface Plan {
+      /**
+       * The respective currency identifier for the plan.
+       */
+      currency: Shared.Currency;
+
+      /**
+       * The interval at which the plan charges (renewal plans).
+       */
+      billing_period?: number | null;
+
+      /**
+       * The description of the plan.
+       */
+      description?: string | null;
+
+      /**
+       * The interval at which the plan charges (expiration plans).
+       */
+      expiration_days?: number | null;
+
+      /**
+       * Whether to force the creation of a new plan even if one with the same attributes
+       * already exists.
+       */
+      force_create_new_plan?: boolean | null;
+
+      /**
+       * An additional amount charged upon first purchase.
+       */
+      initial_price?: number | null;
+
+      /**
+       * A personal description or notes section for the business.
+       */
+      internal_notes?: string | null;
+
+      /**
+       * The type of plan that can be attached to a product
+       */
+      plan_type?: Shared.PlanType | null;
+
+      /**
+       * Pass this object to create a new product for this plan. We will use the product
+       * external identifier to find or create an existing product.
+       */
+      product?: Plan.Product | null;
+
+      /**
+       * The product the plan is related to. Either this or product is required.
+       */
+      product_id?: string | null;
+
+      /**
+       * The amount the customer is charged every billing period.
+       */
+      renewal_price?: number | null;
+
+      /**
+       * The title of the plan. This will be visible on the product page to customers.
+       */
+      title?: string | null;
+
+      /**
+       * The number of free trial days added before a renewal plan.
+       */
+      trial_period_days?: number | null;
+
+      /**
+       * Visibility of a resource
+       */
+      visibility?: Shared.Visibility | null;
+    }
+
+    export namespace Plan {
+      /**
+       * Pass this object to create a new product for this plan. We will use the product
+       * external identifier to find or create an existing product.
+       */
+      export interface Product {
+        /**
+         * A unique ID used to find or create a product. When provided during creation, we
+         * will look for an existing product with this external identifier — if found, it
+         * will be updated; otherwise, a new product will be created.
+         */
+        external_identifier: string;
+
+        /**
+         * The title of the product.
+         */
+        title: string;
+
+        /**
+         * The different business types a company can be.
+         */
+        business_type?: Shared.BusinessTypes | null;
+
+        /**
+         * Whether or not to collect shipping information at checkout from the customer.
+         */
+        collect_shipping_address?: boolean | null;
+
+        /**
+         * The custom statement descriptor for the product i.e. WHOP\*SPORTS, must be
+         * between 5 and 22 characters, contain at least one letter, and not contain any of
+         * the following characters: <, >, \, ', "
+         */
+        custom_statement_descriptor?: string | null;
+
+        /**
+         * A written description of the product.
+         */
+        description?: string | null;
+
+        /**
+         * The percentage of the revenue that goes to the global affiliate program.
+         */
+        global_affiliate_percentage?: number | null;
+
+        /**
+         * The different statuses of the global affiliate program for a product.
+         */
+        global_affiliate_status?: Shared.GlobalAffiliateStatus | null;
+
+        /**
+         * The headline of the product.
+         */
+        headline?: string | null;
+
+        /**
+         * The different industry types a company can be in.
+         */
+        industry_type?: Shared.IndustryTypes | null;
+
+        /**
+         * The ID of the product tax code to apply to this product.
+         */
+        product_tax_code_id?: string | null;
+
+        /**
+         * The URL to redirect the customer to after a purchase.
+         */
+        redirect_purchase_url?: string | null;
+
+        /**
+         * The route of the product.
+         */
+        route?: string | null;
+
+        /**
+         * Visibility of a resource
+         */
+        visibility?: Shared.Visibility | null;
+      }
+    }
+  }
+
+  export interface CreatePaymentInputWithPlanID {
+    /**
+     * The ID of the company to create the payment for.
+     */
+    company_id: string;
+
+    /**
+     * The ID of the member to create the payment for.
+     */
+    member_id: string;
+
+    /**
+     * The ID of the payment token to use for the payment. It must be connected to the
+     * Member being charged.
+     */
+    payment_token_id: string;
+
+    /**
+     * An ID of an existing plan to use for the payment.
+     */
+    plan_id: string;
+  }
+}
+
 export interface PaymentListParams extends CursorPageParams {
   /**
    * The ID of the company to list payments for
@@ -708,6 +1013,7 @@ export declare namespace Payments {
     type PaymentMethodTypes as PaymentMethodTypes,
     type PaymentListResponse as PaymentListResponse,
     type PaymentListResponsesCursorPage as PaymentListResponsesCursorPage,
+    type PaymentCreateParams as PaymentCreateParams,
     type PaymentListParams as PaymentListParams,
     type PaymentRefundParams as PaymentRefundParams,
   };