squarefi-bff-api-module 1.35.3 → 1.36.1

package/dist/api/issuing.d.ts

@@ -9,9 +9,9 @@ export declare const issuing: {
             subAccountCard: (data: API.Cards.Create.SubAccountRequest) => Promise<API.Cards.Create.ExtendedSubAccountResponse>;
         };
         byWalletUuid: {
-            getAll: (params: API.Cards.CardsList.Request.ByWalletUuid) => Promise<API.Cards.CardsList.Response>;
-            getBySubaccountType: (params: API.Cards.CardsList.Request.BySubaccountAndWalletUuid) => Promise<API.Cards.CardsList.Response>;
-            getBySubAccount: (params: API.Cards.CardsList.Request.BySubAccountAndWalletId) => Promise<API.Cards.CardsList.Response>;
+            getAll: ({ limit, offset, ...rest }: API.Cards.CardsList.Request.ByWalletUuid) => Promise<API.Cards.CardsList.Response>;
+            getBySubaccountType: ({ limit, offset, ...rest }: API.Cards.CardsList.Request.BySubaccountAndWalletUuid) => Promise<API.Cards.CardsList.Response>;
+            getBySubAccount: ({ limit, offset, ...rest }: API.Cards.CardsList.Request.BySubAccountAndWalletId) => Promise<API.Cards.CardsList.Response>;
         };
         getById: (card_id: string) => Promise<API.Cards.IssuingCardDetailItem>;
         sensitiveData: {
@@ -33,8 +33,8 @@ export declare const issuing: {
         rename: (card_id: string, nick_name: string) => Promise<API.Cards.IssuingCardDetailItem>;
     };
     transactions: {
-        getByCardId: (card_id: string, limit?: number, offset?: number) => Promise<API.Cards.TransactionsList>;
-        getBySubAccountId: (fiat_account_id: string, limit?: number, offset?: number) => Promise<API.Cards.TransactionsList>;
+        getByCardId: ({ card_id, limit, offset, transaction_type, status, from, to, }: API.Cards.Transactions.List.ByCardIdRequest) => Promise<API.Cards.TransactionsList>;
+        getBySubAccountId: ({ fiat_account_id, limit, offset, transaction_type, status, from, to, }: API.Cards.Transactions.List.BySubAccountIdRequest) => Promise<API.Cards.TransactionsList>;
         csv: {
             getByCardId: (card_id: string) => Promise<string>;
             getBySubAccountId: (sub_account_id: string) => Promise<string>;

package/dist/api/issuing.js

@@ -31,14 +31,14 @@ export const issuing = {
             },
         },
         byWalletUuid: {
-            getAll: (params) => apiClientV1.getRequest('/issuing/cards', {
-                params,
+            getAll: ({ limit = defaultPaginationParams.limit, offset = defaultPaginationParams.offset, ...rest }) => apiClientV1.getRequest('/issuing/cards', {
+                params: { ...rest, limit, offset },
             }),
-            getBySubaccountType: (params) => apiClientV1.getRequest('/issuing/cards', {
-                params,
+            getBySubaccountType: ({ limit = defaultPaginationParams.limit, offset = defaultPaginationParams.offset, ...rest }) => apiClientV1.getRequest('/issuing/cards', {
+                params: { ...rest, limit, offset },
             }),
-            getBySubAccount: (params) => apiClientV1.getRequest('/issuing/cards', {
-                params,
+            getBySubAccount: ({ limit = defaultPaginationParams.limit, offset = defaultPaginationParams.offset, ...rest }) => apiClientV1.getRequest('/issuing/cards', {
+                params: { ...rest, limit, offset },
             }),
         },
         // getById: (card_id: string) => apiClientV1.getRequest<API.Cards.IssuingCardDetailItem>(`/issuing/cards/${card_id}`),
@@ -86,11 +86,11 @@ export const issuing = {
         }),
     },
     transactions: {
-        getByCardId: (card_id, limit = defaultPaginationParams.limit, offset = defaultPaginationParams.offset) => apiClientV1.getRequest(`/issuing/transactions/`, {
-            params: { limit, offset, card_id, new_scheme: true },
+        getByCardId: ({ card_id, limit = defaultPaginationParams.limit, offset = defaultPaginationParams.offset, transaction_type, status, from, to, }) => apiClientV1.getRequest(`/issuing/transactions/`, {
+            params: { limit, offset, card_id, new_scheme: true, transaction_type, status, from, to },
         }),
-        getBySubAccountId: (fiat_account_id, limit = defaultPaginationParams.limit, offset = defaultPaginationParams.offset) => apiClientV1.getRequest(`/issuing/transactions/`, {
-            params: { limit, offset, fiat_account_id, new_scheme: true },
+        getBySubAccountId: ({ fiat_account_id, limit = defaultPaginationParams.limit, offset = defaultPaginationParams.offset, transaction_type, status, from, to, }) => apiClientV1.getRequest(`/issuing/transactions/`, {
+            params: { limit, offset, fiat_account_id, new_scheme: true, transaction_type, status, from, to },
         }),
         csv: {
             getByCardId: (card_id) => apiClientV1.getRequest(`/issuing/transactions/csv`, {

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

@@ -2011,6 +2011,8 @@ export interface paths {
                     sub_account_type?: "prepaid" | "balance";
                     /** @description Filter cards by status */
                     status?: "ACTIVE" | "INACTIVE" | "SUSPENDED" | "CANCELED";
+                    /** @description Filter cards by last 4 digits of the card number (partial, case-insensitive match) */
+                    last4?: string;
                     /** @description Number of items to skip */
                     offset?: number;
                     /** @description Number of items to return */
@@ -3229,7 +3231,81 @@ 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.
+         *
+         *     **Authentication**: x-api-key header required
+         *
+         *     **Access Control**: User must have access to the sub-account
+         *
+         */
+        patch: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description The ID of the sub-account to update */
+                    sub_account_id: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /**
+                         * @description New nickname for the sub-account
+                         * @example Travel budget
+                         */
+                        nick_name: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Sub-account updated successfully */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success?: boolean;
+                            data?: components["schemas"]["IssuingSubAccount"];
+                            /** @example Sub-account updated successfully */
+                            message?: string;
+                        };
+                    };
+                };
+                /** @description Bad Request - nick_name is required */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ApiErrorResponse"];
+                    };
+                };
+                /** @description Access denied to this sub-account */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ApiErrorResponse"];
+                    };
+                };
+                /** @description Sub-account not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ApiErrorResponse"];
+                    };
+                };
+            };
+        };
         trace?: never;
     };
     "/api/issuing/sub-accounts/{sub_account_id}/transactions": {
@@ -5418,7 +5494,8 @@ export interface paths {
          *     from the API key — presence of a rate row is treated as the enable flag.
          *
          *     Each returned item includes a `tenant_rates` object (`markup_percent`,
-         *     `markup_fixed`, `mon_min_usd`).
+         *     `markup_fixed`, `mon_min_usd`) and may expose product-facing guardrails
+         *     such as `min_amount`, `max_amount`, and `first_party_only`.
          *
          *     **Authentication**: x-api-key header required
          *
@@ -7446,8 +7523,11 @@ export interface components {
              * @description External vendor account ID
              */
             vendor_account_id?: string | null;
-            /** @description Bank account details for deposits */
+            /** @description When false, deposit_instructions and account_details are returned as null (deposits disabled for this account) */
+            is_deposit_enabled?: boolean;
+            /** @description Bank account details for deposits. Returned null when is_deposit_enabled is false. */
             account_details?: components["schemas"]["BankAccountDetails"];
+            /** @description Deposit requisites. Returned null when is_deposit_enabled is false. */
             deposit_instructions?: Record<string, never> | null;
             current_balance?: number | null;
             available_balance?: number | null;
@@ -7540,6 +7620,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;
             /** @description Tenant-specific billing rates (present when tenant context is available) */
             tenant_rates?: {
                 /**

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

@@ -1736,6 +1736,8 @@ export interface paths {
                     sub_account_type?: "prepaid" | "balance";
                     /** @description Filter cards by status */
                     status?: "ACTIVE" | "INACTIVE" | "SUSPENDED" | "CANCELED";
+                    /** @description Filter cards by last 4 digits of the card number (partial, case-insensitive match) */
+                    last4?: string;
                     /** @description Number of items to skip */
                     offset?: number;
                     /** @description Number of items to return */
@@ -3008,7 +3010,76 @@ 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.
+         *
+         *     **Authentication**: Bearer token with x-tenant-id header required
+         *
+         *     **Access Control**: User must have ADMIN role on the sub-account's wallet
+         *
+         */
+        patch: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description The ID of the sub-account to update */
+                    sub_account_id: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /**
+                         * @description New nickname for the sub-account
+                         * @example Travel budget
+                         */
+                        nick_name: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Sub-account updated successfully */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success?: boolean;
+                            /** @description Updated sub-account details */
+                            data?: Record<string, never>;
+                            /** @example Sub-account updated successfully */
+                            message?: string;
+                        };
+                    };
+                };
+                /** @description Bad Request - nick_name is required */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Access denied to this sub-account */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Sub-account not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
         trace?: never;
     };
     "/frontend/issuing/sub-accounts/{sub_account_id}/transactions": {
@@ -5151,6 +5222,129 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/frontend/orders/{order_id}/approve": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Approve an order
+         * @description Moves a PENDING order to PROCESSING, triggering its workflow. Validates the order's request_id via OTP.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    order_id: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** Format: uuid */
+                        wallet_id: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Order moved to PROCESSING */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success?: boolean;
+                            data?: components["schemas"]["Order"];
+                        };
+                    };
+                };
+                /** @description Order is not in an approvable state */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/frontend/orders/{order_id}/cancel": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Cancel an order
+         * @description Cancels a PENDING/FAILED order, cancels its workflow run, and refunds the blocked funds.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    order_id: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** Format: uuid */
+                        wallet_id: string;
+                        reason?: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Order canceled and funds refunded */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success?: boolean;
+                            data?: components["schemas"]["Order"];
+                        };
+                    };
+                };
+                /** @description Order is not in a cancelable state */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/frontend/orders/types": {
         parameters: {
             query?: never;
@@ -6091,7 +6285,8 @@ export interface paths {
          *     the enable flag.
          *
          *     Each returned item includes a `tenant_rates` object (`markup_percent`,
-         *     `markup_fixed`, `mon_min_usd`).
+         *     `markup_fixed`, `mon_min_usd`) and may expose product-facing guardrails
+         *     such as `min_amount`, `max_amount`, and `first_party_only`.
          *
          *     **Authentication**: Bearer token + x-tenant-id header
          *
@@ -7076,8 +7271,15 @@ export interface paths {
                         "application/json": {
                             success?: boolean;
                             data?: {
-                                /** @description Wallet name, or null if the wallet has no name set */
-                                wallet_name?: string | null;
+                                /**
+                                 * @description Display label for the wallet. The wallet's own name when set,
+                                 *     otherwise derived from its KYC entity: `business_name` for
+                                 *     businesses, `first_name last_name` for individuals, falling back
+                                 *     to "Business account" / "Individual account" / "New account".
+                                 *
+                                 * @example Acme LLC
+                                 */
+                                wallet_name?: string;
                                 /** @enum {string} */
                                 role?: "user" | "admin";
                             };
@@ -7165,8 +7367,13 @@ export interface paths {
                             data: {
                                 /** Format: uuid */
                                 uuid: string;
-                                /** @description Wallet display name (mirrors POST/PATCH responses) */
+                                /** @description Raw wallet name (may be null) */
                                 name: string | null;
+                                /**
+                                 * @description Computed label — wallet name, else KYC-derived (business_name / first+last), else "New account". Always present.
+                                 * @example Acme LLC
+                                 */
+                                display_name?: string;
                                 /** @description Avatar URL for the wallet */
                                 logo_url: string | null;
                                 /** Format: uuid */
@@ -7234,7 +7441,11 @@ export interface paths {
          * Create wallet
          * @description Creates a new wallet for the authenticated user.
          *
-         *     - **name** is auto-generated if not provided (e.g., "Golden Vault 42")
+         *     - **name** — if provided (non-empty) it is used as-is.
+         *     - When **name** is omitted/blank, **empty_name** decides the fallback:
+         *       - `empty_name: false` or omitted (default) → a random placeholder name
+         *         is generated (e.g., "Golden Vault 42").
+         *       - `empty_name: true` → the wallet is created with `name: null`.
          *
          *     **Authentication**: Bearer token with x-tenant-id header required
          *
@@ -7250,10 +7461,18 @@ export interface paths {
                 content: {
                     "application/json": {
                         /**
-                         * @description Wallet name (auto-generated if not provided)
+                         * @description Wallet name. Used as-is when non-empty.
                          * @example My Main Wallet
                          */
                         name?: string;
+                        /**
+                         * @description Only relevant when `name` is omitted/blank.
+                         *     `true` → store `name: null`; `false`/omitted → generate a random name.
+                         *
+                         * @default false
+                         * @example true
+                         */
+                        empty_name?: boolean;
                     };
                 };
             };
@@ -7272,6 +7491,11 @@ export interface paths {
                                 uuid: string;
                                 /** @example Golden Vault 42 */
                                 name: string | null;
+                                /**
+                                 * @description Computed label — wallet name, else KYC-derived (business_name / first+last), else "New account". Always present.
+                                 * @example Golden Vault 42
+                                 */
+                                display_name?: string;
                                 logo_url: string | null;
                                 /** Format: uuid */
                                 tenant_id: string;
@@ -7539,6 +7763,11 @@ export interface paths {
                                 /** Format: uuid */
                                 uuid: string;
                                 name: string | null;
+                                /**
+                                 * @description Computed label — wallet name, else KYC-derived (business_name / first+last), else "New account". Always present.
+                                 * @example Acme LLC
+                                 */
+                                display_name?: string;
                                 logo_url: string | null;
                                 /** Format: uuid */
                                 tenant_id: string;
@@ -7664,6 +7893,11 @@ export interface paths {
                                 uuid: string;
                                 /** @example My Updated Wallet */
                                 name: string | null;
+                                /**
+                                 * @description Computed label — wallet name, else KYC-derived (business_name / first+last), else "New account". Always present.
+                                 * @example My Updated Wallet
+                                 */
+                                display_name?: string;
                                 logo_url: string | null;
                                 /** Format: uuid */
                                 tenant_id: string;
@@ -9355,8 +9589,11 @@ export interface components {
             /** Format: uuid */
             destination_currency?: string;
             vendor_account_id?: string | null;
-            /** @description Bank account details for deposits */
+            /** @description When false, deposit_instructions and account_details are returned as null (deposits disabled for this account) */
+            is_deposit_enabled?: boolean;
+            /** @description Bank account details for deposits. Returned null when is_deposit_enabled is false. */
             account_details?: Record<string, never> | null;
+            /** @description Deposit requisites. Returned null when is_deposit_enabled is false. */
             deposit_instructions?: Record<string, never> | null;
             current_balance?: number | null;
             available_balance?: number | null;