squarefi-bff-api-module 1.35.3 → 1.36.1

package/dist/api/types/autogen/apiV1Legacy.types.d.ts

@@ -1260,13 +1260,18 @@ export interface paths {
                     sort_by?: "card_id" | "nick_name" | "name_on_card" | "last4" | "card_status" | "created_at";
                     /** @description Sort direction */
                     sort_order?: "ASC" | "DESC";
+                    /**
+                     * @description Filter cards by last 4 digits of the card number (partial, case-insensitive match against `issuing_cards.last4`).
+                     * @example 1234
+                     */
+                    "filter[last4]"?: string;
                     /** @description Filter by specific card properties. Can be provided in three ways:
                      *     1. As JSON object: `filter={"last4":"1234"}`
                      *     2. As query params: `filter[last4]=1234`
                      *     3. For nested filtering: `filter[fiat_account][type]=prepaid`
                      *
                      *     Common filter fields:
-                     *     - `last4`: Filter by last 4 digits of card
+                     *     - `last4`: Filter by last 4 digits of card (partial, case-insensitive match)
                      *     - `card_status`: Filter by status (ACTIVE, INACTIVE, CANCELED)
                      *     - `fiat_account.type`: Filter by account type (prepaid, balance)
                      *     - `from_created_at`: Filter cards created on or after this date (ISO 8601 format)
@@ -2284,10 +2289,12 @@ export interface paths {
                     new_scheme?: boolean;
                     /** @description Filter by transaction type */
                     transaction_type?: string;
-                    /** @description Filter by start date */
+                    /** @description Filter by start date (ISO 8601). Sent to external provider as `from_timestamp` and post-filtered against `cleared_at`/`created_at`. */
                     from?: string;
-                    /** @description Filter by end date */
+                    /** @description Filter by end date (ISO 8601). Sent to external provider as `to_timestamp` and post-filtered against `cleared_at`/`created_at`. */
                     to?: string;
+                    /** @description Filter by transaction status. Forwarded to external provider and applied as a post-filter on the combined result. */
+                    status?: "PENDING" | "APPROVED" | "DECLINED" | "CANCELED";
                 };
                 header?: never;
                 path?: never;
@@ -3176,25 +3183,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": {
-                            id?: string;
-                            name?: string;
-                            description?: string;
-                            is_active?: boolean;
-                            /** @description Associated KYC rails for this order type */
-                            order_types_kyc_rails?: {
-                                /**
-                                 * Format: uuid
-                                 * @description Unique identifier of the association
-                                 */
-                                id?: string;
-                                /**
-                                 * Format: uuid
-                                 * @description ID of the associated KYC rail
-                                 */
-                                kyc_rail_id?: string;
-                            }[];
-                        }[];
+                        "application/json": components["schemas"]["OrderType"][];
                     };
                 };
                 /** @description Server error */
@@ -3247,28 +3236,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": {
-                            id?: string;
-                            name?: string;
-                            description?: string;
-                            is_active?: boolean;
-                            direction?: string;
-                            is_internal?: boolean;
-                            payment_method?: string;
-                            /** @description Associated KYC rails for this order type */
-                            order_types_kyc_rails?: {
-                                /**
-                                 * Format: uuid
-                                 * @description Unique identifier of the association
-                                 */
-                                id?: string;
-                                /**
-                                 * Format: uuid
-                                 * @description ID of the associated KYC rail
-                                 */
-                                kyc_rail_id?: string;
-                            }[];
-                        };
+                        "application/json": components["schemas"]["OrderType"];
                     };
                 };
                 /** @description Order type not found */
@@ -4776,39 +4744,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": {
-                            /** @description Order type identifier (e.g., EXCHANGE, WITHDRAWAL_CRYPTO) */
-                            id?: string;
-                            /** @description Human-readable description of the order type */
-                            description?: string;
-                            /** @description Direction of the order type (in/out) */
-                            direction?: string;
-                            /** @description Whether this is an internal order type */
-                            is_internal?: boolean;
-                            /**
-                             * Format: uuid
-                             * @description Associated KYC rail configuration ID
-                             */
-                            kyc_rails_id?: string | null;
-                            /**
-                             * @description Payment method associated with this order type
-                             * @enum {string|null}
-                             */
-                            payment_method?: "FEDWIRE" | "ACH" | "SWIFT" | "SEPA" | "CHAPS" | "FPS" | "CRYPTO_EXTERNAL" | "CRYPTO_INTERNAL" | null;
-                            /** @description Associated KYC rails for this order type */
-                            order_types_kyc_rails?: {
-                                /**
-                                 * Format: uuid
-                                 * @description Unique identifier of the association
-                                 */
-                                id?: string;
-                                /**
-                                 * Format: uuid
-                                 * @description ID of the associated KYC rail
-                                 */
-                                kyc_rail_id?: string;
-                            }[];
-                        }[];
+                        "application/json": components["schemas"]["OrderType"][];
                     };
                 };
                 /** @description Server error */
@@ -4861,39 +4797,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": {
-                            /** @description Order type identifier (e.g., EXCHANGE, WITHDRAWAL_CRYPTO) */
-                            id?: string;
-                            /** @description Human-readable description of the order type */
-                            description?: string;
-                            /** @description Direction of the order type (in/out) */
-                            direction?: string;
-                            /** @description Whether this is an internal order type */
-                            is_internal?: boolean;
-                            /**
-                             * Format: uuid
-                             * @description Associated KYC rail configuration ID
-                             */
-                            kyc_rails_id?: string | null;
-                            /**
-                             * @description Payment method associated with this order type
-                             * @enum {string|null}
-                             */
-                            payment_method?: "FEDWIRE" | "ACH" | "SWIFT" | "SEPA" | "CHAPS" | "FPS" | "CRYPTO_EXTERNAL" | "CRYPTO_INTERNAL" | null;
-                            /** @description Associated KYC rails for this order type */
-                            order_types_kyc_rails?: {
-                                /**
-                                 * Format: uuid
-                                 * @description Unique identifier of the association
-                                 */
-                                id?: string;
-                                /**
-                                 * Format: uuid
-                                 * @description ID of the associated KYC rail
-                                 */
-                                kyc_rail_id?: string;
-                            }[];
-                        };
+                        "application/json": components["schemas"]["OrderType"];
                     };
                 };
                 /** @description Order type not found */
@@ -8383,6 +8287,74 @@ export interface components {
          * @enum {string}
          */
         OrderTypeId: "EXCHANGE_OMNI" | "EXCHANGE_OMNI_ONRAMP" | "EXCHANGE_OMNI_OFFRAMP" | "EXCHANGE_OMNI_CRYPTO" | "EXCHANGE_CRYPTO_INTERNAL" | "L2F_ACH_ONRAMP" | "L2F_ACH_OFFRAMP" | "L2F_SEPA_ONRAMP" | "L2F_SEPA_OFFRAMP" | "L2F_SWIFT_ONRAMP" | "L2F_SWIFT_OFFRAMP" | "L2F_WIRE_ONRAMP" | "L2F_WIRE_OFFRAMP" | "L2F_CHAPS_ONRAMP" | "L2F_CHAPS_OFFRAMP" | "L2F_FPS_ONRAMP" | "L2F_FPS_OFFRAMP" | "BRL_WIRE_ONRAMP" | "BRL_WIRE_OFFRAMP" | "BRL_ACH_ONRAMP" | "BRL_ACH_OFFRAMP" | "OMNIBUS_CRYPTO_TRANSFER" | "OMNIBUS_CRYPTO_WITHDRAWAL" | "OMNIBUS_INTERNAL_TRANSFER" | "SEGREGATED_CRYPTO_TRANSFER" | "TRANSFER_INTERNAL" | "TRANSFER_CARD_PREPAID" | "TRANSFER_CARD_SUBACCOUNT" | "TRANSFER_CARD_WHOLESALE" | "WITHDRAW_CARD_PREPAID" | "WITHDRAW_CARD_SUBACCOUNT" | "REFUND_CARD_PREPAID" | "REFUND_CARD_SUBACCOUNT" | "RN_CARDS_OFFRAMP" | "CARD_ISSUING_FEE";
+        /** @description Order type reference with optional product guardrails, associated KYC rails and tenant billing rates */
+        OrderType: {
+            /** @description Order type identifier (e.g. EXCHANGE, WITHDRAWAL_CRYPTO) */
+            id?: string;
+            /** @description Human-readable name of the order type */
+            name?: string | null;
+            /** @description Human-readable description of the order type */
+            description?: string;
+            /** @description Direction of the order type (in/out) */
+            direction?: string | null;
+            /** @description Whether this is an internal order type */
+            is_internal?: boolean;
+            /** @description Whether this order type is trusted */
+            is_trusted?: boolean;
+            /**
+             * @description Payment method associated with this order type
+             * @enum {string|null}
+             */
+            payment_method?: "DOMESTIC_WIRE" | "FEDWIRE" | "ACH" | "SWIFT" | "SEPA" | "CHAPS" | "FPS" | "CRYPTO_EXTERNAL" | "CRYPTO_INTERNAL" | null;
+            /**
+             * Format: uuid
+             * @description Associated KYC rail configuration ID
+             */
+            kyc_rails_id?: string | null;
+            /**
+             * @description Optional minimum amount the product should allow for this order type
+             * @example 100
+             */
+            min_amount?: number | null;
+            /**
+             * @description Optional maximum amount the product should allow for this order type
+             * @example 50000
+             */
+            max_amount?: number | null;
+            /** @description Whether payouts for this order type are limited to the wallet owner's own account */
+            first_party_only?: boolean;
+            /** @description Associated KYC rails for this order type */
+            order_types_kyc_rails?: {
+                /**
+                 * Format: uuid
+                 * @description Unique identifier of the association
+                 */
+                id?: string;
+                /**
+                 * Format: uuid
+                 * @description ID of the associated KYC rail
+                 */
+                kyc_rail_id?: string;
+            }[];
+            /** @description Tenant-specific billing rates (present when tenant context is available) */
+            tenant_rates?: {
+                /**
+                 * @description Percentage markup on order volume
+                 * @example 1.8
+                 */
+                markup_percent?: number;
+                /**
+                 * @description Fixed fee per order (USD)
+                 * @example 0
+                 */
+                markup_fixed?: number;
+                /**
+                 * @description Minimum monthly payment (USD)
+                 * @example 0
+                 */
+                mon_min_usd?: number;
+            } | null;
+        };
         SubAccount: {
             /**
              * @description Unique identifier for the sub-account

package/dist/api/types/autogen/apiV1Tenant.types.d.ts

@@ -3761,7 +3761,9 @@ export interface paths {
          *     - When the request is scoped to a tenant (via `x-tenant-id` header or session),
          *       the list is **filtered** to order types enabled for that tenant —
          *       i.e. those having a row in `tenant_order_type_rates`. Each returned item is
-         *       enriched with `tenant_rates` (`markup_percent`, `markup_fixed`, `mon_min_usd`).
+         *       enriched with `tenant_rates` (`markup_percent`, `markup_fixed`, `mon_min_usd`)
+         *       and may expose product-facing guardrails such as `min_amount`,
+         *       `max_amount`, and `first_party_only`.
          *     - Without a tenant scope (admin global view), the full catalogue is returned
          *       and `tenant_rates` is omitted.
          *
@@ -6490,7 +6492,60 @@ export interface paths {
         delete?: never;
         options?: never;
         head?: never;
-        patch?: never;
+        /**
+         * Update sub-account
+         * @description Updates editable fields of a sub-account. Currently only the `nick_name` can be changed.
+         */
+        patch: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    sub_account_id: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        nick_name: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Sub-account updated */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success?: boolean;
+                            data?: components["schemas"]["IssuingSubAccount"];
+                        };
+                    };
+                };
+                /** @description Bad Request — nick_name is required */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Sub-account not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
         trace?: never;
     };
     "/admin/issuing/sub-accounts/{sub_account_id}/transactions": {
@@ -7556,6 +7611,18 @@ export interface components {
             is_internal?: boolean;
             payment_method?: string | null;
             is_trusted?: boolean;
+            /**
+             * @description Optional minimum amount the product should allow for this order type
+             * @example 100
+             */
+            min_amount?: number | null;
+            /**
+             * @description Optional maximum amount the product should allow for this order type
+             * @example 50000
+             */
+            max_amount?: number | null;
+            /** @description Whether payouts for this order type are limited to the wallet owner's own account */
+            first_party_only?: boolean;
             kyc_rails?: {
                 /** Format: uuid */
                 id?: string;
@@ -7669,6 +7736,8 @@ export interface components {
             account_currency?: string;
             /** Format: uuid */
             destination_currency?: string;
+            /** @description Whether deposits are enabled for this account. When false, public (Frontend/Developer) responses suppress deposit_instructions/account_details; admin responses still expose them. */
+            is_deposit_enabled?: boolean;
             /** @description Bank deposit instructions grouped by instruction type (ACH, FEDWIRE, SWIFT) */
             deposit_instructions?: {
                 /**