@whop/sdk 0.0.14 → 0.0.16

package/src/resources/payments.ts

@@ -97,6 +97,34 @@ export class Payments extends APIResource {
     return this._client.getAPIList('/payments', CursorPage<PaymentListResponse>, { query, ...options });
   }
 
+  /**
+   * Lists fees for a payment
+   *
+   * Required permissions:
+   *
+   * - `payment:basic:read`
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const paymentListFeesResponse of client.payments.listFees(
+   *   'pay_xxxxxxxxxxxxxx',
+   * )) {
+   *   // ...
+   * }
+   * ```
+   */
+  listFees(
+    id: string,
+    query: PaymentListFeesParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<PaymentListFeesResponsesCursorPage, PaymentListFeesResponse> {
+    return this._client.getAPIList(path`/payments/${id}/fees`, CursorPage<PaymentListFeesResponse>, {
+      query,
+      ...options,
+    });
+  }
+
   /**
    * Refunds a payment
    *
@@ -176,6 +204,8 @@ export class Payments extends APIResource {
 
 export type PaymentListResponsesCursorPage = CursorPage<PaymentListResponse>;
 
+export type PaymentListFeesResponsesCursorPage = CursorPage<PaymentListFeesResponse>;
+
 /**
  * The reason why a specific payment was billed
  */
@@ -709,6 +739,61 @@ export namespace PaymentListResponse {
   }
 }
 
+/**
+ * Represents a fee related to a payment
+ */
+export interface PaymentListFeesResponse {
+  /**
+   * The value or amount to display for the fee.
+   */
+  amount: number;
+
+  /**
+   * The currency of the fee.
+   */
+  currency: Shared.Currency;
+
+  /**
+   * The label to display for the fee.
+   */
+  name: string;
+
+  /**
+   * The specific origin of the fee, if applicable.
+   */
+  type:
+    | 'stripe_domestic_processing_fee'
+    | 'stripe_international_processing_fee'
+    | 'stripe_fixed_processing_fee'
+    | 'stripe_billing_fee'
+    | 'stripe_radar_fee'
+    | 'sales_tax_remittance'
+    | 'sales_tax_remittance_reversal'
+    | 'stripe_sales_tax_fee'
+    | 'whop_processing_fee'
+    | 'marketplace_affiliate_fee'
+    | 'affiliate_fee'
+    | 'crypto_fee'
+    | 'stripe_standard_processing_fee'
+    | 'paypal_fee'
+    | 'stripe_payout_fee'
+    | 'dispute_fee'
+    | 'dispute_alert_fee'
+    | 'apple_processing_fee'
+    | 'buyer_fee'
+    | 'sezzle_processing_fee'
+    | 'splitit_processing_fee'
+    | 'platform_balance_processing_fee'
+    | 'payment_processing_percentage_fee'
+    | 'payment_processing_fixed_fee'
+    | 'cross_border_percentage_fee'
+    | 'fx_percentage_fee'
+    | 'orchestration_percentage_fee'
+    | 'three_ds_fixed_fee'
+    | 'billing_percentage_fee'
+    | 'revshare_percentage_fee';
+}
+
 export type PaymentCreateParams =
   | PaymentCreateParams.CreatePaymentInputWithPlan
   | PaymentCreateParams.CreatePaymentInputWithPlanID;
@@ -999,6 +1084,23 @@ export interface PaymentListParams extends CursorPageParams {
   substatuses?: Array<Shared.FriendlyReceiptStatus> | null;
 }
 
+export interface PaymentListFeesParams extends CursorPageParams {
+  /**
+   * Returns the elements in the list that come before the specified cursor.
+   */
+  before?: string | null;
+
+  /**
+   * Returns the first _n_ elements from the list.
+   */
+  first?: number | null;
+
+  /**
+   * Returns the last _n_ elements from the list.
+   */
+  last?: number | null;
+}
+
 export interface PaymentRefundParams {
   /**
    * An amount if the refund is supposed to be partial.
@@ -1012,9 +1114,12 @@ export declare namespace Payments {
     type CardBrands as CardBrands,
     type PaymentMethodTypes as PaymentMethodTypes,
     type PaymentListResponse as PaymentListResponse,
+    type PaymentListFeesResponse as PaymentListFeesResponse,
     type PaymentListResponsesCursorPage as PaymentListResponsesCursorPage,
+    type PaymentListFeesResponsesCursorPage as PaymentListFeesResponsesCursorPage,
     type PaymentCreateParams as PaymentCreateParams,
     type PaymentListParams as PaymentListParams,
+    type PaymentListFeesParams as PaymentListFeesParams,
     type PaymentRefundParams as PaymentRefundParams,
   };
 }

package/src/resources/payout-methods.ts

@@ -0,0 +1,105 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { CursorPage, type CursorPageParams, PagePromise } from '../core/pagination';
+import { RequestOptions } from '../internal/request-options';
+
+export class PayoutMethods extends APIResource {
+  /**
+   * Lists payout destinations for a company
+   *
+   * Required permissions:
+   *
+   * - `payout:destination:read`
+   */
+  list(
+    query: PayoutMethodListParams,
+    options?: RequestOptions,
+  ): PagePromise<PayoutMethodListResponsesCursorPage, PayoutMethodListResponse> {
+    return this._client.getAPIList('/payout_methods', CursorPage<PayoutMethodListResponse>, {
+      query,
+      ...options,
+    });
+  }
+}
+
+export type PayoutMethodListResponsesCursorPage = CursorPage<PayoutMethodListResponse>;
+
+/**
+ * An object representing an user's setup payout destination.
+ */
+export interface PayoutMethodListResponse {
+  /**
+   * The ID of the payout token
+   */
+  id: string;
+
+  /**
+   * The currency code of the payout destination. This is the currency that payouts
+   * will be made in for this token.
+   */
+  currency: string;
+
+  /**
+   * The payout destination associated with the payout token
+   */
+  destination: PayoutMethodListResponse.Destination | null;
+
+  /**
+   * 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;
+}
+
+export namespace PayoutMethodListResponse {
+  /**
+   * The payout destination associated with the payout token
+   */
+  export interface Destination {
+    /**
+     * The category of the payout destination
+     */
+    category: 'crypto' | 'rtp' | 'next_day_bank' | 'bank_wire' | 'digital_wallet' | 'unknown';
+
+    /**
+     * The country code of the payout destination
+     */
+    country_code: string;
+
+    /**
+     * The name of the payer associated with the payout destination
+     */
+    name: string;
+  }
+}
+
+export interface PayoutMethodListParams extends CursorPageParams {
+  /**
+   * The company ID to list payout methods for.
+   */
+  company_id: string;
+
+  /**
+   * Returns the elements in the list that come before the specified cursor.
+   */
+  before?: string | 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 PayoutMethods {
+  export {
+    type PayoutMethodListResponse as PayoutMethodListResponse,
+    type PayoutMethodListResponsesCursorPage as PayoutMethodListResponsesCursorPage,
+    type PayoutMethodListParams as PayoutMethodListParams,
+  };
+}

package/src/resources/shared.ts

@@ -442,6 +442,11 @@ export interface CheckoutConfiguration {
    */
   company_id: string;
 
+  /**
+   * The available currencies on the platform
+   */
+  currency: Currency | null;
+
   /**
    * The metadata to use for the checkout configuration
    */
@@ -791,12 +796,29 @@ export namespace CourseLessonInteraction {
      */
     id: string;
 
+    /**
+     * The chapter this lesson belongs to
+     */
+    chapter: Lesson.Chapter;
+
     /**
      * The title of the lesson
      */
     title: string;
   }
 
+  export namespace Lesson {
+    /**
+     * The chapter this lesson belongs to
+     */
+    export interface Chapter {
+      /**
+       * The ID of the chapter. Looks like chap_XXX
+       */
+      id: string;
+    }
+  }
+
   /**
    * The user who interacted with the lesson
    */
@@ -858,12 +880,29 @@ export namespace CourseLessonInteractionListItem {
      */
     id: string;
 
+    /**
+     * The chapter this lesson belongs to
+     */
+    chapter: Lesson.Chapter;
+
     /**
      * The title of the lesson
      */
     title: string;
   }
 
+  export namespace Lesson {
+    /**
+     * The chapter this lesson belongs to
+     */
+    export interface Chapter {
+      /**
+       * The ID of the chapter. Looks like chap_XXX
+       */
+      id: string;
+    }
+  }
+
   /**
    * The user who interacted with the lesson
    */
@@ -1154,6 +1193,11 @@ export interface Experience {
    */
   image: Experience.Image | null;
 
+  /**
+   * Whether the experience is visible to the public
+   */
+  is_public: boolean;
+
   /**
    * The written name of the description.
    */

package/src/resources/withdrawals.ts

@@ -8,12 +8,41 @@ import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
 
 export class Withdrawals extends APIResource {
+  /**
+   * Creates a withdrawal request for a ledger account
+   *
+   * Required permissions:
+   *
+   * - `payout:withdraw_funds`
+   * - `payout:destination:read`
+   *
+   * @example
+   * ```ts
+   * const withdrawal = await client.withdrawals.create({
+   *   amount: 6.9,
+   *   company_id: 'biz_xxxxxxxxxxxxxx',
+   *   currency: 'usd',
+   * });
+   * ```
+   */
+  create(body: WithdrawalCreateParams, options?: RequestOptions): APIPromise<WithdrawalCreateResponse> {
+    return this._client.post('/withdrawals', { body, ...options });
+  }
+
   /**
    * Retrieves a withdrawal by ID
    *
    * Required permissions:
    *
    * - `payout:withdrawal:read`
+   * - `payout:destination:read`
+   *
+   * @example
+   * ```ts
+   * const withdrawal = await client.withdrawals.retrieve(
+   *   'wdrl_xxxxxxxxxxxxx',
+   * );
+   * ```
    */
   retrieve(id: string, options?: RequestOptions): APIPromise<WithdrawalRetrieveResponse> {
     return this._client.get(path`/withdrawals/${id}`, options);
@@ -25,6 +54,16 @@ export class Withdrawals extends APIResource {
    * Required permissions:
    *
    * - `payout:withdrawal:read`
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const withdrawalListResponse of client.withdrawals.list(
+   *   { company_id: 'biz_xxxxxxxxxxxxxx' },
+   * )) {
+   *   // ...
+   * }
+   * ```
    */
   list(
     query: WithdrawalListParams,
@@ -63,6 +102,190 @@ export type WithdrawalStatus =
  */
 export type WithdrawalTypes = 'regular' | 'clawback';
 
+/**
+ * A withdrawal request.
+ */
+export interface WithdrawalCreateResponse {
+  /**
+   * 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_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: WithdrawalFeeTypes | null;
+
+  /**
+   * The ledger account associated with the withdrawal.
+   */
+  ledger_account: WithdrawalCreateResponse.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: WithdrawalCreateResponse.PayoutToken | null;
+
+  /**
+   * The speed of the withdrawal.
+   */
+  speed: WithdrawalSpeeds;
+
+  /**
+   * Status of the withdrawal.
+   */
+  status: WithdrawalStatus;
+
+  /**
+   * The trace code for the payout, if applicable. Provided on ACH transactions when
+   * available.
+   */
+  trace_code: string | null;
+
+  /**
+   * The type of withdrawal.
+   */
+  withdrawal_type: WithdrawalTypes;
+}
+
+export namespace WithdrawalCreateResponse {
+  /**
+   * 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;
+  }
+}
+
 /**
  * A withdrawal request.
  */
@@ -305,6 +528,28 @@ export interface WithdrawalListResponse {
   withdrawal_type: WithdrawalTypes;
 }
 
+export interface WithdrawalCreateParams {
+  /**
+   * The amount to withdraw in the specified currency
+   */
+  amount: number;
+
+  /**
+   * The ID of the company to withdraw from.
+   */
+  company_id: string;
+
+  /**
+   * The currency that is being withdrawn.
+   */
+  currency: Shared.Currency;
+
+  /**
+   * The ID of the payout method to use for the withdrawal.
+   */
+  payout_method_id?: string | null;
+}
+
 export interface WithdrawalListParams extends CursorPageParams {
   /**
    * The ID of the company to list withdrawals for
@@ -348,9 +593,11 @@ export declare namespace Withdrawals {
     type WithdrawalSpeeds as WithdrawalSpeeds,
     type WithdrawalStatus as WithdrawalStatus,
     type WithdrawalTypes as WithdrawalTypes,
+    type WithdrawalCreateResponse as WithdrawalCreateResponse,
     type WithdrawalRetrieveResponse as WithdrawalRetrieveResponse,
     type WithdrawalListResponse as WithdrawalListResponse,
     type WithdrawalListResponsesCursorPage as WithdrawalListResponsesCursorPage,
+    type WithdrawalCreateParams as WithdrawalCreateParams,
     type WithdrawalListParams as WithdrawalListParams,
   };
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.0.14'; // x-release-please-version
+export const VERSION = '0.0.16'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.0.14";
+export declare const VERSION = "0.0.16";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.0.14";
+export declare const VERSION = "0.0.16";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.0.14'; // x-release-please-version
+exports.VERSION = '0.0.16'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.0.14'; // x-release-please-version
+export const VERSION = '0.0.16'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map