@whop/sdk 0.0.25 → 0.0.27

package/src/resources/webhooks.ts

@@ -3,11 +3,13 @@
 import { APIResource } from '../core/resource';
 import * as DisputesAPI from './disputes';
 import * as PaymentsAPI from './payments';
+import * as PayoutMethodsAPI from './payout-methods';
 import * as RefundsAPI from './refunds';
 import * as SetupIntentsAPI from './setup-intents';
 import * as Shared from './shared';
+import * as VerificationsAPI from './verifications';
 import * as WithdrawalsAPI from './withdrawals';
-import { Webhook } from 'standardwebhooks';
+import { Webhook as Webhook_ } from 'standardwebhooks';
 import { APIPromise } from '../core/api-promise';
 import { CursorPage, type CursorPageParams, PagePromise } from '../core/pagination';
 import { RequestOptions } from '../internal/request-options';
@@ -46,7 +48,7 @@ export class Webhooks extends APIResource {
    * );
    * ```
    */
-  retrieve(id: string, options?: RequestOptions): APIPromise<WebhookRetrieveResponse> {
+  retrieve(id: string, options?: RequestOptions): APIPromise<Webhook> {
     return this._client.get(path`/webhooks/${id}`, options);
   }
 
@@ -68,7 +70,7 @@ export class Webhooks extends APIResource {
     id: string,
     body: WebhookUpdateParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<WebhookUpdateResponse> {
+  ): APIPromise<Webhook> {
     return this._client.patch(path`/webhooks/${id}`, { body, ...options });
   }
 
@@ -121,7 +123,7 @@ export class Webhooks extends APIResource {
     if (headers !== undefined) {
       const keyStr: string | null = key === undefined ? this._client.webhookKey : key;
       if (keyStr === null) throw new Error('Webhook key must not be null in order to unwrap');
-      const wh = new Webhook(keyStr);
+      const wh = new Webhook_(keyStr);
       wh.verify(body, headers);
     }
     return JSON.parse(body) as UnwrapWebhookEvent;
@@ -131,131 +133,24 @@ export class Webhooks extends APIResource {
 export type WebhookListResponsesCursorPage = CursorPage<WebhookListResponse>;
 
 /**
- * A webhook object, which can be configured to be sent updates about a company
+ * The different API versions
  */
-export interface WebhookCreateResponse {
-  /**
-   * The ID of the webhook
-   */
-  id: string;
-
-  /**
-   * The API version for this webhook
-   */
-  api_version: 'v1' | 'v2' | 'v5';
-
-  /**
-   * Whether or not to send events for child resources. For example, if the webhook
-   * is created for a Company, enabling this will only send events from the Company's
-   * sub-merchants (child companies).
-   */
-  child_resource_events: boolean;
-
-  /**
-   * The timestamp of when the webhook was created
-   */
-  created_at: string;
-
-  /**
-   * Whether or not this webhook is turned on or not
-   */
-  enabled: boolean;
-
-  /**
-   * The number of events this webhooks is configured to receive
-   */
-  events: Array<
-    | 'invoice.created'
-    | 'invoice.paid'
-    | 'invoice.past_due'
-    | 'invoice.voided'
-    | 'membership.activated'
-    | 'membership.deactivated'
-    | 'entry.created'
-    | 'entry.approved'
-    | 'entry.denied'
-    | 'entry.deleted'
-    | 'setup_intent.requires_action'
-    | 'setup_intent.succeeded'
-    | 'setup_intent.canceled'
-    | 'withdrawal.created'
-    | 'withdrawal.updated'
-    | 'course_lesson_interaction.completed'
-    | 'payout_method.created'
-    | 'verification.succeeded'
-    | 'payment.created'
-    | 'payment.succeeded'
-    | 'payment.failed'
-    | 'payment.pending'
-    | 'dispute.created'
-    | 'dispute.updated'
-    | 'refund.created'
-    | 'refund.updated'
-    | 'membership.cancel_at_period_end_changed'
-  >;
-
-  /**
-   * The resource ID
-   */
-  resource_id: string;
-
-  /**
-   * The list of events that can be tested with this webhook
-   */
-  testable_events: Array<
-    | 'invoice.created'
-    | 'invoice.paid'
-    | 'invoice.past_due'
-    | 'invoice.voided'
-    | 'membership.activated'
-    | 'membership.deactivated'
-    | 'entry.created'
-    | 'entry.approved'
-    | 'entry.denied'
-    | 'entry.deleted'
-    | 'setup_intent.requires_action'
-    | 'setup_intent.succeeded'
-    | 'setup_intent.canceled'
-    | 'withdrawal.created'
-    | 'withdrawal.updated'
-    | 'course_lesson_interaction.completed'
-    | 'payout_method.created'
-    | 'verification.succeeded'
-    | 'payment.created'
-    | 'payment.succeeded'
-    | 'payment.failed'
-    | 'payment.pending'
-    | 'dispute.created'
-    | 'dispute.updated'
-    | 'refund.created'
-    | 'refund.updated'
-    | 'membership.cancel_at_period_end_changed'
-  >;
-
-  /**
-   * The URL the webhook events will be sent to
-   */
-  url: string;
-
-  /**
-   * A unique secret key that will be sent with each webhook event
-   */
-  webhook_secret: string;
-}
+export type APIVersion = 'v1' | 'v2' | 'v5';
 
 /**
- * A webhook object, which can be configured to be sent updates about a company
+ * A webhook endpoint that receives event notifications for a company via HTTP
+ * POST.
  */
-export interface WebhookRetrieveResponse {
+export interface Webhook {
   /**
-   * The ID of the webhook
+   * The unique identifier for the webhook.
    */
   id: string;
 
   /**
    * The API version for this webhook
    */
-  api_version: 'v1' | 'v2' | 'v5';
+  api_version: APIVersion;
 
   /**
    * Whether or not to send events for child resources. For example, if the webhook
@@ -265,7 +160,7 @@ export interface WebhookRetrieveResponse {
   child_resource_events: boolean;
 
   /**
-   * The timestamp of when the webhook was created
+   * The datetime the webhook was created.
    */
   created_at: string;
 
@@ -277,35 +172,7 @@ export interface WebhookRetrieveResponse {
   /**
    * The number of events this webhooks is configured to receive
    */
-  events: Array<
-    | 'invoice.created'
-    | 'invoice.paid'
-    | 'invoice.past_due'
-    | 'invoice.voided'
-    | 'membership.activated'
-    | 'membership.deactivated'
-    | 'entry.created'
-    | 'entry.approved'
-    | 'entry.denied'
-    | 'entry.deleted'
-    | 'setup_intent.requires_action'
-    | 'setup_intent.succeeded'
-    | 'setup_intent.canceled'
-    | 'withdrawal.created'
-    | 'withdrawal.updated'
-    | 'course_lesson_interaction.completed'
-    | 'payout_method.created'
-    | 'verification.succeeded'
-    | 'payment.created'
-    | 'payment.succeeded'
-    | 'payment.failed'
-    | 'payment.pending'
-    | 'dispute.created'
-    | 'dispute.updated'
-    | 'refund.created'
-    | 'refund.updated'
-    | 'membership.cancel_at_period_end_changed'
-  >;
+  events: Array<WebhookEvent>;
 
   /**
    * The resource ID
@@ -315,35 +182,7 @@ export interface WebhookRetrieveResponse {
   /**
    * The list of events that can be tested with this webhook
    */
-  testable_events: Array<
-    | 'invoice.created'
-    | 'invoice.paid'
-    | 'invoice.past_due'
-    | 'invoice.voided'
-    | 'membership.activated'
-    | 'membership.deactivated'
-    | 'entry.created'
-    | 'entry.approved'
-    | 'entry.denied'
-    | 'entry.deleted'
-    | 'setup_intent.requires_action'
-    | 'setup_intent.succeeded'
-    | 'setup_intent.canceled'
-    | 'withdrawal.created'
-    | 'withdrawal.updated'
-    | 'course_lesson_interaction.completed'
-    | 'payout_method.created'
-    | 'verification.succeeded'
-    | 'payment.created'
-    | 'payment.succeeded'
-    | 'payment.failed'
-    | 'payment.pending'
-    | 'dispute.created'
-    | 'dispute.updated'
-    | 'refund.created'
-    | 'refund.updated'
-    | 'membership.cancel_at_period_end_changed'
-  >;
+  testable_events: Array<WebhookEvent>;
 
   /**
    * The URL the webhook events will be sent to
@@ -352,18 +191,51 @@ export interface WebhookRetrieveResponse {
 }
 
 /**
- * A webhook object, which can be configured to be sent updates about a company
+ * The different event types available
+ */
+export type WebhookEvent =
+  | 'invoice.created'
+  | 'invoice.paid'
+  | 'invoice.past_due'
+  | 'invoice.voided'
+  | 'membership.activated'
+  | 'membership.deactivated'
+  | 'entry.created'
+  | 'entry.approved'
+  | 'entry.denied'
+  | 'entry.deleted'
+  | 'setup_intent.requires_action'
+  | 'setup_intent.succeeded'
+  | 'setup_intent.canceled'
+  | 'withdrawal.created'
+  | 'withdrawal.updated'
+  | 'course_lesson_interaction.completed'
+  | 'payout_method.created'
+  | 'verification.succeeded'
+  | 'payment.created'
+  | 'payment.succeeded'
+  | 'payment.failed'
+  | 'payment.pending'
+  | 'dispute.created'
+  | 'dispute.updated'
+  | 'refund.created'
+  | 'refund.updated'
+  | 'membership.cancel_at_period_end_changed';
+
+/**
+ * A webhook endpoint that receives event notifications for a company via HTTP
+ * POST.
  */
-export interface WebhookUpdateResponse {
+export interface WebhookCreateResponse {
   /**
-   * The ID of the webhook
+   * The unique identifier for the webhook.
    */
   id: string;
 
   /**
    * The API version for this webhook
    */
-  api_version: 'v1' | 'v2' | 'v5';
+  api_version: APIVersion;
 
   /**
    * Whether or not to send events for child resources. For example, if the webhook
@@ -373,7 +245,7 @@ export interface WebhookUpdateResponse {
   child_resource_events: boolean;
 
   /**
-   * The timestamp of when the webhook was created
+   * The datetime the webhook was created.
    */
   created_at: string;
 
@@ -385,35 +257,7 @@ export interface WebhookUpdateResponse {
   /**
    * The number of events this webhooks is configured to receive
    */
-  events: Array<
-    | 'invoice.created'
-    | 'invoice.paid'
-    | 'invoice.past_due'
-    | 'invoice.voided'
-    | 'membership.activated'
-    | 'membership.deactivated'
-    | 'entry.created'
-    | 'entry.approved'
-    | 'entry.denied'
-    | 'entry.deleted'
-    | 'setup_intent.requires_action'
-    | 'setup_intent.succeeded'
-    | 'setup_intent.canceled'
-    | 'withdrawal.created'
-    | 'withdrawal.updated'
-    | 'course_lesson_interaction.completed'
-    | 'payout_method.created'
-    | 'verification.succeeded'
-    | 'payment.created'
-    | 'payment.succeeded'
-    | 'payment.failed'
-    | 'payment.pending'
-    | 'dispute.created'
-    | 'dispute.updated'
-    | 'refund.created'
-    | 'refund.updated'
-    | 'membership.cancel_at_period_end_changed'
-  >;
+  events: Array<WebhookEvent>;
 
   /**
    * The resource ID
@@ -423,55 +267,33 @@ export interface WebhookUpdateResponse {
   /**
    * The list of events that can be tested with this webhook
    */
-  testable_events: Array<
-    | 'invoice.created'
-    | 'invoice.paid'
-    | 'invoice.past_due'
-    | 'invoice.voided'
-    | 'membership.activated'
-    | 'membership.deactivated'
-    | 'entry.created'
-    | 'entry.approved'
-    | 'entry.denied'
-    | 'entry.deleted'
-    | 'setup_intent.requires_action'
-    | 'setup_intent.succeeded'
-    | 'setup_intent.canceled'
-    | 'withdrawal.created'
-    | 'withdrawal.updated'
-    | 'course_lesson_interaction.completed'
-    | 'payout_method.created'
-    | 'verification.succeeded'
-    | 'payment.created'
-    | 'payment.succeeded'
-    | 'payment.failed'
-    | 'payment.pending'
-    | 'dispute.created'
-    | 'dispute.updated'
-    | 'refund.created'
-    | 'refund.updated'
-    | 'membership.cancel_at_period_end_changed'
-  >;
+  testable_events: Array<WebhookEvent>;
 
   /**
    * The URL the webhook events will be sent to
    */
   url: string;
+
+  /**
+   * A unique secret key that will be sent with each webhook event
+   */
+  webhook_secret: string;
 }
 
 /**
- * A webhook object, which can be configured to be sent updates about a company
+ * A webhook endpoint that receives event notifications for a company via HTTP
+ * POST.
  */
 export interface WebhookListResponse {
   /**
-   * The ID of the webhook
+   * The unique identifier for the webhook.
    */
   id: string;
 
   /**
    * The API version for this webhook
    */
-  api_version: 'v1' | 'v2' | 'v5';
+  api_version: APIVersion;
 
   /**
    * Whether or not to send events for child resources. For example, if the webhook
@@ -481,7 +303,7 @@ export interface WebhookListResponse {
   child_resource_events: boolean;
 
   /**
-   * The timestamp of when the webhook was created
+   * The datetime the webhook was created.
    */
   created_at: string;
 
@@ -493,35 +315,7 @@ export interface WebhookListResponse {
   /**
    * The number of events this webhooks is configured to receive
    */
-  events: Array<
-    | 'invoice.created'
-    | 'invoice.paid'
-    | 'invoice.past_due'
-    | 'invoice.voided'
-    | 'membership.activated'
-    | 'membership.deactivated'
-    | 'entry.created'
-    | 'entry.approved'
-    | 'entry.denied'
-    | 'entry.deleted'
-    | 'setup_intent.requires_action'
-    | 'setup_intent.succeeded'
-    | 'setup_intent.canceled'
-    | 'withdrawal.created'
-    | 'withdrawal.updated'
-    | 'course_lesson_interaction.completed'
-    | 'payout_method.created'
-    | 'verification.succeeded'
-    | 'payment.created'
-    | 'payment.succeeded'
-    | 'payment.failed'
-    | 'payment.pending'
-    | 'dispute.created'
-    | 'dispute.updated'
-    | 'refund.created'
-    | 'refund.updated'
-    | 'membership.cancel_at_period_end_changed'
-  >;
+  events: Array<WebhookEvent>;
 
   /**
    * The URL the webhook events will be sent to
@@ -674,8 +468,8 @@ export interface MembershipActivatedWebhookEvent {
   api_version: 'v1';
 
   /**
-   * A membership represents a purchase between a User and a Company for a specific
-   * Product.
+   * A membership represents an active relationship between a user and a product. It
+   * tracks the user's access, billing status, and renewal schedule.
    */
   data: Shared.Membership;
 
@@ -707,8 +501,8 @@ export interface MembershipDeactivatedWebhookEvent {
   api_version: 'v1';
 
   /**
-   * A membership represents a purchase between a User and a Company for a specific
-   * Product.
+   * A membership represents an active relationship between a user and a product. It
+   * tracks the user's access, billing status, and renewal schedule.
    */
   data: Shared.Membership;
 
@@ -740,7 +534,7 @@ export interface EntryCreatedWebhookEvent {
   api_version: 'v1';
 
   /**
-   * An object representing an entry in a waitlist.
+   * An entry represents a user's signup for a waitlisted plan.
    */
   data: Shared.Entry;
 
@@ -772,7 +566,7 @@ export interface EntryApprovedWebhookEvent {
   api_version: 'v1';
 
   /**
-   * An object representing an entry in a waitlist.
+   * An entry represents a user's signup for a waitlisted plan.
    */
   data: Shared.Entry;
 
@@ -804,7 +598,7 @@ export interface EntryDeniedWebhookEvent {
   api_version: 'v1';
 
   /**
-   * An object representing an entry in a waitlist.
+   * An entry represents a user's signup for a waitlisted plan.
    */
   data: Shared.Entry;
 
@@ -836,7 +630,7 @@ export interface EntryDeletedWebhookEvent {
   api_version: 'v1';
 
   /**
-   * An object representing an entry in a waitlist.
+   * An entry represents a user's signup for a waitlisted plan.
    */
   data: Shared.Entry;
 
@@ -868,8 +662,7 @@ export interface SetupIntentRequiresActionWebhookEvent {
   api_version: 'v1';
 
   /**
-   * An object representing a setup intent, which is a flow for allowing a customer
-   * to add a payment method to their account without making a purchase.
+   * A setup intent allows a user to save a payment method without making a purchase.
    */
   data: SetupIntentsAPI.SetupIntent;
 
@@ -901,8 +694,7 @@ export interface SetupIntentSucceededWebhookEvent {
   api_version: 'v1';
 
   /**
-   * An object representing a setup intent, which is a flow for allowing a customer
-   * to add a payment method to their account without making a purchase.
+   * A setup intent allows a user to save a payment method without making a purchase.
    */
   data: SetupIntentsAPI.SetupIntent;
 
@@ -934,8 +726,7 @@ export interface SetupIntentCanceledWebhookEvent {
   api_version: 'v1';
 
   /**
-   * An object representing a setup intent, which is a flow for allowing a customer
-   * to add a payment method to their account without making a purchase.
+   * A setup intent allows a user to save a payment method without making a purchase.
    */
   data: SetupIntentsAPI.SetupIntent;
 
@@ -967,9 +758,10 @@ export interface WithdrawalCreatedWebhookEvent {
   api_version: 'v1';
 
   /**
-   * A withdrawal request.
+   * A withdrawal represents a request to transfer funds from a company's ledger
+   * account to an external payout method.
    */
-  data: WithdrawalCreatedWebhookEvent.Data;
+  data: WithdrawalsAPI.Withdrawal;
 
   /**
    * The timestamp in ISO 8601 format that the webhook was sent at on the server
@@ -987,188 +779,6 @@ export interface WithdrawalCreatedWebhookEvent {
   company_id?: string | null;
 }
 
-export namespace WithdrawalCreatedWebhookEvent {
-  /**
-   * A withdrawal request.
-   */
-  export interface Data {
-    /**
-     * Internal ID of the withdrawal request.
-     */
-    id: string;
-
-    /**
-     * How much money was attempted to be withdrawn, in a float type.
-     */
-    amount: number;
-
-    /**
-     * When the withdrawal request was created.
-     */
-    created_at: string;
-
-    /**
-     * The currency of the withdrawal request.
-     */
-    currency: Shared.Currency;
-
-    /**
-     * The different error codes a payout can be in.
-     */
-    error_code:
-      | 'account_closed'
-      | 'account_does_not_exist'
-      | 'account_information_invalid'
-      | 'account_number_invalid_region'
-      | 'account_frozen'
-      | 'account_lookup_failed'
-      | 'account_not_found'
-      | 'amount_out_of_bounds'
-      | 'attributes_not_validated'
-      | 'b2b_payments_prohibited'
-      | 'bank_statement_required'
-      | 'compliance_review'
-      | 'currency_not_supported'
-      | 'deposit_canceled'
-      | 'deposit_failed'
-      | 'deposit_rejected'
-      | 'destination_unavailable'
-      | 'exceeded_account_limit'
-      | 'expired_quote'
-      | 'generic_payout_error'
-      | 'technical_problem'
-      | 'identification_number_invalid'
-      | 'invalid_account_number'
-      | 'invalid_bank_code'
-      | 'invalid_beneficiary'
-      | 'invalid_mailing_address'
-      | 'invalid_branch_number'
-      | 'invalid_branch_code'
-      | 'invalid_phone_number'
-      | 'invalid_routing_number'
-      | 'invalid_swift_code'
-      | 'invalid_company_details'
-      | 'manual_cancelation'
-      | 'misc_error'
-      | 'missing_city_and_country'
-      | 'missing_phone_number'
-      | 'missing_remittance_info'
-      | 'payee_name_invalid'
-      | 'receiving_account_locked'
-      | 'rejected_by_compliance'
-      | 'rtp_not_supported'
-      | 'non_transaction_account'
-      | 'source_token_insufficient_funds'
-      | 'ssn_invalid'
-      | 'wallet_screenshot_required'
-      | 'unsupported_region'
-      | null;
-
-    /**
-     * The error message for the withdrawal, if any.
-     */
-    error_message: string | null;
-
-    /**
-     * The estimated availability date for the withdrawal, if any.
-     */
-    estimated_availability: string | null;
-
-    /**
-     * The fee amount that was charged for the withdrawal. This is in the same currency
-     * as the withdrawal amount.
-     */
-    fee_amount: number;
-
-    /**
-     * The different fee types for a withdrawal.
-     */
-    fee_type: WithdrawalsAPI.WithdrawalFeeTypes | null;
-
-    /**
-     * The ledger account associated with the withdrawal.
-     */
-    ledger_account: Data.LedgerAccount;
-
-    /**
-     * The markup fee that was charged for the withdrawal. This is in the same currency
-     * as the withdrawal amount. This only applies to platform accounts using Whop
-     * Rails.
-     */
-    markup_fee: number;
-
-    /**
-     * The payout token used for the withdrawal, if applicable.
-     */
-    payout_token: Data.PayoutToken | null;
-
-    /**
-     * The speed of the withdrawal.
-     */
-    speed: WithdrawalsAPI.WithdrawalSpeeds;
-
-    /**
-     * Status of the withdrawal.
-     */
-    status: WithdrawalsAPI.WithdrawalStatus;
-
-    /**
-     * The trace code for the payout, if applicable. Provided on ACH transactions when
-     * available.
-     */
-    trace_code: string | null;
-  }
-
-  export namespace Data {
-    /**
-     * The ledger account associated with the withdrawal.
-     */
-    export interface LedgerAccount {
-      /**
-       * The ID of the LedgerAccount.
-       */
-      id: string;
-
-      /**
-       * The ID of the company associated with this ledger account.
-       */
-      company_id: string | null;
-    }
-
-    /**
-     * The payout token used for the withdrawal, if applicable.
-     */
-    export interface PayoutToken {
-      /**
-       * The ID of the payout token
-       */
-      id: string;
-
-      /**
-       * The date and time the payout token was created
-       */
-      created_at: string;
-
-      /**
-       * The currency code of the payout destination. This is the currency that payouts
-       * will be made in for this token.
-       */
-      destination_currency_code: string;
-
-      /**
-       * An optional nickname for the payout token to help the user identify it. This is
-       * not used by the provider and is only for the user's reference.
-       */
-      nickname: string | null;
-
-      /**
-       * The name of the payer associated with the payout token.
-       */
-      payer_name: string | null;
-    }
-  }
-}
-
 export interface WithdrawalUpdatedWebhookEvent {
   /**
    * A unique ID for every single webhook request
@@ -1181,9 +791,10 @@ export interface WithdrawalUpdatedWebhookEvent {
   api_version: 'v1';
 
   /**
-   * A withdrawal request.
+   * A withdrawal represents a request to transfer funds from a company's ledger
+   * account to an external payout method.
    */
-  data: WithdrawalUpdatedWebhookEvent.Data;
+  data: WithdrawalsAPI.Withdrawal;
 
   /**
    * The timestamp in ISO 8601 format that the webhook was sent at on the server
@@ -1201,188 +812,6 @@ export interface WithdrawalUpdatedWebhookEvent {
   company_id?: string | null;
 }
 
-export namespace WithdrawalUpdatedWebhookEvent {
-  /**
-   * A withdrawal request.
-   */
-  export interface Data {
-    /**
-     * Internal ID of the withdrawal request.
-     */
-    id: string;
-
-    /**
-     * How much money was attempted to be withdrawn, in a float type.
-     */
-    amount: number;
-
-    /**
-     * When the withdrawal request was created.
-     */
-    created_at: string;
-
-    /**
-     * The currency of the withdrawal request.
-     */
-    currency: Shared.Currency;
-
-    /**
-     * The different error codes a payout can be in.
-     */
-    error_code:
-      | 'account_closed'
-      | 'account_does_not_exist'
-      | 'account_information_invalid'
-      | 'account_number_invalid_region'
-      | 'account_frozen'
-      | 'account_lookup_failed'
-      | 'account_not_found'
-      | 'amount_out_of_bounds'
-      | 'attributes_not_validated'
-      | 'b2b_payments_prohibited'
-      | 'bank_statement_required'
-      | 'compliance_review'
-      | 'currency_not_supported'
-      | 'deposit_canceled'
-      | 'deposit_failed'
-      | 'deposit_rejected'
-      | 'destination_unavailable'
-      | 'exceeded_account_limit'
-      | 'expired_quote'
-      | 'generic_payout_error'
-      | 'technical_problem'
-      | 'identification_number_invalid'
-      | 'invalid_account_number'
-      | 'invalid_bank_code'
-      | 'invalid_beneficiary'
-      | 'invalid_mailing_address'
-      | 'invalid_branch_number'
-      | 'invalid_branch_code'
-      | 'invalid_phone_number'
-      | 'invalid_routing_number'
-      | 'invalid_swift_code'
-      | 'invalid_company_details'
-      | 'manual_cancelation'
-      | 'misc_error'
-      | 'missing_city_and_country'
-      | 'missing_phone_number'
-      | 'missing_remittance_info'
-      | 'payee_name_invalid'
-      | 'receiving_account_locked'
-      | 'rejected_by_compliance'
-      | 'rtp_not_supported'
-      | 'non_transaction_account'
-      | 'source_token_insufficient_funds'
-      | 'ssn_invalid'
-      | 'wallet_screenshot_required'
-      | 'unsupported_region'
-      | null;
-
-    /**
-     * The error message for the withdrawal, if any.
-     */
-    error_message: string | null;
-
-    /**
-     * The estimated availability date for the withdrawal, if any.
-     */
-    estimated_availability: string | null;
-
-    /**
-     * The fee amount that was charged for the withdrawal. This is in the same currency
-     * as the withdrawal amount.
-     */
-    fee_amount: number;
-
-    /**
-     * The different fee types for a withdrawal.
-     */
-    fee_type: WithdrawalsAPI.WithdrawalFeeTypes | null;
-
-    /**
-     * The ledger account associated with the withdrawal.
-     */
-    ledger_account: Data.LedgerAccount;
-
-    /**
-     * The markup fee that was charged for the withdrawal. This is in the same currency
-     * as the withdrawal amount. This only applies to platform accounts using Whop
-     * Rails.
-     */
-    markup_fee: number;
-
-    /**
-     * The payout token used for the withdrawal, if applicable.
-     */
-    payout_token: Data.PayoutToken | null;
-
-    /**
-     * The speed of the withdrawal.
-     */
-    speed: WithdrawalsAPI.WithdrawalSpeeds;
-
-    /**
-     * Status of the withdrawal.
-     */
-    status: WithdrawalsAPI.WithdrawalStatus;
-
-    /**
-     * The trace code for the payout, if applicable. Provided on ACH transactions when
-     * available.
-     */
-    trace_code: string | null;
-  }
-
-  export namespace Data {
-    /**
-     * The ledger account associated with the withdrawal.
-     */
-    export interface LedgerAccount {
-      /**
-       * The ID of the LedgerAccount.
-       */
-      id: string;
-
-      /**
-       * The ID of the company associated with this ledger account.
-       */
-      company_id: string | null;
-    }
-
-    /**
-     * The payout token used for the withdrawal, if applicable.
-     */
-    export interface PayoutToken {
-      /**
-       * The ID of the payout token
-       */
-      id: string;
-
-      /**
-       * The date and time the payout token was created
-       */
-      created_at: string;
-
-      /**
-       * The currency code of the payout destination. This is the currency that payouts
-       * will be made in for this token.
-       */
-      destination_currency_code: string;
-
-      /**
-       * An optional nickname for the payout token to help the user identify it. This is
-       * not used by the provider and is only for the user's reference.
-       */
-      nickname: string | null;
-
-      /**
-       * The name of the payer associated with the payout token.
-       */
-      payer_name: string | null;
-    }
-  }
-}
-
 export interface CourseLessonInteractionCompletedWebhookEvent {
   /**
    * A unique ID for every single webhook request
@@ -1453,7 +882,7 @@ export namespace PayoutMethodCreatedWebhookEvent {
    */
   export interface Data {
     /**
-     * The ID of the payout token
+     * The unique identifier for the payout token.
      */
     id: string;
 
@@ -1469,7 +898,7 @@ export namespace PayoutMethodCreatedWebhookEvent {
     company: Data.Company | null;
 
     /**
-     * The date and time the payout token was created
+     * The datetime the payout token was created.
      */
     created_at: string;
 
@@ -1507,7 +936,7 @@ export namespace PayoutMethodCreatedWebhookEvent {
      */
     export interface Company {
       /**
-       * The ID (tag) of the company.
+       * The unique identifier for the company.
        */
       id: string;
     }
@@ -1519,7 +948,7 @@ export namespace PayoutMethodCreatedWebhookEvent {
       /**
        * The category of the payout destination
        */
-      category: 'crypto' | 'rtp' | 'next_day_bank' | 'bank_wire' | 'digital_wallet' | 'unknown';
+      category: PayoutMethodsAPI.PayoutDestinationCategory;
 
       /**
        * The country code of the payout destination
@@ -1572,34 +1001,14 @@ export namespace VerificationSucceededWebhookEvent {
    */
   export interface Data {
     /**
-     * A unique identifier for the verification.
+     * The unique identifier for the verification.
      */
     id: string;
 
     /**
      * An error code for a verification attempt.
      */
-    last_error_code:
-      | 'abandoned'
-      | 'consent_declined'
-      | 'country_not_supported'
-      | 'device_not_supported'
-      | 'document_expired'
-      | 'document_type_not_supported'
-      | 'document_unverified_other'
-      | 'email_unverified_other'
-      | 'email_verification_declined'
-      | 'id_number_insufficient_document_data'
-      | 'id_number_mismatch'
-      | 'id_number_unverified_other'
-      | 'phone_unverified_other'
-      | 'phone_verification_declined'
-      | 'selfie_document_missing_photo'
-      | 'selfie_face_mismatch'
-      | 'selfie_manipulated'
-      | 'selfie_unverified_other'
-      | 'under_supported_age'
-      | null;
+    last_error_code: VerificationsAPI.VerificationErrorCode | null;
 
     /**
      * The last error reason that occurred during the verification.
@@ -1609,20 +1018,7 @@ export namespace VerificationSucceededWebhookEvent {
     /**
      * The status of the verification.
      */
-    status:
-      | 'requires_input'
-      | 'processing'
-      | 'verified'
-      | 'canceled'
-      | 'created'
-      | 'started'
-      | 'submitted'
-      | 'approved'
-      | 'declined'
-      | 'resubmission_requested'
-      | 'expired'
-      | 'abandoned'
-      | 'review';
+    status: VerificationsAPI.VerificationStatus;
   }
 }
 
@@ -1638,7 +1034,8 @@ export interface PaymentCreatedWebhookEvent {
   api_version: 'v1';
 
   /**
-   * An object representing a receipt for a membership.
+   * A payment represents a completed or attempted charge for a membership. Payments
+   * track the amount, status, currency, and payment method used.
    */
   data: Shared.Payment;
 
@@ -1670,7 +1067,8 @@ export interface PaymentSucceededWebhookEvent {
   api_version: 'v1';
 
   /**
-   * An object representing a receipt for a membership.
+   * A payment represents a completed or attempted charge for a membership. Payments
+   * track the amount, status, currency, and payment method used.
    */
   data: Shared.Payment;
 
@@ -1702,7 +1100,8 @@ export interface PaymentFailedWebhookEvent {
   api_version: 'v1';
 
   /**
-   * An object representing a receipt for a membership.
+   * A payment represents a completed or attempted charge for a membership. Payments
+   * track the amount, status, currency, and payment method used.
    */
   data: Shared.Payment;
 
@@ -1734,7 +1133,8 @@ export interface PaymentPendingWebhookEvent {
   api_version: 'v1';
 
   /**
-   * An object representing a receipt for a membership.
+   * A payment represents a completed or attempted charge for a membership. Payments
+   * track the amount, status, currency, and payment method used.
    */
   data: Shared.Payment;
 
@@ -1766,7 +1166,8 @@ export interface DisputeCreatedWebhookEvent {
   api_version: 'v1';
 
   /**
-   * An object representing a dispute against a company.
+   * A dispute is a chargeback or payment challenge filed against a company,
+   * including evidence and response status.
    */
   data: DisputesAPI.Dispute;
 
@@ -1798,7 +1199,8 @@ export interface DisputeUpdatedWebhookEvent {
   api_version: 'v1';
 
   /**
-   * An object representing a dispute against a company.
+   * A dispute is a chargeback or payment challenge filed against a company,
+   * including evidence and response status.
    */
   data: DisputesAPI.Dispute;
 
@@ -1830,7 +1232,8 @@ export interface RefundCreatedWebhookEvent {
   api_version: 'v1';
 
   /**
-   * An object representing a refund made on a payment.
+   * A refund represents a full or partial reversal of a payment, including the
+   * amount, status, and payment provider.
    */
   data: RefundCreatedWebhookEvent.Data;
 
@@ -1852,21 +1255,23 @@ export interface RefundCreatedWebhookEvent {
 
 export namespace RefundCreatedWebhookEvent {
   /**
-   * An object representing a refund made on a payment.
+   * A refund represents a full or partial reversal of a payment, including the
+   * amount, status, and payment provider.
    */
   export interface Data {
     /**
-     * The ID of the refund.
+     * The unique identifier for the refund.
      */
     id: string;
 
     /**
-     * The amount of the refund.
+     * The amount of the refund. Provided as a number in the specified currency. Eg:
+     * 10.43 for $10.43 USD.
      */
     amount: number;
 
     /**
-     * The time the refund was created.
+     * The datetime the refund was created.
      */
     created_at: string;
 
@@ -1917,7 +1322,7 @@ export namespace RefundCreatedWebhookEvent {
      */
     export interface Payment {
       /**
-       * The payment ID
+       * The unique identifier for the payment.
        */
       id: string;
 
@@ -1937,7 +1342,7 @@ export namespace RefundCreatedWebhookEvent {
       card_last4: string | null;
 
       /**
-       * The datetime the payment was created
+       * The datetime the payment was created.
        */
       created_at: string;
 
@@ -1998,7 +1403,7 @@ export namespace RefundCreatedWebhookEvent {
        */
       export interface Member {
         /**
-         * The ID of the member
+         * The unique identifier for the company member.
          */
         id: string;
 
@@ -2013,7 +1418,7 @@ export namespace RefundCreatedWebhookEvent {
        */
       export interface Membership {
         /**
-         * The internal ID of the membership.
+         * The unique identifier for the membership.
          */
         id: string;
 
@@ -2028,7 +1433,7 @@ export namespace RefundCreatedWebhookEvent {
        */
       export interface User {
         /**
-         * The internal ID of the user.
+         * The unique identifier for the user.
          */
         id: string;
 
@@ -2063,7 +1468,8 @@ export interface RefundUpdatedWebhookEvent {
   api_version: 'v1';
 
   /**
-   * An object representing a refund made on a payment.
+   * A refund represents a full or partial reversal of a payment, including the
+   * amount, status, and payment provider.
    */
   data: RefundUpdatedWebhookEvent.Data;
 
@@ -2085,21 +1491,23 @@ export interface RefundUpdatedWebhookEvent {
 
 export namespace RefundUpdatedWebhookEvent {
   /**
-   * An object representing a refund made on a payment.
+   * A refund represents a full or partial reversal of a payment, including the
+   * amount, status, and payment provider.
    */
   export interface Data {
     /**
-     * The ID of the refund.
+     * The unique identifier for the refund.
      */
     id: string;
 
     /**
-     * The amount of the refund.
+     * The amount of the refund. Provided as a number in the specified currency. Eg:
+     * 10.43 for $10.43 USD.
      */
     amount: number;
 
     /**
-     * The time the refund was created.
+     * The datetime the refund was created.
      */
     created_at: string;
 
@@ -2150,7 +1558,7 @@ export namespace RefundUpdatedWebhookEvent {
      */
     export interface Payment {
       /**
-       * The payment ID
+       * The unique identifier for the payment.
        */
       id: string;
 
@@ -2170,7 +1578,7 @@ export namespace RefundUpdatedWebhookEvent {
       card_last4: string | null;
 
       /**
-       * The datetime the payment was created
+       * The datetime the payment was created.
        */
       created_at: string;
 
@@ -2231,7 +1639,7 @@ export namespace RefundUpdatedWebhookEvent {
        */
       export interface Member {
         /**
-         * The ID of the member
+         * The unique identifier for the company member.
          */
         id: string;
 
@@ -2246,7 +1654,7 @@ export namespace RefundUpdatedWebhookEvent {
        */
       export interface Membership {
         /**
-         * The internal ID of the membership.
+         * The unique identifier for the membership.
          */
         id: string;
 
@@ -2261,7 +1669,7 @@ export namespace RefundUpdatedWebhookEvent {
        */
       export interface User {
         /**
-         * The internal ID of the user.
+         * The unique identifier for the user.
          */
         id: string;
 
@@ -2296,8 +1704,8 @@ export interface MembershipCancelAtPeriodEndChangedWebhookEvent {
   api_version: 'v1';
 
   /**
-   * A membership represents a purchase between a User and a Company for a specific
-   * Product.
+   * A membership represents an active relationship between a user and a product. It
+   * tracks the user's access, billing status, and renewal schedule.
    */
   data: Shared.Membership;
 
@@ -2355,7 +1763,7 @@ export interface WebhookCreateParams {
   /**
    * The different API versions
    */
-  api_version?: 'v1' | 'v2' | 'v5' | null;
+  api_version?: APIVersion | null;
 
   /**
    * Whether or not to send events for child resources. For example, if the webhook
@@ -2372,35 +1780,7 @@ export interface WebhookCreateParams {
   /**
    * The events to send the webhook for.
    */
-  events?: Array<
-    | 'invoice.created'
-    | 'invoice.paid'
-    | 'invoice.past_due'
-    | 'invoice.voided'
-    | 'membership.activated'
-    | 'membership.deactivated'
-    | 'entry.created'
-    | 'entry.approved'
-    | 'entry.denied'
-    | 'entry.deleted'
-    | 'setup_intent.requires_action'
-    | 'setup_intent.succeeded'
-    | 'setup_intent.canceled'
-    | 'withdrawal.created'
-    | 'withdrawal.updated'
-    | 'course_lesson_interaction.completed'
-    | 'payout_method.created'
-    | 'verification.succeeded'
-    | 'payment.created'
-    | 'payment.succeeded'
-    | 'payment.failed'
-    | 'payment.pending'
-    | 'dispute.created'
-    | 'dispute.updated'
-    | 'refund.created'
-    | 'refund.updated'
-    | 'membership.cancel_at_period_end_changed'
-  > | null;
+  events?: Array<WebhookEvent> | null;
 
   /**
    * The resource to create the webhook for. By default this will use current company
@@ -2412,7 +1792,7 @@ export interface WebhookUpdateParams {
   /**
    * The different API versions
    */
-  api_version?: 'v1' | 'v2' | 'v5' | null;
+  api_version?: APIVersion | null;
 
   /**
    * Whether or not to send events for child resources.
@@ -2427,35 +1807,7 @@ export interface WebhookUpdateParams {
   /**
    * The events to send the webhook for.
    */
-  events?: Array<
-    | 'invoice.created'
-    | 'invoice.paid'
-    | 'invoice.past_due'
-    | 'invoice.voided'
-    | 'membership.activated'
-    | 'membership.deactivated'
-    | 'entry.created'
-    | 'entry.approved'
-    | 'entry.denied'
-    | 'entry.deleted'
-    | 'setup_intent.requires_action'
-    | 'setup_intent.succeeded'
-    | 'setup_intent.canceled'
-    | 'withdrawal.created'
-    | 'withdrawal.updated'
-    | 'course_lesson_interaction.completed'
-    | 'payout_method.created'
-    | 'verification.succeeded'
-    | 'payment.created'
-    | 'payment.succeeded'
-    | 'payment.failed'
-    | 'payment.pending'
-    | 'dispute.created'
-    | 'dispute.updated'
-    | 'refund.created'
-    | 'refund.updated'
-    | 'membership.cancel_at_period_end_changed'
-  > | null;
+  events?: Array<WebhookEvent> | null;
 
   /**
    * The URL to send the webhook to.
@@ -2487,9 +1839,10 @@ export interface WebhookListParams extends CursorPageParams {
 
 export declare namespace Webhooks {
   export {
+    type APIVersion as APIVersion,
+    type Webhook as Webhook,
+    type WebhookEvent as WebhookEvent,
     type WebhookCreateResponse as WebhookCreateResponse,
-    type WebhookRetrieveResponse as WebhookRetrieveResponse,
-    type WebhookUpdateResponse as WebhookUpdateResponse,
     type WebhookListResponse as WebhookListResponse,
     type WebhookDeleteResponse as WebhookDeleteResponse,
     type InvoiceCreatedWebhookEvent as InvoiceCreatedWebhookEvent,