squarefi-bff-api-module 1.36.31 → 1.36.32

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

@@ -2124,7 +2124,7 @@ export interface paths {
                          * Format: uuid
                          * @description Optional. Binds the card to a wallet member so a scoped `user` role can
                          *     access ONLY this card (view, sensitive data, transactions, freeze/unfreeze),
-                         *     and nothing else in the wallet (SFI-1382). Must be the `user_data.uuid` of an
+                         *     and nothing else in the wallet. Must be the `user_data.uuid` of an
                          *     active member of the target wallet; resolved server-side to the card's owner.
                          *
                          * @example a1b2c3d4-e5f6-7890-abcd-ef1234567890
@@ -2818,11 +2818,13 @@ export interface paths {
         put?: never;
         /**
          * Deposit funds to card
-         * @description Deposits funds to a card from the associated wallet.
+         * @description Thin wrapper over the sub-account deposit: the card's sub-account is
+         *     resolved from `card_id` and the request is processed by the same
+         *     implementation as POST /frontend/issuing/sub-accounts/{sub_account_id}/deposit
+         *     (same order types, validation and program routing).
          *
-         *     **Authentication**: Bearer token with x-tenant-id header required
-         *
-         *     **Access Control**: User must have access to the card
+         *     **Authentication**: Bearer token with x-tenant-id header required.
+         *     **Access Control**: wallet ADMIN role on the card's wallet.
          *
          */
         post: {
@@ -2840,85 +2842,53 @@ export interface paths {
                     "application/json": {
                         /**
                          * Format: uuid
-                         * @description Unique reference ID for idempotency (must be valid UUID)
-                         * @example 550e8400-e29b-41d4-a716-446655440000
+                         * @description Unique reference ID for idempotency
                          */
                         reference_id: string;
                         /**
                          * Format: uuid
-                         * @description UUID of the currency to deduct from wallet
-                         * @example 509eca03-bc0d-4a38-b7dc-d136d2bdaa43
+                         * @description UUID of the currency to deduct from the wallet
                          */
                         from_currency_id: string;
-                        /**
-                         * @description Amount to deposit
-                         * @example 100.5
-                         */
                         amount: number;
-                        /**
-                         * @description Optional description for the deposit
-                         * @example Monthly card funding
-                         */
                         note?: string;
                     };
                 };
             };
             responses: {
-                /** @description Deposit successful */
+                /** @description Deposit order created (COMPLETE, FAILED, or PROCESSING for workflow-routed programs) */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content: {
-                        "application/json": {
-                            /** @example true */
-                            success?: boolean;
-                            data?: {
-                                /**
-                                 * Format: uuid
-                                 * @description Unique order identifier
-                                 */
-                                order_uuid?: string;
-                                /** @description Transaction ID for tracking */
-                                transaction_id?: string;
-                                /** @enum {string} */
-                                status?: "PENDING" | "COMPLETE" | "FAILED";
-                                amount_from?: number;
-                                amount_to?: number;
-                                /** Format: date-time */
-                                created_at?: string;
-                            };
-                        };
-                    };
+                    content?: never;
                 };
-                /** @description Bad Request - One of the following:
-                 *     - Missing required fields
-                 *     - Invalid reference_id format
-                 *     - Invalid amount (must be positive number)
-                 *      */
+                /** @description Validation error */
                 400: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content?: never;
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
                 };
-                /** @description Forbidden - One of the following:
-                 *     - Access denied to this card
-                 *     - Insufficient wallet balance
-                 *     - Topup not allowed (limits exceeded)
-                 *      */
+                /** @description Access denied to this card */
                 403: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content?: never;
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
                 };
-                /** @description Card or wallet not found */
+                /** @description Card or sub-account not found */
                 404: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content?: never;
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
                 };
             };
         };
@@ -2939,13 +2909,14 @@ export interface paths {
         put?: never;
         /**
          * Withdraw funds from card
-         * @description Withdraws funds from a card back to the associated wallet.
-         *
-         *     **Authentication**: Bearer token with x-tenant-id header required
-         *
-         *     **Access Control**: User must have access to the card
+         * @description Thin wrapper over the sub-account withdraw: the card's sub-account is
+         *     resolved from `card_id` and the request is processed by the same
+         *     implementation as POST /frontend/issuing/sub-accounts/{sub_account_id}/withdraw
+         *     (same order types and validation; concurrent withdrawals on the same
+         *     sub-account are rejected with 409).
          *
-         *     **Note**: This endpoint may not be implemented yet.
+         *     **Authentication**: Bearer token with x-tenant-id header required.
+         *     **Access Control**: wallet ADMIN role on the card's wallet.
          *
          */
         post: {
@@ -2961,60 +2932,54 @@ export interface paths {
             requestBody: {
                 content: {
                     "application/json": {
-                        /**
-                         * @description Amount to withdraw
-                         * @example 50
-                         */
+                        /** @description Amount to withdraw back to the wallet */
                         amount: number;
-                        /**
-                         * @description Optional description for the withdrawal
-                         * @example Refund to wallet
-                         */
-                        description?: string;
                     };
                 };
             };
             responses: {
-                /** @description Withdrawal successful */
+                /** @description Withdrawal completed */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content: {
-                        "application/json": {
-                            /** @example true */
-                            success?: boolean;
-                            data?: {
-                                /** Format: uuid */
-                                transaction_id?: string;
-                                amount?: number;
-                                new_balance?: number;
-                                /** @example completed */
-                                status?: string;
-                            };
-                        };
-                    };
+                    content?: never;
                 };
-                /** @description Invalid amount or insufficient card balance */
+                /** @description Validation error */
                 400: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content?: never;
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
                 };
                 /** @description Access denied to this card */
                 403: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content?: never;
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
                 };
-                /** @description Not implemented */
-                501: {
+                /** @description Card or sub-account not found */
+                404: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content?: never;
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Another withdrawal for this sub-account is in progress */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
                 };
             };
         };
@@ -4914,89 +4879,117 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/deposit/ach": {
+    "/frontend/mass-payouts/{wallet_id}": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
-        /**
-         * ACH (coming soon)
-         * @description ACH deposit is not yet implemented. Returns 501.
-         */
-        post: {
+        /** List mass payouts of a wallet */
+        get: {
             parameters: {
-                query?: never;
+                query?: {
+                    status?: "DRAFT" | "PENDING_APPROVAL" | "PROCESSING" | "COMPLETED" | "FAILED" | "CANCELED";
+                    limit?: number;
+                    offset?: number;
+                };
                 header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        /** Format: uuid */
-                        wallet_id: string;
-                        amount?: number;
-                        request_id?: string;
-                    };
+                path: {
+                    /** @description Source wallet the batches belong to */
+                    wallet_id: components["parameters"]["MassPayoutWalletId"];
                 };
+                cookie?: never;
             };
+            requestBody?: never;
             responses: {
-                /** @description Not implemented */
-                501: {
+                /** @description Page of batches, newest first */
+                200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                        "application/json": {
+                            /** @example true */
+                            success?: boolean;
+                            data?: {
+                                items?: components["schemas"]["MassPayout"][];
+                                total?: number;
+                                limit?: number;
+                                offset?: number;
+                            };
+                        };
                     };
                 };
             };
         };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/frontend/orders/deposit/crypto": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
         put?: never;
         /**
-         * Crypto (coming soon)
-         * @description Crypto deposit is not yet implemented. Returns 501.
+         * Create a mass payout draft
+         * @description Creates a batch of payouts to existing counterparty destinations: one
+         *     source wallet, one currency, up to the tenant's batch-size limit of
+         *     recipients (default 100). The draft can be freely edited and
+         *     previewed; nothing moves until it is submitted and approved.
+         *     `virtual_account_id` is required only when the list contains banking
+         *     recipients. Requires an administrative role on the source wallet.
+         *
          */
         post: {
             parameters: {
                 query?: never;
                 header?: never;
-                path?: never;
+                path: {
+                    /** @description Source wallet the batches belong to */
+                    wallet_id: components["parameters"]["MassPayoutWalletId"];
+                };
                 cookie?: never;
             };
             requestBody: {
                 content: {
                     "application/json": {
                         /** Format: uuid */
-                        wallet_id: string;
-                        amount?: number;
+                        currency_id: string;
                         /** Format: uuid */
-                        currency_id?: string;
-                        request_id?: string;
+                        virtual_account_id?: string;
+                        name: string;
+                        items: components["schemas"]["MassPayoutItemInput"][];
                     };
                 };
             };
             responses: {
-                /** @description Not implemented */
-                501: {
+                /** @description Draft created */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success?: boolean;
+                            data?: components["schemas"]["MassPayout"];
+                        };
+                    };
+                };
+                /** @description Validation error (including the batch-size limit) */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Caller lacks permission on the source wallet */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Rate limit exceeded */
+                429: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -5012,39 +5005,42 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/deposit/pix": {
+    "/frontend/mass-payouts/{wallet_id}/{id}": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
-        /**
-         * PIX (coming soon)
-         * @description PIX deposit is not yet implemented. Returns 501.
-         */
-        post: {
+        /** Get a mass payout */
+        get: {
             parameters: {
                 query?: never;
                 header?: never;
-                path?: never;
+                path: {
+                    /** @description Source wallet the batches belong to */
+                    wallet_id: components["parameters"]["MassPayoutWalletId"];
+                    id: components["parameters"]["MassPayoutId"];
+                };
                 cookie?: never;
             };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        /** Format: uuid */
-                        wallet_id: string;
-                        amount?: number;
-                        request_id?: string;
+            requestBody?: never;
+            responses: {
+                /** @description Batch details with progress counters and total amount */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success?: boolean;
+                            data?: components["schemas"]["MassPayout"];
+                        };
                     };
                 };
-            };
-            responses: {
-                /** @description Not implemented */
-                501: {
+                /** @description Mass payout not found */
+                404: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -5054,45 +5050,42 @@ export interface paths {
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/deposit/card": {
+    "/frontend/mass-payouts/{wallet_id}/{id}/items": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
         /**
-         * Card
-         * @description Returns funds from a card sub-account back to a wallet.
+         * List items of a mass payout
+         * @description Items in upload order, paginated with limit/offset like the batch list.
          */
-        post: {
+        get: {
             parameters: {
-                query?: never;
+                query?: {
+                    limit?: number;
+                    offset?: number;
+                };
                 header?: never;
-                path?: never;
+                path: {
+                    /** @description Source wallet the batches belong to */
+                    wallet_id: components["parameters"]["MassPayoutWalletId"];
+                    id: components["parameters"]["MassPayoutId"];
+                };
                 cookie?: never;
             };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        /** Format: uuid */
-                        wallet_id: string;
-                        amount: number;
-                        /** Format: uuid */
-                        sub_account_id: string;
-                    };
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description Card return order created */
+                /** @description Page of items */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5101,95 +5094,54 @@ export interface paths {
                         "application/json": {
                             /** @example true */
                             success?: boolean;
-                            data?: components["schemas"]["Order"];
-                            /** @example Card return order created */
-                            message?: string;
+                            data?: {
+                                items?: components["schemas"]["MassPayoutItem"][];
+                                total?: number;
+                                limit?: number;
+                                offset?: number;
+                            };
                         };
                     };
                 };
-                /** @description Missing required fields or invalid amount */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Authentication required */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Caller is not an admin of the wallet */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Card return failed */
-                500: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/exchange": {
+    "/frontend/mass-payouts/{wallet_id}/{id}/preview": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
         /**
-         * Exchange
-         * @description Currency exchange within a wallet — a pure ledger swap for any enabled
-         *     currency pair (crypto and fiat alike). Pair availability is governed by
-         *     the exchange calculation config: a disabled pair is rejected at create.
-         *
-         *     Two-phase, like the banking withdrawals: the order is created in status
-         *     `NEW` without touching the balance. Call `POST /frontend/orders/{order_id}/approve`
-         *     (OTP-gated, keyed on the order id) to check the balance, debit the
-         *     source funds and execute the swap — the order lands in `COMPLETE`
-         *     synchronously — or `POST /frontend/orders/{order_id}/cancel` to
-         *     discard the order.
-         *
-         *     Caller must be `admin` of the wallet.
+         * Preview a mass payout
+         * @description Dry-run before submitting: validates every recipient, estimates the fee
+         *     per item through the tenant's pricing, sums the total debit and checks
+         *     it against the wallet balance. Crypto payouts to on-platform addresses
+         *     may execute cheaper than estimated (they settle internally).
          *
          */
-        post: {
+        get: {
             parameters: {
                 query?: never;
                 header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": components["schemas"]["FrontendExchangeOrderRequest"];
+                path: {
+                    /** @description Source wallet the batches belong to */
+                    wallet_id: components["parameters"]["MassPayoutWalletId"];
+                    id: components["parameters"]["MassPayoutId"];
                 };
+                cookie?: never;
             };
+            requestBody?: never;
             responses: {
-                /** @description Exchange order created (status NEW — approve to debit and execute) */
+                /** @description Validation report, fee estimates and balance check */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5198,55 +5150,55 @@ export interface paths {
                         "application/json": {
                             /** @example true */
                             success?: boolean;
-                            data?: components["schemas"]["Order"];
+                            data?: {
+                                /** Format: uuid */
+                                id?: string;
+                                /** Format: uuid */
+                                currency_id?: string;
+                                total_items?: number;
+                                total_amount?: number;
+                                total_fees?: number;
+                                total_debit?: number;
+                                balance?: {
+                                    available?: number;
+                                    sufficient?: boolean;
+                                };
+                                valid_count?: number;
+                                invalid_count?: number;
+                                items?: {
+                                    /** Format: uuid */
+                                    item_id?: string;
+                                    position?: number;
+                                    /** Format: uuid */
+                                    destination_id?: string;
+                                    amount?: number;
+                                    fee?: number;
+                                    debit_amount?: number;
+                                    result_amount?: number;
+                                }[];
+                                problems?: {
+                                    /** Format: uuid */
+                                    item_id?: string;
+                                    position?: number;
+                                    /** Format: uuid */
+                                    destination_id?: string;
+                                    error?: string;
+                                }[];
+                            };
                         };
                     };
                 };
-                /** @description Validation error (insufficient balance, virtual account missing, etc.) */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Authentication required */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Caller is not an admin of the wallet */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Rate limit exceeded */
-                429: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/withdrawal/internal": {
+    "/frontend/mass-payouts/{wallet_id}/{id}/submit": {
         parameters: {
             query?: never;
             header?: never;
@@ -5256,46 +5208,25 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Internal
-         * @description Transfers funds between two wallets within the platform. Two-phase:
-         *     the order is created in `NEW` status without touching the balance;
-         *     `POST /frontend/orders/{id}/approve` (OTP-gated, keyed on the order
-         *     id) checks the balance, debits the sender and executes the transfer
-         *     synchronously — receiver credited, order `COMPLETE`. A `NEW` order
-         *     can simply be canceled (no funds are held).
-         *     Caller must be `admin` of the source wallet.
+         * Submit a mass payout for approval
+         * @description DRAFT → PENDING_APPROVAL. Refused while any recipient is invalid — the
+         *     problems are returned in the error details so the rows can be fixed.
          *
          */
         post: {
             parameters: {
                 query?: never;
                 header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        /**
-                         * Format: uuid
-                         * @description Source wallet UUID
-                         */
-                        wallet_id: string;
-                        /** Format: uuid */
-                        from_currency_id: string;
-                        /**
-                         * Format: uuid
-                         * @description Counterparty destination of type INTERNAL (points at the receiver wallet).
-                         */
-                        counterparty_destination_id: string;
-                        amount: number;
-                        /** @description Optional supporting documents persisted with the order. */
-                        documents?: components["schemas"]["OrderDocumentInput"][];
-                    };
+                path: {
+                    /** @description Source wallet the batches belong to */
+                    wallet_id: components["parameters"]["MassPayoutWalletId"];
+                    id: components["parameters"]["MassPayoutId"];
                 };
+                cookie?: never;
             };
+            requestBody?: never;
             responses: {
-                /** @description Transfer created in NEW status (awaiting approve; no funds held) */
+                /** @description Batch is awaiting approval */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5304,11 +5235,11 @@ export interface paths {
                         "application/json": {
                             /** @example true */
                             success?: boolean;
-                            data?: components["schemas"]["Order"];
+                            data?: components["schemas"]["MassPayout"];
                         };
                     };
                 };
-                /** @description Validation error */
+                /** @description Batch has invalid items (details carry the per-item problems) */
                 400: {
                     headers: {
                         [name: string]: unknown;
@@ -5317,26 +5248,8 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Authentication required */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Caller is not an admin of the source wallet */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Rate limit exceeded */
-                429: {
+                /** @description Batch is not in DRAFT */
+                409: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -5352,7 +5265,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/withdrawal/crypto": {
+    "/frontend/mass-payouts/{wallet_id}/{id}/approve": {
         parameters: {
             query?: never;
             header?: never;
@@ -5362,31 +5275,29 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Crypto
-         * @description Sends crypto from an omnibus wallet to an external address. Two-phase:
-         *     the order is created in `NEW` status without touching the balance;
-         *     `POST /frontend/orders/{id}/approve` (OTP-gated, keyed on the order
-         *     id) checks the balance, debits the funds and dispatches the on-chain
-         *     send. If the destination address belongs to a wallet in the same
-         *     tenant, the order is created as `OMNIBUS_INTERNAL_TRANSFER` (no
-         *     on-chain transaction) — still `NEW` at create, debited + settled
-         *     synchronously to `COMPLETE` at approve.
+         * Approve a mass payout
+         * @description PENDING_APPROVAL → PROCESSING and starts the asynchronous execution:
+         *     every item becomes a regular order (created and approved through the
+         *     standard order flow, funds are debited per order). Requires an
+         *     administrative wallet role and a recent second-factor verification — a stale one is rejected
+         *     with `TWO_FACTOR_REVERIFICATION_REQUIRED`. Execution continues past
+         *     failed items; progress is visible through the batch counters.
          *
          */
         post: {
             parameters: {
                 query?: never;
                 header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": components["schemas"]["FrontendCryptoTransferRequest"];
+                path: {
+                    /** @description Source wallet the batches belong to */
+                    wallet_id: components["parameters"]["MassPayoutWalletId"];
+                    id: components["parameters"]["MassPayoutId"];
                 };
+                cookie?: never;
             };
+            requestBody?: never;
             responses: {
-                /** @description Crypto withdrawal created */
+                /** @description Execution started */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5395,29 +5306,11 @@ export interface paths {
                         "application/json": {
                             /** @example true */
                             success?: boolean;
-                            data?: components["schemas"]["Order"];
+                            data?: components["schemas"]["MassPayout"];
                         };
                     };
                 };
-                /** @description Validation error */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Authentication required */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Caller is not an admin of the source wallet */
+                /** @description Second-factor verification is stale or the caller lacks permission */
                 403: {
                     headers: {
                         [name: string]: unknown;
@@ -5426,8 +5319,8 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Rate limit exceeded */
-                429: {
+                /** @description Batch is not awaiting approval */
+                409: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -5443,7 +5336,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/withdrawal/wire": {
+    "/frontend/mass-payouts/{wallet_id}/{id}/cancel": {
         parameters: {
             query?: never;
             header?: never;
@@ -5452,21 +5345,24 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Wire */
+        /**
+         * Cancel a mass payout
+         * @description Allowed from DRAFT and PENDING_APPROVAL. A PROCESSING batch cannot be canceled — payouts are already executing.
+         */
         post: {
             parameters: {
                 query?: never;
                 header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": components["schemas"]["FrontendL2FOrderRequest"];
+                path: {
+                    /** @description Source wallet the batches belong to */
+                    wallet_id: components["parameters"]["MassPayoutWalletId"];
+                    id: components["parameters"]["MassPayoutId"];
                 };
+                cookie?: never;
             };
+            requestBody?: never;
             responses: {
-                /** @description Wire withdrawal created */
+                /** @description Batch canceled */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5475,21 +5371,12 @@ export interface paths {
                         "application/json": {
                             /** @example true */
                             success?: boolean;
-                            data?: components["schemas"]["Order"];
+                            data?: components["schemas"]["MassPayout"];
                         };
                     };
                 };
-                /** @description Validation error */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Authentication required */
-                401: {
+                /** @description Batch can no longer be canceled */
+                409: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -5497,17 +5384,51 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Caller is not an admin of the source wallet */
-                403: {
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/frontend/mass-payouts/{wallet_id}/{id}/report.csv": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Download the mass payout report (CSV)
+         * @description Streaming CSV: recipient, amount, item status, the linked order and its
+         *     current status, and the failure reason for every unsuccessful payout.
+         *
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Source wallet the batches belong to */
+                    wallet_id: components["parameters"]["MassPayoutWalletId"];
+                    id: components["parameters"]["MassPayoutId"];
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description CSV file */
+                200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                        "text/csv": string;
                     };
                 };
-                /** @description Rate limit exceeded */
-                429: {
+                /** @description Mass payout not found */
+                404: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -5517,13 +5438,15 @@ export interface paths {
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/withdrawal/ach": {
+    "/frontend/orders/deposit/ach": {
         parameters: {
             query?: never;
             header?: never;
@@ -5532,7 +5455,10 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** ACH */
+        /**
+         * ACH (coming soon)
+         * @description ACH deposit is not yet implemented. Returns 501.
+         */
         post: {
             parameters: {
                 query?: never;
@@ -5542,34 +5468,67 @@ export interface paths {
             };
             requestBody: {
                 content: {
-                    "application/json": components["schemas"]["FrontendL2FOrderRequest"];
+                    "application/json": {
+                        /** Format: uuid */
+                        wallet_id: string;
+                        amount?: number;
+                        request_id?: string;
+                    };
                 };
             };
             responses: {
-                /** @description ACH withdrawal created */
-                200: {
+                /** @description Not implemented */
+                501: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": {
-                            /** @example true */
-                            success?: boolean;
-                            data?: components["schemas"]["Order"];
-                        };
+                        "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Validation error */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/frontend/orders/deposit/crypto": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Crypto (coming soon)
+         * @description Crypto deposit is not yet implemented. Returns 501.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** Format: uuid */
+                        wallet_id: string;
+                        amount?: number;
+                        /** Format: uuid */
+                        currency_id?: string;
+                        request_id?: string;
                     };
                 };
-                /** @description Authentication required */
-                401: {
+            };
+            responses: {
+                /** @description Not implemented */
+                501: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -5577,17 +5536,47 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Caller is not an admin of the source wallet */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/frontend/orders/deposit/pix": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * PIX (coming soon)
+         * @description PIX deposit is not yet implemented. Returns 501.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** Format: uuid */
+                        wallet_id: string;
+                        amount?: number;
+                        request_id?: string;
                     };
                 };
-                /** @description Rate limit exceeded */
-                429: {
+            };
+            responses: {
+                /** @description Not implemented */
+                501: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -5603,7 +5592,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/withdrawal/sepa": {
+    "/frontend/orders/exchange": {
         parameters: {
             query?: never;
             header?: never;
@@ -5612,7 +5601,22 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** SEPA */
+        /**
+         * Exchange
+         * @description Currency exchange within a wallet — a pure ledger swap for any enabled
+         *     currency pair (crypto and fiat alike). Pair availability is governed by
+         *     the exchange calculation config: a disabled pair is rejected at create.
+         *
+         *     Two-phase, like the banking withdrawals: the order is created in status
+         *     `NEW` without touching the balance. Call `POST /frontend/orders/{order_id}/approve`
+         *     (OTP-gated, keyed on the order id) to check the balance, debit the
+         *     source funds and execute the swap — the order lands in `COMPLETE`
+         *     synchronously — or `POST /frontend/orders/{order_id}/cancel` to
+         *     discard the order.
+         *
+         *     Caller must be `admin` of the wallet.
+         *
+         */
         post: {
             parameters: {
                 query?: never;
@@ -5622,11 +5626,11 @@ export interface paths {
             };
             requestBody: {
                 content: {
-                    "application/json": components["schemas"]["FrontendL2FOrderRequest"];
+                    "application/json": components["schemas"]["FrontendExchangeOrderRequest"];
                 };
             };
             responses: {
-                /** @description SEPA withdrawal created */
+                /** @description Exchange order created (status NEW — approve to debit and execute) */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5639,7 +5643,7 @@ export interface paths {
                         };
                     };
                 };
-                /** @description Validation error */
+                /** @description Validation error (insufficient balance, virtual account missing, etc.) */
                 400: {
                     headers: {
                         [name: string]: unknown;
@@ -5657,7 +5661,7 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Caller is not an admin of the source wallet */
+                /** @description Caller is not an admin of the wallet */
                 403: {
                     headers: {
                         [name: string]: unknown;
@@ -5683,7 +5687,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/withdrawal/swift": {
+    "/frontend/orders/withdrawal/internal": {
         parameters: {
             query?: never;
             header?: never;
@@ -5692,7 +5696,17 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** SWIFT */
+        /**
+         * Internal
+         * @description Transfers funds between two wallets within the platform. Two-phase:
+         *     the order is created in `NEW` status without touching the balance;
+         *     `POST /frontend/orders/{id}/approve` (OTP-gated, keyed on the order
+         *     id) checks the balance, debits the sender and executes the transfer
+         *     synchronously — receiver credited, order `COMPLETE`. A `NEW` order
+         *     can simply be canceled (no funds are held).
+         *     Caller must be `admin` of the source wallet.
+         *
+         */
         post: {
             parameters: {
                 query?: never;
@@ -5702,11 +5716,32 @@ export interface paths {
             };
             requestBody: {
                 content: {
-                    "application/json": components["schemas"]["FrontendL2FOrderRequest"];
+                    "application/json": {
+                        /**
+                         * Format: uuid
+                         * @description Source wallet UUID
+                         */
+                        wallet_id: string;
+                        /** Format: uuid */
+                        from_currency_id: string;
+                        /**
+                         * Format: uuid
+                         * @description Counterparty destination of type INTERNAL (points at the receiver wallet).
+                         */
+                        counterparty_destination_id: string;
+                        amount: number;
+                        /**
+                         * Format: date-time
+                         * @description Optional. Schedule the transfer for a future time (min 1 hour, max 90 days ahead). No funds are reserved; after approval the order waits in EXPECTED status and executes automatically.
+                         */
+                        scheduled_at?: string;
+                        /** @description Optional supporting documents persisted with the order. */
+                        documents?: components["schemas"]["OrderDocumentInput"][];
+                    };
                 };
             };
             responses: {
-                /** @description SWIFT withdrawal created */
+                /** @description Transfer created in NEW status (awaiting approve; no funds held) */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5763,7 +5798,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/withdrawal/chaps": {
+    "/frontend/orders/withdrawal/crypto": {
         parameters: {
             query?: never;
             header?: never;
@@ -5772,7 +5807,18 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** CHAPS */
+        /**
+         * Crypto
+         * @description Sends crypto from an omnibus wallet to an external address. Two-phase:
+         *     the order is created in `NEW` status without touching the balance;
+         *     `POST /frontend/orders/{id}/approve` (OTP-gated, keyed on the order
+         *     id) checks the balance, debits the funds and dispatches the on-chain
+         *     send. If the destination address belongs to a wallet in the same
+         *     tenant, the order is created as `OMNIBUS_INTERNAL_TRANSFER` (no
+         *     on-chain transaction) — still `NEW` at create, debited + settled
+         *     synchronously to `COMPLETE` at approve.
+         *
+         */
         post: {
             parameters: {
                 query?: never;
@@ -5782,11 +5828,11 @@ export interface paths {
             };
             requestBody: {
                 content: {
-                    "application/json": components["schemas"]["FrontendL2FOrderRequest"];
+                    "application/json": components["schemas"]["FrontendCryptoTransferRequest"];
                 };
             };
             responses: {
-                /** @description CHAPS withdrawal created */
+                /** @description Crypto withdrawal created */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5843,7 +5889,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/withdrawal/fps": {
+    "/frontend/orders/withdrawal/wire": {
         parameters: {
             query?: never;
             header?: never;
@@ -5852,7 +5898,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** FPS */
+        /** Wire */
         post: {
             parameters: {
                 query?: never;
@@ -5866,7 +5912,7 @@ export interface paths {
                 };
             };
             responses: {
-                /** @description FPS withdrawal created */
+                /** @description Wire withdrawal created */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5923,7 +5969,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/withdrawal/card": {
+    "/frontend/orders/withdrawal/ach": {
         parameters: {
             query?: never;
             header?: never;
@@ -5932,10 +5978,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /**
-         * Card
-         * @description Funds a card sub-account from a wallet.
-         */
+        /** ACH */
         post: {
             parameters: {
                 query?: never;
@@ -5945,32 +5988,11 @@ export interface paths {
             };
             requestBody: {
                 content: {
-                    "application/json": {
-                        /** Format: uuid */
-                        wallet_id: string;
-                        amount: number;
-                        /**
-                         * Format: uuid
-                         * @description Source currency UUID
-                         */
-                        from_uuid: string;
-                        /** Format: uuid */
-                        sub_account_id: string;
-                        /**
-                         * Format: uuid
-                         * @description Optional specific card ID
-                         */
-                        card_id?: string;
-                        /** @description Idempotency key */
-                        reference_id?: string;
-                        note?: string;
-                        /** @description Optional supporting documents persisted with the order. */
-                        documents?: components["schemas"]["OrderDocumentInput"][];
-                    };
+                    "application/json": components["schemas"]["FrontendL2FOrderRequest"];
                 };
             };
             responses: {
-                /** @description Card topup order created */
+                /** @description ACH withdrawal created */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5980,12 +6002,10 @@ export interface paths {
                             /** @example true */
                             success?: boolean;
                             data?: components["schemas"]["Order"];
-                            /** @example Card topup order created */
-                            message?: string;
                         };
                     };
                 };
-                /** @description Missing required fields or invalid amount */
+                /** @description Validation error */
                 400: {
                     headers: {
                         [name: string]: unknown;
@@ -6012,8 +6032,8 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Card topup failed */
-                500: {
+                /** @description Rate limit exceeded */
+                429: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -6029,7 +6049,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/{order_id}/approve": {
+    "/frontend/orders/withdrawal/sepa": {
         parameters: {
             query?: never;
             header?: never;
@@ -6038,36 +6058,21 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /**
-         * Approve an order
-         * @description Moves a NEW order to PROCESSING: checks the balance, debits the funds
-         *     (transaction written as `complete`) and triggers its workflow.
-         *     Exchange orders (EXCHANGE_OMNI) and internal transfers
-         *     (TRANSFER_INTERNAL / OMNIBUS_INTERNAL_TRANSFER) settle synchronously
-         *     and land in COMPLETE. An insufficient balance fails the order
-         *     (FAILED). OTP verification is mandatory and keyed on the order id
-         *     (request the OTP for the order being approved).
-         *
-         */
+        /** SEPA */
         post: {
             parameters: {
                 query?: never;
                 header?: never;
-                path: {
-                    order_id: string;
-                };
+                path?: never;
                 cookie?: never;
             };
             requestBody: {
                 content: {
-                    "application/json": {
-                        /** Format: uuid */
-                        wallet_id: string;
-                    };
+                    "application/json": components["schemas"]["FrontendL2FOrderRequest"];
                 };
             };
             responses: {
-                /** @description Order moved to PROCESSING */
+                /** @description SEPA withdrawal created */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -6080,8 +6085,35 @@ export interface paths {
                         };
                     };
                 };
-                /** @description Order is not in an approvable state */
-                409: {
+                /** @description Validation error */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Caller is not an admin of the source wallet */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Rate limit exceeded */
+                429: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -6097,7 +6129,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/{order_id}/cancel": {
+    "/frontend/orders/withdrawal/swift": {
         parameters: {
             query?: never;
             header?: never;
@@ -6106,30 +6138,21 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /**
-         * Cancel an order
-         * @description Cancels a NEW/FAILED order, cancels its workflow run, and refunds the debited funds (if the order was ever approved).
-         */
+        /** SWIFT */
         post: {
             parameters: {
                 query?: never;
                 header?: never;
-                path: {
-                    order_id: string;
-                };
+                path?: never;
                 cookie?: never;
             };
             requestBody: {
                 content: {
-                    "application/json": {
-                        /** Format: uuid */
-                        wallet_id: string;
-                        reason?: string;
-                    };
+                    "application/json": components["schemas"]["FrontendL2FOrderRequest"];
                 };
             };
             responses: {
-                /** @description Order canceled (debited funds refunded when applicable) */
+                /** @description SWIFT withdrawal created */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -6142,8 +6165,35 @@ export interface paths {
                         };
                     };
                 };
-                /** @description Order is not in a cancelable state */
-                409: {
+                /** @description Validation error */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Caller is not an admin of the source wallet */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Rate limit exceeded */
+                429: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -6159,7 +6209,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/{order_id}/comment": {
+    "/frontend/orders/withdrawal/chaps": {
         parameters: {
             query?: never;
             header?: never;
@@ -6167,39 +6217,22 @@ export interface paths {
             cookie?: never;
         };
         get?: never;
-        /**
-         * Set or clear an order's comment
-         * @description Saves (or edits) a single free-text comment attached to an order
-         *     (incoming or outgoing). Useful for noting who an incoming crypto deposit
-         *     came from. Send `comment: null` or an empty string to clear it.
-         *
-         *     The response includes the saved `comment` plus audit metadata
-         *     (`comment_updated_by` = editor's user_data uuid, `comment_updated_at`).
-         *
-         *     **Access Control**: caller must be `admin` or `owner` of the order's wallet.
-         *
-         */
-        put: {
+        put?: never;
+        /** CHAPS */
+        post: {
             parameters: {
                 query?: never;
                 header?: never;
-                path: {
-                    order_id: string;
-                };
+                path?: never;
                 cookie?: never;
             };
             requestBody: {
                 content: {
-                    "application/json": {
-                        /** Format: uuid */
-                        wallet_id: string;
-                        /** @description Comment text. `null` or empty clears the comment. */
-                        comment?: string | null;
-                    };
+                    "application/json": components["schemas"]["FrontendL2FOrderRequest"];
                 };
             };
             responses: {
-                /** @description Comment saved */
+                /** @description CHAPS withdrawal created */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -6212,7 +6245,7 @@ export interface paths {
                         };
                     };
                 };
-                /** @description Validation error (e.g. comment too long) */
+                /** @description Validation error */
                 400: {
                     headers: {
                         [name: string]: unknown;
@@ -6221,7 +6254,16 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Access denied (insufficient wallet role / wrong wallet) */
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Caller is not an admin of the source wallet */
                 403: {
                     headers: {
                         [name: string]: unknown;
@@ -6230,8 +6272,8 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Order not found */
-                404: {
+                /** @description Rate limit exceeded */
+                429: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -6241,138 +6283,200 @@ export interface paths {
                 };
             };
         };
-        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/types": {
+    "/frontend/orders/withdrawal/fps": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /**
-         * List order types
-         * @description Retrieves a list of available order types for the tenant.
-         *
-         *     **Authentication**: Bearer token with x-tenant-id header required
-         *
-         */
-        get: {
+        get?: never;
+        put?: never;
+        /** FPS */
+        post: {
             parameters: {
                 query?: never;
                 header?: never;
                 path?: never;
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["FrontendL2FOrderRequest"];
+                };
+            };
             responses: {
-                /** @description List of available order types */
+                /** @description FPS withdrawal created */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content?: never;
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success?: boolean;
+                            data?: components["schemas"]["Order"];
+                        };
+                    };
+                };
+                /** @description Validation error */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Caller is not an admin of the source wallet */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Rate limit exceeded */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
                 };
             };
         };
-        put?: never;
-        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/types/{id}": {
+    "/frontend/orders/{order_id}/approve": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
+        get?: never;
+        put?: never;
         /**
-         * Get order type
-         * @description Retrieves details of a specific order type by ID.
-         *
-         *     **Authentication**: Bearer token with x-tenant-id header required
+         * Approve an order
+         * @description Moves a NEW order to PROCESSING: checks the balance, debits the funds
+         *     (transaction written as `complete`) and triggers its workflow.
+         *     Exchange orders (EXCHANGE_OMNI) and internal transfers
+         *     (TRANSFER_INTERNAL / OMNIBUS_INTERNAL_TRANSFER) settle synchronously
+         *     and land in COMPLETE. An insufficient balance fails the order
+         *     (FAILED). OTP verification is mandatory and keyed on the order id
+         *     (request the OTP for the order being approved). Orders created with
+         *     `scheduled_at` move to EXPECTED instead — no funds are debited until
+         *     execution at the requested time.
          *
          */
-        get: {
+        post: {
             parameters: {
                 query?: never;
                 header?: never;
                 path: {
-                    id: string;
+                    order_id: string;
                 };
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** Format: uuid */
+                        wallet_id: string;
+                    };
+                };
+            };
             responses: {
-                /** @description Order type details */
+                /** @description Order moved to PROCESSING */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content?: never;
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success?: boolean;
+                            data?: components["schemas"]["Order"];
+                        };
+                    };
                 };
-                /** @description Order type not found */
-                404: {
+                /** @description Order is not in an approvable state */
+                409: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content?: never;
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
                 };
             };
         };
-        put?: never;
-        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/calc": {
+    "/frontend/orders/{order_id}/cancel": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
+        get?: never;
+        put?: never;
         /**
-         * Calculate order
-         * @description Pre-calculates order amounts, fees and exchange rates without creating an order.
-         *
-         *     **Authentication**: Bearer token with x-tenant-id header required
+         * Cancel an order
+         * @description Cancels a NEW or EXPECTED order and cancels its workflow run. Neither
+         *     status holds debited funds, so cancel never moves money.
+         *     BREAKING CHANGE (2026-07-26): FAILED is no longer cancelable and returns
+         *     409. Paying back an order that was debited and then failed is now a
+         *     separate, admin-panel-only refund action.
          *
          */
-        get: {
+        post: {
             parameters: {
-                query: {
-                    order_type: components["schemas"]["OrderTypeId"];
-                    amount: number;
-                    from_currency_id: string;
-                    to_currency_id: string;
-                    /** @description If `true`, calculates inputs needed to receive the given amount. */
-                    is_reverse: boolean;
-                    /** @description If `true`, the network fee is subtracted from `result_amount`. If `false`, the fee is added on top of `from_amount` and the recipient gets the full converted amount. Ignored for reverse calculations. Required so the client always states the fee-allocation mode explicitly — a change of the server-side fallback can never silently alter the calculation.
-                     *      */
-                    is_subtract: boolean;
-                    /** @description Destination address (for crypto withdrawals; affects network fee estimation). */
-                    to_address?: string;
-                };
+                query?: never;
                 header?: never;
-                path?: never;
+                path: {
+                    order_id: string;
+                };
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** Format: uuid */
+                        wallet_id: string;
+                        reason?: string;
+                    };
+                };
+            };
             responses: {
-                /** @description Calculated order details */
+                /** @description Order canceled (no balance change) */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -6380,22 +6484,13 @@ export interface paths {
                     content: {
                         "application/json": {
                             /** @example true */
-                            success: boolean;
-                            data: components["schemas"]["OrderCalculation"];
+                            success?: boolean;
+                            data?: components["schemas"]["Order"];
                         };
                     };
                 };
-                /** @description Invalid request (e.g. unknown `order_type`, missing required parameter, exchange rate not found) */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Calculation failed (e.g. network fee estimation error) */
-                500: {
+                /** @description Order is not in a cancelable state */
+                409: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -6405,53 +6500,53 @@ export interface paths {
                 };
             };
         };
-        put?: never;
-        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/wallet/{wallet_uuid}": {
+    "/frontend/orders/{order_id}/comment": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
+        get?: never;
         /**
-         * List orders
-         * @description Retrieves a paginated list of orders for a specific wallet.
+         * Set or clear an order's comment
+         * @description Saves (or edits) a single free-text comment attached to an order
+         *     (incoming or outgoing). Useful for noting who an incoming crypto deposit
+         *     came from. Send `comment: null` or an empty string to clear it.
          *
-         *     **Authentication**: Bearer token with x-tenant-id header required
+         *     The response includes the saved `comment` plus audit metadata
+         *     (`comment_updated_by` = editor's user_data uuid, `comment_updated_at`).
          *
-         *     **Access Control**: User must have access to the wallet
+         *     **Access Control**: caller must be `admin` or `owner` of the order's wallet.
          *
          */
-        get: {
+        put: {
             parameters: {
-                query?: {
-                    offset?: number;
-                    limit?: number;
-                    sort_by?: string;
-                    sort_order?: "asc" | "desc";
-                    /** @description JSON-encoded filters */
-                    filters?: string;
-                    date_from?: string;
-                    date_to?: string;
-                    /** @description If `true`, includes dust orders (amount below render threshold for either currency). Defaults to `false` — dust orders are hidden. */
-                    show_low_balance?: "true" | "false";
-                };
+                query?: never;
                 header?: never;
                 path: {
-                    wallet_uuid: string;
+                    order_id: string;
                 };
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** Format: uuid */
+                        wallet_id: string;
+                        /** @description Comment text. `null` or empty clears the comment. */
+                        comment?: string | null;
+                    };
+                };
+            };
             responses: {
-                /** @description List of orders */
+                /** @description Comment saved */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -6459,22 +6554,40 @@ export interface paths {
                     content: {
                         "application/json": {
                             /** @example true */
-                            success: boolean;
-                            data: components["schemas"]["Order"][];
-                            pagination: components["schemas"]["PaginationResponse"];
+                            success?: boolean;
+                            data?: components["schemas"]["Order"];
                         };
                     };
                 };
-                /** @description Access denied to wallet */
+                /** @description Validation error (e.g. comment too long) */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Access denied (insufficient wallet role / wrong wallet) */
                 403: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content?: never;
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Order not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
                 };
             };
         };
-        put?: never;
         post?: never;
         delete?: never;
         options?: never;
@@ -6482,7 +6595,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/wallet/{wallet_uuid}/csv": {
+    "/frontend/orders/types": {
         parameters: {
             query?: never;
             header?: never;
@@ -6490,43 +6603,23 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Export orders
-         * @description Exports orders for a specific wallet as a CSV file.
+         * List order types
+         * @description Retrieves a list of available order types for the tenant.
          *
          *     **Authentication**: Bearer token with x-tenant-id header required
          *
-         *     **Access Control**: User must have access to the wallet
-         *
          */
         get: {
             parameters: {
-                query?: {
-                    date_from?: string;
-                    date_to?: string;
-                    /** @description JSON-encoded filters */
-                    filters?: string;
-                    /** @description If `true`, includes dust orders (amount below render threshold for either currency). Defaults to `false` — dust orders are hidden. */
-                    show_low_balance?: "true" | "false";
-                };
+                query?: never;
                 header?: never;
-                path: {
-                    wallet_uuid: string;
-                };
+                path?: never;
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description CSV file download */
+                /** @description List of available order types */
                 200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "text/csv": string;
-                    };
-                };
-                /** @description Access denied to wallet */
-                403: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -6542,7 +6635,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/id/{order_id}": {
+    "/frontend/orders/types/{id}": {
         parameters: {
             query?: never;
             header?: never;
@@ -6550,8 +6643,8 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get order
-         * @description Retrieves a specific order by its numeric ID.
+         * Get order type
+         * @description Retrieves details of a specific order type by ID.
          *
          *     **Authentication**: Bearer token with x-tenant-id header required
          *
@@ -6561,26 +6654,20 @@ export interface paths {
                 query?: never;
                 header?: never;
                 path: {
-                    order_id: number;
+                    id: string;
                 };
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Order details */
+                /** @description Order type details */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content: {
-                        "application/json": {
-                            /** @example true */
-                            success: boolean;
-                            data: components["schemas"]["OrderDetail"];
-                        };
-                    };
+                    content?: never;
                 };
-                /** @description Order not found */
+                /** @description Order type not found */
                 404: {
                     headers: {
                         [name: string]: unknown;
@@ -6597,7 +6684,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/uuid/{order_uuid}": {
+    "/frontend/orders/calc": {
         parameters: {
             query?: never;
             header?: never;
@@ -6605,24 +6692,34 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get order by UUID
-         * @description Retrieves a specific order by its UUID.
+         * Calculate order
+         * @description Pre-calculates order amounts, fees and exchange rates without creating an order.
          *
          *     **Authentication**: Bearer token with x-tenant-id header required
          *
          */
         get: {
             parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    order_uuid: string;
+                query: {
+                    order_type: components["schemas"]["OrderTypeId"];
+                    amount: number;
+                    from_currency_id: string;
+                    to_currency_id: string;
+                    /** @description If `true`, calculates inputs needed to receive the given amount. */
+                    is_reverse: boolean;
+                    /** @description If `true`, the network fee is subtracted from `result_amount`. If `false`, the fee is added on top of `from_amount` and the recipient gets the full converted amount. Ignored for reverse calculations. Required so the client always states the fee-allocation mode explicitly — a change of the server-side fallback can never silently alter the calculation.
+                     *      */
+                    is_subtract: boolean;
+                    /** @description Destination address (for crypto withdrawals; affects network fee estimation). */
+                    to_address?: string;
                 };
+                header?: never;
+                path?: never;
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Order details */
+                /** @description Calculated order details */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -6631,16 +6728,27 @@ export interface paths {
                         "application/json": {
                             /** @example true */
                             success: boolean;
-                            data: components["schemas"]["OrderDetail"];
+                            data: components["schemas"]["OrderCalculation"];
                         };
                     };
                 };
-                /** @description Order not found */
-                404: {
+                /** @description Invalid request (e.g. unknown `order_type`, missing required parameter, exchange rate not found) */
+                400: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content?: never;
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Calculation failed (e.g. network fee estimation error) */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
                 };
             };
         };
@@ -6652,103 +6760,60 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/TRANSFER_INTERNAL": {
+    "/frontend/orders/wallet/{wallet_uuid}": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
         /**
-         * Create internal transfer
-         * @description Creates an internal transfer between wallets.
+         * List orders
+         * @description Retrieves a paginated list of orders for a specific wallet.
          *
          *     **Authentication**: Bearer token with x-tenant-id header required
          *
-         *     **Access Control**: User must be admin of the source wallet
+         *     **Access Control**: User must have access to the wallet
          *
          */
-        post: {
+        get: {
             parameters: {
-                query?: never;
+                query?: {
+                    offset?: number;
+                    limit?: number;
+                    sort_by?: string;
+                    sort_order?: "asc" | "desc";
+                    /** @description JSON-encoded filters */
+                    filters?: string;
+                    date_from?: string;
+                    date_to?: string;
+                    /** @description If `true`, includes dust orders (amount below render threshold for either currency). Defaults to `false` — dust orders are hidden. */
+                    show_low_balance?: "true" | "false";
+                };
                 header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        /** Format: uuid */
-                        wallet_id: string;
-                        /** Format: uuid */
-                        from_currency_id: string;
-                        /**
-                         * Format: uuid
-                         * @description Receiver — a counterparty destination of type INTERNAL (points at the target wallet)
-                         */
-                        counterparty_destination_id: string;
-                        amount: number;
-                        request_id: string;
-                    };
+                path: {
+                    wallet_uuid: string;
                 };
+                cookie?: never;
             };
+            requestBody?: never;
             responses: {
-                /** @description Order created */
+                /** @description List of orders */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content?: never;
-                };
-                /** @description Access denied */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-                /** @description Rate limit exceeded */
-                429: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/frontend/orders/OMNIBUS_CRYPTO_TRANSFER": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /** Create omnibus crypto transfer */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": components["schemas"]["FrontendCryptoTransferRequest"];
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success: boolean;
+                            data: components["schemas"]["Order"][];
+                            pagination: components["schemas"]["PaginationResponse"];
+                        };
+                    };
                 };
-            };
-            responses: {
-                /** @description Order created */
-                200: {
+                /** @description Access denied to wallet */
+                403: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -6756,37 +6821,59 @@ export interface paths {
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/SEGREGATED_CRYPTO_TRANSFER": {
+    "/frontend/orders/wallet/{wallet_uuid}/csv": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
-        /** Create segregated crypto transfer */
-        post: {
+        /**
+         * Export orders
+         * @description Exports orders for a specific wallet as a CSV file.
+         *
+         *     **Authentication**: Bearer token with x-tenant-id header required
+         *
+         *     **Access Control**: User must have access to the wallet
+         *
+         */
+        get: {
             parameters: {
-                query?: never;
+                query?: {
+                    date_from?: string;
+                    date_to?: string;
+                    /** @description JSON-encoded filters */
+                    filters?: string;
+                    /** @description If `true`, includes dust orders (amount below render threshold for either currency). Defaults to `false` — dust orders are hidden. */
+                    show_low_balance?: "true" | "false";
+                };
                 header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": components["schemas"]["FrontendCryptoTransferRequest"];
+                path: {
+                    wallet_uuid: string;
                 };
+                cookie?: never;
             };
+            requestBody?: never;
             responses: {
-                /** @description Order created */
+                /** @description CSV file download */
                 200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "text/csv": string;
+                    };
+                };
+                /** @description Access denied to wallet */
+                403: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -6794,37 +6881,54 @@ export interface paths {
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/L2F_WIRE_OFFRAMP": {
+    "/frontend/orders/id/{order_id}": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
-        /** Create wire offramp */
-        post: {
+        /**
+         * Get order
+         * @description Retrieves a specific order by its numeric ID.
+         *
+         *     **Authentication**: Bearer token with x-tenant-id header required
+         *
+         */
+        get: {
             parameters: {
                 query?: never;
                 header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": components["schemas"]["FrontendL2FOrderRequest"];
+                path: {
+                    order_id: number;
                 };
+                cookie?: never;
             };
+            requestBody?: never;
             responses: {
-                /** @description Order created */
+                /** @description Order details */
                 200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success: boolean;
+                            data: components["schemas"]["OrderDetail"];
+                        };
+                    };
+                };
+                /** @description Order not found */
+                404: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -6832,37 +6936,54 @@ export interface paths {
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/L2F_ACH_OFFRAMP": {
+    "/frontend/orders/uuid/{order_uuid}": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
-        /** Create ACH offramp */
-        post: {
+        /**
+         * Get order by UUID
+         * @description Retrieves a specific order by its UUID.
+         *
+         *     **Authentication**: Bearer token with x-tenant-id header required
+         *
+         */
+        get: {
             parameters: {
                 query?: never;
                 header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": components["schemas"]["FrontendL2FOrderRequest"];
+                path: {
+                    order_uuid: string;
                 };
+                cookie?: never;
             };
+            requestBody?: never;
             responses: {
-                /** @description Order created */
+                /** @description Order details */
                 200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success: boolean;
+                            data: components["schemas"]["OrderDetail"];
+                        };
+                    };
+                };
+                /** @description Order not found */
+                404: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -6870,13 +6991,15 @@ export interface paths {
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/L2F_SEPA_OFFRAMP": {
+    "/frontend/orders/TRANSFER_INTERNAL": {
         parameters: {
             query?: never;
             header?: never;
@@ -6885,7 +7008,15 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Create SEPA offramp */
+        /**
+         * Create internal transfer
+         * @description Creates an internal transfer between wallets.
+         *
+         *     **Authentication**: Bearer token with x-tenant-id header required
+         *
+         *     **Access Control**: User must be admin of the source wallet
+         *
+         */
         post: {
             parameters: {
                 query?: never;
@@ -6895,7 +7026,19 @@ export interface paths {
             };
             requestBody: {
                 content: {
-                    "application/json": components["schemas"]["FrontendL2FOrderRequest"];
+                    "application/json": {
+                        /** Format: uuid */
+                        wallet_id: string;
+                        /** Format: uuid */
+                        from_currency_id: string;
+                        /**
+                         * Format: uuid
+                         * @description Receiver — a counterparty destination of type INTERNAL (points at the target wallet)
+                         */
+                        counterparty_destination_id: string;
+                        amount: number;
+                        request_id: string;
+                    };
                 };
             };
             responses: {
@@ -6906,39 +7049,15 @@ export interface paths {
                     };
                     content?: never;
                 };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/frontend/orders/L2F_SWIFT_OFFRAMP": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /** Create SWIFT offramp */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": components["schemas"]["FrontendL2FOrderRequest"];
+                /** @description Access denied */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
                 };
-            };
-            responses: {
-                /** @description Order created */
-                200: {
+                /** @description Rate limit exceeded */
+                429: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -6952,7 +7071,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/L2F_CHAPS_OFFRAMP": {
+    "/frontend/orders/OMNIBUS_CRYPTO_TRANSFER": {
         parameters: {
             query?: never;
             header?: never;
@@ -6961,7 +7080,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Create CHAPS offramp */
+        /** Create omnibus crypto transfer */
         post: {
             parameters: {
                 query?: never;
@@ -6971,7 +7090,7 @@ export interface paths {
             };
             requestBody: {
                 content: {
-                    "application/json": components["schemas"]["FrontendL2FOrderRequest"];
+                    "application/json": components["schemas"]["FrontendCryptoTransferRequest"];
                 };
             };
             responses: {
@@ -6990,7 +7109,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/L2F_FPS_OFFRAMP": {
+    "/frontend/orders/SEGREGATED_CRYPTO_TRANSFER": {
         parameters: {
             query?: never;
             header?: never;
@@ -6999,7 +7118,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Create FPS offramp */
+        /** Create segregated crypto transfer */
         post: {
             parameters: {
                 query?: never;
@@ -7009,7 +7128,7 @@ export interface paths {
             };
             requestBody: {
                 content: {
-                    "application/json": components["schemas"]["FrontendL2FOrderRequest"];
+                    "application/json": components["schemas"]["FrontendCryptoTransferRequest"];
                 };
             };
             responses: {
@@ -10435,7 +10554,7 @@ export interface components {
          * @example EXCHANGE_OMNI
          * @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" | "BRL_RTP_OFFRAMP" | "DLS_WIRE_ONRAMP" | "DLS_WIRE_OFFRAMP" | "DLS_ACH_ONRAMP" | "DLS_ACH_OFFRAMP" | "DLS_SEPA_ONRAMP" | "DLS_SEPA_OFFRAMP" | "DLS_SWIFT_ONRAMP" | "DLS_SWIFT_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";
+        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" | "BRL_RTP_OFFRAMP" | "DLS_WIRE_ONRAMP" | "DLS_WIRE_OFFRAMP" | "DLS_ACH_ONRAMP" | "DLS_ACH_OFFRAMP" | "DLS_SEPA_ONRAMP" | "DLS_SEPA_OFFRAMP" | "DLS_SWIFT_ONRAMP" | "DLS_SWIFT_OFFRAMP" | "BC1_SEPA_ONRAMP" | "BC1_SEPA_OFFRAMP" | "BC1_SWIFT_ONRAMP" | "BC1_SWIFT_OFFRAMP" | "BC3_SEPA_ONRAMP" | "BC3_SEPA_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";
         OrderCalculation: {
             /**
              * Format: uuid
@@ -11166,11 +11285,16 @@ export interface components {
             amount_to?: number | null;
             order_type?: string;
             /** @enum {string} */
-            status?: "NEW" | "PROCESSING" | "COMPLETE" | "FAILED" | "CANCELED";
+            status?: "NEW" | "EXPECTED" | "PROCESSING" | "COMPLETE" | "FAILED" | "CANCELED" | "REFUNDED";
             /** Format: uuid */
             sub_account_id?: string | null;
             info?: string | null;
             meta?: components["schemas"]["OrderMeta"];
+            /**
+             * Format: date-time
+             * @description Requested execution time for scheduled payments (status EXPECTED); null for immediate orders
+             */
+            scheduled_at?: string | null;
             /** Format: date-time */
             created_at?: string;
             /** Format: date-time */
@@ -11215,6 +11339,11 @@ export interface components {
             wallet_account_id?: string;
             reference?: string;
             note?: string;
+            /**
+             * Format: date-time
+             * @description Optional. Schedule the payment for a future time (min 1 hour, max 90 days ahead). No funds are reserved; after approval the order waits in EXPECTED status and executes automatically.
+             */
+            scheduled_at?: string;
             /** @description Optional supporting documents persisted with the order. */
             documents?: components["schemas"]["OrderDocumentInput"][];
         };
@@ -11235,6 +11364,11 @@ export interface components {
             counterparty_destination_id: string;
             reference?: string;
             note?: string;
+            /**
+             * Format: date-time
+             * @description Optional. Schedule the payment for a future time (min 1 hour, max 90 days ahead). No funds are reserved; after approval the order waits in EXPECTED status and executes automatically.
+             */
+            scheduled_at?: string;
             /** @description Optional supporting documents persisted with the order. */
             documents?: components["schemas"]["OrderDocumentInput"][];
         };
@@ -11365,6 +11499,66 @@ export interface components {
             /** Format: uuid */
             wallet_id?: string;
         };
+        MassPayout: {
+            /** Format: uuid */
+            id?: string;
+            /** Format: uuid */
+            wallet_id?: string;
+            /** Format: uuid */
+            currency_id?: string;
+            /**
+             * Format: uuid
+             * @description Source virtual account for banking payouts (required only when the batch contains banking recipients)
+             */
+            virtual_account_id?: string | null;
+            name?: string;
+            /** @enum {string} */
+            status?: "DRAFT" | "PENDING_APPROVAL" | "PROCESSING" | "COMPLETED" | "FAILED" | "CANCELED";
+            total_items?: number;
+            total_amount?: number;
+            completed_count?: number;
+            failed_count?: number;
+            /**
+             * Format: uuid
+             * @description User id of the wallet member who approved the batch; null until approved
+             */
+            approved_by?: string | null;
+            /** Format: date-time */
+            approved_at?: string | null;
+            error_message?: string | null;
+            /** Format: date-time */
+            created_at?: string;
+            /** Format: date-time */
+            finished_at?: string | null;
+        };
+        MassPayoutItem: {
+            /** Format: uuid */
+            id?: string;
+            /** Format: uuid */
+            destination_id?: string;
+            amount?: number;
+            /** @enum {string} */
+            status?: "PENDING" | "PROCESSING" | "COMPLETED" | "FAILED";
+            /**
+             * Format: uuid
+             * @description The regular order created for this item at execution
+             */
+            order_id?: string | null;
+            error_message?: string | null;
+            position?: number;
+            /** Format: date-time */
+            created_at?: string;
+            /** Format: date-time */
+            processed_at?: string | null;
+        };
+        MassPayoutItemInput: {
+            /**
+             * Format: uuid
+             * @description Existing counterparty destination of the source wallet
+             */
+            destination_id: string;
+            amount: number;
+        };
     };
     responses: {
         /** @description Authentication credentials are missing or invalid */
@@ -11422,6 +11616,9 @@ export interface components {
          * @example e04c0c85-b031-47d7-8541-207b4e83d91a
          */
         TenantId: string;
+        /** @description Source wallet the batches belong to */
+        MassPayoutWalletId: string;
+        MassPayoutId: string;
     };
     requestBodies: never;
     headers: never;