@whop/sdk 0.0.26 → 0.0.28

package/src/resources/shipments.ts

@@ -9,7 +9,8 @@ import { path } from '../internal/utils/path';
 
 export class Shipments extends APIResource {
   /**
-   * Creates a new shipment
+   * Create a new shipment with a tracking code for a specific payment within a
+   * company.
    *
    * Required permissions:
    *
@@ -30,7 +31,7 @@ export class Shipments extends APIResource {
   }
 
   /**
-   * Retrieves a shipment by ID
+   * Retrieves the details of an existing shipment.
    *
    * Required permissions:
    *
@@ -49,7 +50,8 @@ export class Shipments extends APIResource {
   }
 
   /**
-   * Lists shipments for a payment
+   * Returns a paginated list of shipments, with optional filtering by payment,
+   * company, or user.
    *
    * Required permissions:
    *
@@ -75,41 +77,45 @@ export class Shipments extends APIResource {
 export type ShipmentListResponsesCursorPage = CursorPage<ShipmentListResponse>;
 
 /**
- * A shipment
+ * A physical shipment associated with a payment, including carrier details and
+ * tracking information.
  */
 export interface ShipmentListResponse {
   /**
-   * The ID of the shipment
+   * The unique identifier for the shipment.
    */
   id: string;
 
   /**
-   * The carrier of the shipment
+   * The shipping carrier responsible for delivering this shipment.
    */
   carrier: Shared.ShipmentCarrier;
 
   /**
-   * The date and time the shipment was created
+   * The datetime the shipment was created.
    */
   created_at: string;
 
   /**
-   * The delivery estimate of the shipment
+   * The estimated delivery date for this shipment. Null if the carrier has not
+   * provided an estimate.
    */
   delivery_estimate: string | null;
 
   /**
-   * The payment of the shipment
+   * The payment associated with this shipment. Null if the payment has been deleted
+   * or is inaccessible.
    */
   payment: ShipmentListResponse.Payment | null;
 
   /**
-   * The service of the shipment
+   * The shipping service level used for this shipment. Null if the carrier does not
+   * specify a service tier.
    */
   service: string | null;
 
   /**
-   * The status of the shipment
+   * The current delivery status of this shipment.
    */
   status: Shared.ShipmentStatus;
 
@@ -119,23 +125,24 @@ export interface ShipmentListResponse {
   substatus: Shared.ShipmentSubstatus | null;
 
   /**
-   * The tracking code of the shipment
+   * The carrier-assigned tracking number used to look up shipment progress.
    */
   tracking_code: string;
 
   /**
-   * The date and time the shipment was last updated
+   * The datetime the shipment was last updated.
    */
   updated_at: string;
 }
 
 export namespace ShipmentListResponse {
   /**
-   * The payment of the shipment
+   * The payment associated with this shipment. Null if the payment has been deleted
+   * or is inaccessible.
    */
   export interface Payment {
     /**
-     * The payment ID
+     * The unique identifier for the payment.
      */
     id: string;
   }
@@ -143,17 +150,19 @@ export namespace ShipmentListResponse {
 
 export interface ShipmentCreateParams {
   /**
-   * The ID of the company to create the shipment for
+   * The unique identifier of the company to create the shipment for, starting with
+   * 'biz\_'.
    */
   company_id: string;
 
   /**
-   * The ID of the payment to create the shipment for
+   * The unique identifier of the payment to associate the shipment with.
    */
   payment_id: string;
 
   /**
-   * The tracking code for the shipment
+   * The carrier tracking code for the shipment, such as a USPS, UPS, or FedEx
+   * tracking number.
    */
   tracking_code: string;
 }
@@ -165,7 +174,7 @@ export interface ShipmentListParams extends CursorPageParams {
   before?: string | null;
 
   /**
-   * The ID of the company
+   * Filter shipments to only those belonging to this company.
    */
   company_id?: string | null;
 
@@ -180,12 +189,12 @@ export interface ShipmentListParams extends CursorPageParams {
   last?: number | null;
 
   /**
-   * The ID of the payment
+   * Filter shipments to only those associated with this specific payment.
    */
   payment_id?: string | null;
 
   /**
-   * The ID of the user
+   * Filter shipments to only those for this specific user.
    */
   user_id?: string | null;
 }

package/src/resources/support-channels.ts

@@ -9,8 +9,8 @@ import { path } from '../internal/utils/path';
 
 export class SupportChannels extends APIResource {
   /**
-   * Create a new support channel for a user in a company. If one already exists, it
-   * will return the existing one.
+   * Open a new support channel between a company team member and a customer. Returns
+   * the existing channel if one already exists for that user.
    *
    * Required permissions:
    *
@@ -29,7 +29,7 @@ export class SupportChannels extends APIResource {
   }
 
   /**
-   * Retrieves a support channel
+   * Retrieves the details of an existing support channel.
    *
    * Required permissions:
    *
@@ -46,7 +46,8 @@ export class SupportChannels extends APIResource {
   }
 
   /**
-   * Lists chat channels inside a company
+   * Returns a paginated list of support channels for a specific company, with
+   * optional filtering by resolution status and custom sorting.
    *
    * Required permissions:
    *
@@ -76,7 +77,8 @@ export class SupportChannels extends APIResource {
 export type SupportChannelListResponsesCursorPage = CursorPage<SupportChannelListResponse>;
 
 /**
- * Represents a DM channel
+ * A messaging channel that can be a one-on-one DM, group chat, company support
+ * conversation, or platform-level direct message.
  */
 export interface SupportChannelListResponse {
   /**
@@ -85,48 +87,54 @@ export interface SupportChannelListResponse {
   id: string;
 
   /**
-   * The bot ID if this is a support chat
+   * The unique identifier of the company associated with this channel. Null if this
+   * is not a support or company-scoped conversation.
    */
   company_id: string | null;
 
   /**
-   * The custom name of the DM channel, if any
+   * A custom display name assigned to this channel by the user. Null if no custom
+   * name has been set.
    */
   custom_name: string | null;
 
   /**
-   * The customer user if this is a support chat
+   * The customer who initiated this support conversation. Null if this is not a
+   * support chat.
    */
   customer_user: SupportChannelListResponse.CustomerUser | null;
 
   /**
-   * When the last message was sent
+   * The timestamp when the most recent message was sent in this channel. Null if no
+   * messages have been sent.
    */
   last_message_at: string | null;
 
   /**
-   * When the support ticket was resolved (null if unresolved)
+   * The timestamp when the linked support ticket was marked as resolved. Null if
+   * unresolved or not a support chat.
    */
   resolved_at: string | null;
 }
 
 export namespace SupportChannelListResponse {
   /**
-   * The customer user if this is a support chat
+   * The customer who initiated this support conversation. Null if this is not a
+   * support chat.
    */
   export interface CustomerUser {
     /**
-     * The internal ID of the user.
+     * The unique identifier for the user.
      */
     id: string;
 
     /**
-     * The name of the user from their Whop account.
+     * The user's display name shown on their public profile.
      */
     name: string | null;
 
     /**
-     * The username of the user from their Whop account.
+     * The user's unique username shown on their public profile.
      */
     username: string;
   }
@@ -134,19 +142,20 @@ export namespace SupportChannelListResponse {
 
 export interface SupportChannelCreateParams {
   /**
-   * The ID of the company to create the support chat in
+   * The unique identifier of the company to create the support channel in.
    */
   company_id: string;
 
   /**
-   * The ID (user_xxx) or username of the user to create the support chat for
+   * The user ID (e.g. 'user_xxxxx') or username of the customer to open a support
+   * channel for.
    */
   user_id: string;
 }
 
 export interface SupportChannelListParams extends CursorPageParams {
   /**
-   * The ID of the company to list chat channels for
+   * The unique identifier of the company to list support channels for.
    */
   company_id: string;
 
@@ -171,9 +180,8 @@ export interface SupportChannelListParams extends CursorPageParams {
   last?: number | null;
 
   /**
-   * Filter for tickets where customer sent the last message (needs response) AND not
-   * resolved. Set to true to only return open channels, false to only return
-   * resolved channels.
+   * Whether to filter by open or resolved support channels. Set to true to only
+   * return channels awaiting a response, or false for resolved channels.
    */
   open?: boolean | null;
 

package/src/resources/topups.ts

@@ -7,7 +7,8 @@ import { RequestOptions } from '../internal/request-options';
 
 export class Topups extends APIResource {
   /**
-   * Add funds to your platform balance by charging a stored payment method.
+   * Add funds to a company's platform balance by charging a stored payment method.
+   * Top-ups have no fees or taxes and do not count as revenue.
    *
    * Required permissions:
    *
@@ -29,16 +30,17 @@ export class Topups extends APIResource {
 }
 
 /**
- * An object representing a receipt for a membership.
+ * A payment represents a completed or attempted charge. Payments track the amount,
+ * status, currency, and payment method used.
  */
 export interface TopupCreateResponse {
   /**
-   * The payment ID
+   * The unique identifier for the payment.
    */
   id: string;
 
   /**
-   * The datetime the payment was created
+   * The datetime the payment was created.
    */
   created_at: string;
 
@@ -53,7 +55,8 @@ export interface TopupCreateResponse {
   failure_message: string | null;
 
   /**
-   * The datetime the payment was paid
+   * The time at which this payment was successfully collected. Null if the payment
+   * has not yet succeeded. As a Unix timestamp.
    */
   paid_at: string | null;
 
@@ -70,22 +73,23 @@ export interface TopupCreateResponse {
 
 export interface TopupCreateParams {
   /**
-   * The amount to add to the balance.
+   * The amount to add to the balance in the specified currency. For example, 50.00
+   * for $50.00 USD.
    */
   amount: number;
 
   /**
-   * The ID of the company to add funds to.
+   * The unique identifier of the company to add funds to, starting with 'biz\_'.
    */
   company_id: string;
 
   /**
-   * The currency of the top-up.
+   * The currency for the top-up amount, such as 'usd'.
    */
   currency: Shared.Currency;
 
   /**
-   * The ID of the payment method to charge for the top-up.
+   * The unique identifier of the stored payment method to charge for the top-up.
    */
   payment_method_id: string;
 }

package/src/resources/transfers.ts

@@ -9,7 +9,8 @@ import { path } from '../internal/utils/path';
 
 export class Transfers extends APIResource {
   /**
-   * Creates a new transfer between ledger accounts
+   * Transfer funds between two ledger accounts, such as from a company balance to a
+   * user balance.
    *
    * Required permissions:
    *
@@ -30,7 +31,7 @@ export class Transfers extends APIResource {
   }
 
   /**
-   * Retrieves a transfer by ID
+   * Retrieves the details of an existing transfer.
    *
    * Required permissions:
    *
@@ -48,7 +49,8 @@ export class Transfers extends APIResource {
   }
 
   /**
-   * Lists transfers
+   * Returns a paginated list of fund transfers, filtered by origin or destination
+   * account, with optional sorting and date filtering.
    *
    * Required permissions:
    *
@@ -73,90 +75,97 @@ export class Transfers extends APIResource {
 export type TransferListResponsesCursorPage = CursorPage<TransferListResponse>;
 
 /**
- * Credit Transaction Transfer
+ * A transfer of credit between two ledger accounts.
  */
 export interface TransferListResponse {
   /**
-   * The unique identifier of the credit transaction transfer
+   * The unique identifier for the credit transaction transfer.
    */
   id: string;
 
   /**
-   * The amount of the credit transaction transfer
+   * The transfer amount in the currency specified by the currency field. For
+   * example, 10.43 represents $10.43 USD.
    */
   amount: number;
 
   /**
-   * The timestamp when the credit transaction transfer was created
+   * The datetime the credit transaction transfer was created.
    */
   created_at: string;
 
   /**
-   * The currency of the credit transaction transfer
+   * The currency in which this transfer amount is denominated.
    */
   currency: Shared.Currency;
 
   /**
-   * The ID of the destination ledger account
+   * The unique identifier of the ledger account receiving the funds.
    */
   destination_ledger_account_id: string;
 
   /**
-   * The decimal fee of the credit transaction transfer
+   * The flat fee amount deducted from this transfer, in the transfer's currency.
+   * Null if no flat fee was applied.
    */
   fee_amount: number | null;
 
   /**
-   * A hash of metadata attached to the transfer
+   * Custom key-value pairs attached to this transfer. Maximum 50 keys, 500
+   * characters per key, 5000 characters per value.
    */
   metadata: { [key: string]: unknown } | null;
 
   /**
-   * The notes of the credit transaction transfer
+   * A free-text note attached to this transfer by the sender. Null if no note was
+   * provided.
    */
   notes: string | null;
 
   /**
-   * The ID of the origin ledger account
+   * The unique identifier of the ledger account that sent the funds.
    */
   origin_ledger_account_id: string;
 }
 
 export interface TransferCreateParams {
   /**
-   * The amount to withdraw
+   * The amount to transfer in the specified currency. For example, 25.00 for $25.00
+   * USD.
    */
   amount: number;
 
   /**
-   * The currency that is being withdrawn.
+   * The currency of the transfer amount, such as 'usd'.
    */
   currency: Shared.Currency;
 
   /**
-   * The ID of the destination account which will receive the funds (either a User
-   * ID, Company ID, or LedgerAccount ID)
+   * The identifier of the account receiving the funds. Accepts a user ID
+   * ('user_xxx'), company ID ('biz_xxx'), or ledger account ID ('ldgr_xxx').
    */
   destination_id: string;
 
   /**
-   * The ID of the origin account which will send the funds (either a User ID,
-   * Company ID, or LedgerAccount ID)
+   * The identifier of the account sending the funds. Accepts a user ID ('user_xxx'),
+   * company ID ('biz_xxx'), or ledger account ID ('ldgr_xxx').
    */
   origin_id: string;
 
   /**
-   * A unique key to ensure idempotence. Use a UUID or similar.
+   * A unique key to prevent duplicate transfers. Use a UUID or similar unique
+   * string.
    */
   idempotence_key?: string | null;
 
   /**
-   * A hash of metadata to attach to the transfer.
+   * A JSON object of custom metadata to attach to the transfer for tracking
+   * purposes.
    */
   metadata?: { [key: string]: unknown } | null;
 
   /**
-   * Notes for the transfer. Maximum of 50 characters.
+   * A short note describing the transfer, up to 50 characters.
    */
   notes?: string | null;
 }
@@ -168,18 +177,18 @@ export interface TransferListParams extends CursorPageParams {
   before?: string | null;
 
   /**
-   * The minimum creation date to filter by
+   * Only return transfers created after this timestamp.
    */
   created_after?: string | null;
 
   /**
-   * The maximum creation date to filter by
+   * Only return transfers created before this timestamp.
    */
   created_before?: string | null;
 
   /**
-   * Filter transfers to only those that were sent to this destination account.
-   * (user_xxx, biz_xxx, ldgr_xxx)
+   * Filter to transfers received by this account. Accepts a user, company, or ledger
+   * account ID.
    */
   destination_id?: string | null;
 
@@ -204,8 +213,8 @@ export interface TransferListParams extends CursorPageParams {
   order?: 'amount' | 'created_at' | null;
 
   /**
-   * Filter transfers to only those that were sent from this origin account.
-   * (user_xxx, biz_xxx, ldgr_xxx)
+   * Filter to transfers sent from this account. Accepts a user, company, or ledger
+   * account ID.
    */
   origin_id?: string | null;
 }