@naturalpay/sdk 0.3.0 → 0.5.0

package/src/resources/transfers.ts

@@ -0,0 +1,1338 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { buildHeaders } from '../internal/headers';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
+
+/**
+ * Deposit and withdrawal operations
+ */
+export class Transfers extends APIResource {
+  /**
+   * List deposits and withdrawals for the authenticated party.
+   *
+   * @example
+   * ```ts
+   * const transfers = await client.transfers.list();
+   * ```
+   */
+  list(
+    params: TransferListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<TransferListResponse> {
+    const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID, ...query } = params ?? {};
+    return this._client.get('/transfers', {
+      query,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Get a deposit or withdrawal by ID.
+   *
+   * @example
+   * ```ts
+   * const transfer = await client.transfers.get(
+   *   'trf_ecc2efdd09bd231a9ad9bd2aada37aa7',
+   * );
+   * ```
+   */
+  get(
+    transferID: string,
+    params: TransferGetParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<TransferGetResponse> {
+    const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID, ...query } = params ?? {};
+    return this._client.get(path`/transfers/${transferID}`, {
+      query,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Initiate a wallet deposit.
+   *
+   * @example
+   * ```ts
+   * const response = await client.transfers.initiateDeposit({
+   *   amount: 1,
+   *   externalAccountId: 'eac_ecc2efdd09bd231a9ad9bd2aada37aa7',
+   *   'Idempotency-Key': 'Idempotency-Key',
+   * });
+   * ```
+   */
+  initiateDeposit(
+    params: TransferInitiateDepositParams,
+    options?: RequestOptions,
+  ): APIPromise<TransferInitiateDepositResponse> {
+    const {
+      'Idempotency-Key': idempotencyKey,
+      'X-Agent-ID': xAgentID,
+      'X-Instance-ID': xInstanceID,
+      ...body
+    } = params;
+    return this._client.post('/transfers/deposit', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        {
+          'Idempotency-Key': idempotencyKey,
+          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Initiate a wallet withdrawal.
+   *
+   * @example
+   * ```ts
+   * const response = await client.transfers.initiateWithdrawal({
+   *   amount: 1,
+   *   externalAccountId: 'eac_ecc2efdd09bd231a9ad9bd2aada37aa7',
+   *   'Idempotency-Key': 'Idempotency-Key',
+   * });
+   * ```
+   */
+  initiateWithdrawal(
+    params: TransferInitiateWithdrawalParams,
+    options?: RequestOptions,
+  ): APIPromise<TransferInitiateWithdrawalResponse> {
+    const {
+      'Idempotency-Key': idempotencyKey,
+      'X-Agent-ID': xAgentID,
+      'X-Instance-ID': xInstanceID,
+      ...body
+    } = params;
+    return this._client.post('/transfers/withdraw', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        {
+          'Idempotency-Key': idempotencyKey,
+          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+export interface TransferListResponse {
+  data: Array<TransferListResponse.Data>;
+
+  meta: TransferListResponse.Meta;
+}
+
+export namespace TransferListResponse {
+  export interface Data {
+    id: string;
+
+    /**
+     * Resource attributes
+     */
+    attributes: Data.Attributes;
+
+    /**
+     * Resource relationships
+     */
+    relationships: Data.Relationships;
+
+    type: string;
+  }
+
+  export namespace Data {
+    /**
+     * Resource attributes
+     */
+    export interface Attributes {
+      /**
+       * Amount in cents
+       */
+      amount: number;
+
+      /**
+       * When this transfer was created
+       */
+      createdAt: string;
+
+      /**
+       * Currency code
+       */
+      currency: string;
+
+      /**
+       * Transfer description
+       */
+      description: string | null;
+
+      /**
+       * Expected availability time, when known
+       */
+      expectedAvailableAt: string | null;
+
+      /**
+       * Masked external account display
+       */
+      externalAccountDisplayMask: string | null;
+
+      /**
+       * Failure details when this transfer failed.
+       */
+      failure: Attributes.Failure | null;
+
+      /**
+       * Return details when this transfer was returned.
+       */
+      return: Attributes.Return | null;
+
+      /**
+       * When this transfer settled
+       */
+      settledAt: string | null;
+
+      /**
+       * Transfer status
+       */
+      status:
+        | 'CREATED'
+        | 'APPROVAL_DENIED'
+        | 'PROCESSING'
+        | 'IN_REVIEW'
+        | 'COMPLETED'
+        | 'FAILED'
+        | 'RETURNED'
+        | 'CANCELLED';
+
+      /**
+       * When this transfer was submitted
+       */
+      submittedAt: string | null;
+
+      /**
+       * Transfer type
+       */
+      type: 'deposit' | 'withdrawal';
+
+      /**
+       * When this transfer was last updated
+       */
+      updatedAt: string | null;
+    }
+
+    export namespace Attributes {
+      /**
+       * Failure details when this transfer failed.
+       */
+      export interface Failure {
+        /**
+         * Failure code, when available
+         */
+        code: string | null;
+
+        /**
+         * Failure reason, when available
+         */
+        reason: string | null;
+      }
+
+      /**
+       * Return details when this transfer was returned.
+       */
+      export interface Return {
+        /**
+         * Return code, when available
+         */
+        code: string | null;
+
+        /**
+         * Return reason, when available
+         */
+        reason: string | null;
+
+        /**
+         * When this transfer returned
+         */
+        returnedAt: string | null;
+      }
+    }
+
+    /**
+     * Resource relationships
+     */
+    export interface Relationships {
+      /**
+       * External account used for this transfer, when available.
+       */
+      externalAccount: Relationships.ExternalAccount;
+
+      /**
+       * Party that owns the transfer
+       */
+      party: Relationships.Party;
+
+      /**
+       * Primary transaction row for this transfer, when available.
+       */
+      transaction: Relationships.Transaction;
+
+      /**
+       * Wallet for this transfer
+       */
+      wallet: Relationships.Wallet;
+    }
+
+    export namespace Relationships {
+      /**
+       * External account used for this transfer, when available.
+       */
+      export interface ExternalAccount {
+        /**
+         * Related resource identifier
+         */
+        data: ExternalAccount.Data | null;
+      }
+
+      export namespace ExternalAccount {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+
+      /**
+       * Party that owns the transfer
+       */
+      export interface Party {
+        /**
+         * Related resource identifier
+         */
+        data: Party.Data;
+      }
+
+      export namespace Party {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+
+      /**
+       * Primary transaction row for this transfer, when available.
+       */
+      export interface Transaction {
+        /**
+         * Related resource identifier
+         */
+        data: Transaction.Data | null;
+      }
+
+      export namespace Transaction {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+
+      /**
+       * Wallet for this transfer
+       */
+      export interface Wallet {
+        /**
+         * Related resource identifier
+         */
+        data: Wallet.Data;
+      }
+
+      export namespace Wallet {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+    }
+  }
+
+  export interface Meta {
+    pagination: Meta.Pagination;
+  }
+
+  export namespace Meta {
+    export interface Pagination {
+      hasMore: boolean;
+
+      nextCursor: string | null;
+    }
+  }
+}
+
+export interface TransferGetResponse {
+  data: TransferGetResponse.Data;
+}
+
+export namespace TransferGetResponse {
+  export interface Data {
+    id: string;
+
+    /**
+     * Resource attributes
+     */
+    attributes: Data.Attributes;
+
+    /**
+     * Resource relationships
+     */
+    relationships: Data.Relationships;
+
+    type: string;
+  }
+
+  export namespace Data {
+    /**
+     * Resource attributes
+     */
+    export interface Attributes {
+      /**
+       * Amount in cents
+       */
+      amount: number;
+
+      /**
+       * When this transfer was created
+       */
+      createdAt: string;
+
+      /**
+       * Currency code
+       */
+      currency: string;
+
+      /**
+       * Transfer description
+       */
+      description: string | null;
+
+      /**
+       * Expected availability time, when known
+       */
+      expectedAvailableAt: string | null;
+
+      /**
+       * Masked external account display
+       */
+      externalAccountDisplayMask: string | null;
+
+      /**
+       * Failure details when this transfer failed.
+       */
+      failure: Attributes.Failure | null;
+
+      /**
+       * Return details when this transfer was returned.
+       */
+      return: Attributes.Return | null;
+
+      /**
+       * When this transfer settled
+       */
+      settledAt: string | null;
+
+      /**
+       * Transfer status
+       */
+      status:
+        | 'CREATED'
+        | 'APPROVAL_DENIED'
+        | 'PROCESSING'
+        | 'IN_REVIEW'
+        | 'COMPLETED'
+        | 'FAILED'
+        | 'RETURNED'
+        | 'CANCELLED';
+
+      /**
+       * When this transfer was submitted
+       */
+      submittedAt: string | null;
+
+      /**
+       * Transfer type
+       */
+      type: 'deposit' | 'withdrawal';
+
+      /**
+       * When this transfer was last updated
+       */
+      updatedAt: string | null;
+    }
+
+    export namespace Attributes {
+      /**
+       * Failure details when this transfer failed.
+       */
+      export interface Failure {
+        /**
+         * Failure code, when available
+         */
+        code: string | null;
+
+        /**
+         * Failure reason, when available
+         */
+        reason: string | null;
+      }
+
+      /**
+       * Return details when this transfer was returned.
+       */
+      export interface Return {
+        /**
+         * Return code, when available
+         */
+        code: string | null;
+
+        /**
+         * Return reason, when available
+         */
+        reason: string | null;
+
+        /**
+         * When this transfer returned
+         */
+        returnedAt: string | null;
+      }
+    }
+
+    /**
+     * Resource relationships
+     */
+    export interface Relationships {
+      /**
+       * External account used for this transfer, when available.
+       */
+      externalAccount: Relationships.ExternalAccount;
+
+      /**
+       * Party that owns the transfer
+       */
+      party: Relationships.Party;
+
+      /**
+       * Primary transaction row for this transfer, when available.
+       */
+      transaction: Relationships.Transaction;
+
+      /**
+       * Wallet for this transfer
+       */
+      wallet: Relationships.Wallet;
+    }
+
+    export namespace Relationships {
+      /**
+       * External account used for this transfer, when available.
+       */
+      export interface ExternalAccount {
+        /**
+         * Related resource identifier
+         */
+        data: ExternalAccount.Data | null;
+      }
+
+      export namespace ExternalAccount {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+
+      /**
+       * Party that owns the transfer
+       */
+      export interface Party {
+        /**
+         * Related resource identifier
+         */
+        data: Party.Data;
+      }
+
+      export namespace Party {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+
+      /**
+       * Primary transaction row for this transfer, when available.
+       */
+      export interface Transaction {
+        /**
+         * Related resource identifier
+         */
+        data: Transaction.Data | null;
+      }
+
+      export namespace Transaction {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+
+      /**
+       * Wallet for this transfer
+       */
+      export interface Wallet {
+        /**
+         * Related resource identifier
+         */
+        data: Wallet.Data;
+      }
+
+      export namespace Wallet {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+    }
+  }
+}
+
+export interface TransferInitiateDepositResponse {
+  data: TransferInitiateDepositResponse.Data;
+}
+
+export namespace TransferInitiateDepositResponse {
+  export interface Data {
+    id: string;
+
+    /**
+     * Resource attributes
+     */
+    attributes: Data.Attributes;
+
+    /**
+     * Resource relationships
+     */
+    relationships: Data.Relationships;
+
+    type: string;
+  }
+
+  export namespace Data {
+    /**
+     * Resource attributes
+     */
+    export interface Attributes {
+      /**
+       * Amount in cents
+       */
+      amount: number;
+
+      /**
+       * When this transfer was created
+       */
+      createdAt: string;
+
+      /**
+       * Currency code
+       */
+      currency: string;
+
+      /**
+       * Transfer description
+       */
+      description: string | null;
+
+      /**
+       * Expected availability time, when known
+       */
+      expectedAvailableAt: string | null;
+
+      /**
+       * Masked external account display
+       */
+      externalAccountDisplayMask: string | null;
+
+      /**
+       * Failure details when this transfer failed.
+       */
+      failure: Attributes.Failure | null;
+
+      /**
+       * Return details when this transfer was returned.
+       */
+      return: Attributes.Return | null;
+
+      /**
+       * When this transfer settled
+       */
+      settledAt: string | null;
+
+      /**
+       * Transfer status
+       */
+      status:
+        | 'CREATED'
+        | 'APPROVAL_DENIED'
+        | 'PROCESSING'
+        | 'IN_REVIEW'
+        | 'COMPLETED'
+        | 'FAILED'
+        | 'RETURNED'
+        | 'CANCELLED';
+
+      /**
+       * When this transfer was submitted
+       */
+      submittedAt: string | null;
+
+      /**
+       * Transfer type
+       */
+      type: 'deposit' | 'withdrawal';
+
+      /**
+       * When this transfer was last updated
+       */
+      updatedAt: string | null;
+    }
+
+    export namespace Attributes {
+      /**
+       * Failure details when this transfer failed.
+       */
+      export interface Failure {
+        /**
+         * Failure code, when available
+         */
+        code: string | null;
+
+        /**
+         * Failure reason, when available
+         */
+        reason: string | null;
+      }
+
+      /**
+       * Return details when this transfer was returned.
+       */
+      export interface Return {
+        /**
+         * Return code, when available
+         */
+        code: string | null;
+
+        /**
+         * Return reason, when available
+         */
+        reason: string | null;
+
+        /**
+         * When this transfer returned
+         */
+        returnedAt: string | null;
+      }
+    }
+
+    /**
+     * Resource relationships
+     */
+    export interface Relationships {
+      /**
+       * External account used for this transfer, when available.
+       */
+      externalAccount: Relationships.ExternalAccount;
+
+      /**
+       * Party that owns the transfer
+       */
+      party: Relationships.Party;
+
+      /**
+       * Primary transaction row for this transfer, when available.
+       */
+      transaction: Relationships.Transaction;
+
+      /**
+       * Wallet for this transfer
+       */
+      wallet: Relationships.Wallet;
+    }
+
+    export namespace Relationships {
+      /**
+       * External account used for this transfer, when available.
+       */
+      export interface ExternalAccount {
+        /**
+         * Related resource identifier
+         */
+        data: ExternalAccount.Data | null;
+      }
+
+      export namespace ExternalAccount {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+
+      /**
+       * Party that owns the transfer
+       */
+      export interface Party {
+        /**
+         * Related resource identifier
+         */
+        data: Party.Data;
+      }
+
+      export namespace Party {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+
+      /**
+       * Primary transaction row for this transfer, when available.
+       */
+      export interface Transaction {
+        /**
+         * Related resource identifier
+         */
+        data: Transaction.Data | null;
+      }
+
+      export namespace Transaction {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+
+      /**
+       * Wallet for this transfer
+       */
+      export interface Wallet {
+        /**
+         * Related resource identifier
+         */
+        data: Wallet.Data;
+      }
+
+      export namespace Wallet {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+    }
+  }
+}
+
+export interface TransferInitiateWithdrawalResponse {
+  data: TransferInitiateWithdrawalResponse.Data;
+}
+
+export namespace TransferInitiateWithdrawalResponse {
+  export interface Data {
+    id: string;
+
+    /**
+     * Resource attributes
+     */
+    attributes: Data.Attributes;
+
+    /**
+     * Resource relationships
+     */
+    relationships: Data.Relationships;
+
+    type: string;
+  }
+
+  export namespace Data {
+    /**
+     * Resource attributes
+     */
+    export interface Attributes {
+      /**
+       * Amount in cents
+       */
+      amount: number;
+
+      /**
+       * When this transfer was created
+       */
+      createdAt: string;
+
+      /**
+       * Currency code
+       */
+      currency: string;
+
+      /**
+       * Transfer description
+       */
+      description: string | null;
+
+      /**
+       * Expected availability time, when known
+       */
+      expectedAvailableAt: string | null;
+
+      /**
+       * Masked external account display
+       */
+      externalAccountDisplayMask: string | null;
+
+      /**
+       * Failure details when this transfer failed.
+       */
+      failure: Attributes.Failure | null;
+
+      /**
+       * Return details when this transfer was returned.
+       */
+      return: Attributes.Return | null;
+
+      /**
+       * When this transfer settled
+       */
+      settledAt: string | null;
+
+      /**
+       * Transfer status
+       */
+      status:
+        | 'CREATED'
+        | 'APPROVAL_DENIED'
+        | 'PROCESSING'
+        | 'IN_REVIEW'
+        | 'COMPLETED'
+        | 'FAILED'
+        | 'RETURNED'
+        | 'CANCELLED';
+
+      /**
+       * When this transfer was submitted
+       */
+      submittedAt: string | null;
+
+      /**
+       * Transfer type
+       */
+      type: 'deposit' | 'withdrawal';
+
+      /**
+       * When this transfer was last updated
+       */
+      updatedAt: string | null;
+    }
+
+    export namespace Attributes {
+      /**
+       * Failure details when this transfer failed.
+       */
+      export interface Failure {
+        /**
+         * Failure code, when available
+         */
+        code: string | null;
+
+        /**
+         * Failure reason, when available
+         */
+        reason: string | null;
+      }
+
+      /**
+       * Return details when this transfer was returned.
+       */
+      export interface Return {
+        /**
+         * Return code, when available
+         */
+        code: string | null;
+
+        /**
+         * Return reason, when available
+         */
+        reason: string | null;
+
+        /**
+         * When this transfer returned
+         */
+        returnedAt: string | null;
+      }
+    }
+
+    /**
+     * Resource relationships
+     */
+    export interface Relationships {
+      /**
+       * External account used for this transfer, when available.
+       */
+      externalAccount: Relationships.ExternalAccount;
+
+      /**
+       * Party that owns the transfer
+       */
+      party: Relationships.Party;
+
+      /**
+       * Primary transaction row for this transfer, when available.
+       */
+      transaction: Relationships.Transaction;
+
+      /**
+       * Wallet for this transfer
+       */
+      wallet: Relationships.Wallet;
+    }
+
+    export namespace Relationships {
+      /**
+       * External account used for this transfer, when available.
+       */
+      export interface ExternalAccount {
+        /**
+         * Related resource identifier
+         */
+        data: ExternalAccount.Data | null;
+      }
+
+      export namespace ExternalAccount {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+
+      /**
+       * Party that owns the transfer
+       */
+      export interface Party {
+        /**
+         * Related resource identifier
+         */
+        data: Party.Data;
+      }
+
+      export namespace Party {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+
+      /**
+       * Primary transaction row for this transfer, when available.
+       */
+      export interface Transaction {
+        /**
+         * Related resource identifier
+         */
+        data: Transaction.Data | null;
+      }
+
+      export namespace Transaction {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+
+      /**
+       * Wallet for this transfer
+       */
+      export interface Wallet {
+        /**
+         * Related resource identifier
+         */
+        data: Wallet.Data;
+      }
+
+      export namespace Wallet {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+    }
+  }
+}
+
+export interface TransferListParams {
+  /**
+   * Query param: Pagination cursor from previous response
+   */
+  cursor?: string;
+
+  /**
+   * Query param: Results per page
+   */
+  limit?: number;
+
+  /**
+   * Query param: Party ID for delegated transfer lookup
+   */
+  partyId?: string;
+
+  /**
+   * Header param: Agent ID (agt_xxx) identifying which agent is making the request.
+   */
+  'X-Agent-ID'?: string;
+
+  /**
+   * Header param: Required when X-Agent-ID is present. Session or conversation ID
+   * for agent observability.
+   */
+  'X-Instance-ID'?: string;
+}
+
+export interface TransferGetParams {
+  /**
+   * Query param: Party ID for delegated transfer lookup
+   */
+  partyId?: string;
+
+  /**
+   * Header param: Agent ID (agt_xxx) identifying which agent is making the request.
+   */
+  'X-Agent-ID'?: string;
+
+  /**
+   * Header param: Required when X-Agent-ID is present. Session or conversation ID
+   * for agent observability.
+   */
+  'X-Instance-ID'?: string;
+}
+
+export interface TransferInitiateDepositParams {
+  /**
+   * Body param: Amount in cents
+   */
+  amount: number;
+
+  /**
+   * Body param: External account ID (eac\_\*)
+   */
+  externalAccountId: string;
+
+  /**
+   * Header param: Unique key for idempotent request handling. If a request with the
+   * same key was already processed, the original response is returned.
+   */
+  'Idempotency-Key': string;
+
+  /**
+   * Body param: Currency code
+   */
+  currency?: string;
+
+  /**
+   * Body param: Deposit description
+   */
+  description?: string;
+
+  /**
+   * Header param: Agent ID (agt_xxx) identifying which agent is making the request.
+   */
+  'X-Agent-ID'?: string;
+
+  /**
+   * Header param: Required when X-Agent-ID is present. Session or conversation ID
+   * for agent observability.
+   */
+  'X-Instance-ID'?: string;
+}
+
+export interface TransferInitiateWithdrawalParams {
+  /**
+   * Body param: Amount in cents
+   */
+  amount: number;
+
+  /**
+   * Body param: External account ID (eac\_\*)
+   */
+  externalAccountId: string;
+
+  /**
+   * Header param: Unique key for idempotent request handling. If a request with the
+   * same key was already processed, the original response is returned.
+   */
+  'Idempotency-Key': string;
+
+  /**
+   * Body param: Currency code
+   */
+  currency?: string;
+
+  /**
+   * Body param: Withdrawal description
+   */
+  description?: string;
+
+  /**
+   * Header param: Agent ID (agt_xxx) identifying which agent is making the request.
+   */
+  'X-Agent-ID'?: string;
+
+  /**
+   * Header param: Required when X-Agent-ID is present. Session or conversation ID
+   * for agent observability.
+   */
+  'X-Instance-ID'?: string;
+}
+
+export declare namespace Transfers {
+  export {
+    type TransferListResponse as TransferListResponse,
+    type TransferGetResponse as TransferGetResponse,
+    type TransferInitiateDepositResponse as TransferInitiateDepositResponse,
+    type TransferInitiateWithdrawalResponse as TransferInitiateWithdrawalResponse,
+    type TransferListParams as TransferListParams,
+    type TransferGetParams as TransferGetParams,
+    type TransferInitiateDepositParams as TransferInitiateDepositParams,
+    type TransferInitiateWithdrawalParams as TransferInitiateWithdrawalParams,
+  };
+}