squarefi-bff-api-module 1.36.31 → 1.36.33

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

@@ -872,9 +872,21 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Look up bank data by code
-         * @description Resolves a bank identifier (IBAN, SWIFT/BIC, or US RTN) into normalised
-         *     bank/address data suitable for prefilling a counterparty form.
+         * Look up bank data by payment method and code
+         * @description Resolves a bank identifier into the bank name and registered address for
+         *     prefilling counterparty bank details. `method` fixes the expected code
+         *     format:
+         *
+         *     | `method` | code |
+         *     | --- | --- |
+         *     | `ach`, `fedwire` | US routing number (ABA/RTN) |
+         *     | `swift`, `sepa` | SWIFT/BIC |
+         *     | `fps`, `chaps` | UK sort code (always resolves to an empty list today) |
+         *
+         *     Matching is by full code — prefix search is not supported, so `data`
+         *     carries at most one element today. A well-formed code that matches no
+         *     bank is `200` with an empty `data`, not a 404. Banks that do not accept
+         *     the selected method also resolve to an empty `data`.
          *
          *     **Authentication**: Bearer token + x-tenant-id header
          *
@@ -882,8 +894,13 @@ export interface paths {
         get: {
             parameters: {
                 query: {
-                    /** @description IBAN, SWIFT/BIC, or US routing number (optionally "routing:account") */
+                    /** @description Full bank code in the format implied by `method`. For `ach`/`fedwire`
+                     *     the legacy `routing:account` form is tolerated — the account part is
+                     *     ignored.
+                     *      */
                     code: string;
+                    /** @description Payment method the bank details are collected for */
+                    method: "ach" | "fedwire" | "swift" | "sepa" | "fps" | "chaps";
                 };
                 header?: never;
                 path?: never;
@@ -891,9 +908,9 @@ export interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Bank data resolved. `data` is null ONLY when the bank-data lookup subsystem is
-                 *     disabled on the environment; with lookups enabled a failed resolution is
-                 *     reported as 400, never as a null `data`.
+                /** @description Matched banks (at most one today). An empty `data` means the code is
+                 *     well-formed but no bank was found for the requested method — clients
+                 *     fall back to manual entry.
                  *      */
                 200: {
                     headers: {
@@ -903,20 +920,24 @@ export interface paths {
                         "application/json": {
                             /** @example true */
                             success: boolean;
-                            data: components["schemas"]["BankData"] | null;
+                            data: components["schemas"]["BankDataItem"][];
+                            /**
+                             * @description Convenience length of `data`
+                             * @example 1
+                             */
+                            count?: number;
                         };
                     };
                 };
-                /** @description Bad request — one of:
-                 *     - `VALIDATION_ERROR` — query parameter `code` is missing/empty, or longer than 64 characters
-                 *     - `UNSUPPORTED_BANK_CODE` — `code` does not match any supported format (IBAN, SWIFT/BIC, US RTN)
-                 *     - `BANK_DATA_LOOKUP_FAILED` — the code is well-formed but could not be resolved
-                 *       (unknown code or a transient lookup failure); always reported as this single
-                 *       400, never as 404/502
-                 *     - `EXTERNAL_SERVICE_ERROR` — the bank-data lookup is temporarily unavailable
+                /** @description Bad request — only for malformed input:
+                 *     - `VALIDATION_ERROR` — `code` is missing/empty or longer than 64
+                 *       characters, or `method` is missing/not one of the allowed values
+                 *     - `UNSUPPORTED_BANK_CODE` — `code` does not match the format required
+                 *       by `method` (e.g. a SWIFT/BIC passed with `method=ach`)
                  *
-                 *     The body also carries a top-level `correlationId` (added by the error handler to
-                 *     every 4xx/5xx it formats).
+                 *     A resolvable-but-unknown code is NOT a 400 — it answers `200` with an
+                 *     empty `data`. The body also carries a top-level `correlationId`
+                 *     (added by the error handler to every 4xx/5xx it formats).
                  *      */
                 400: {
                     headers: {
@@ -975,6 +996,25 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
+                /** @description Bank data lookup is temporarily unavailable — safe to retry later.
+                 *     The body carries a `correlationId`.
+                 *      */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /** @example {
+                         *       "success": false,
+                         *       "error": {
+                         *         "code": "BANK_DATA_LOOKUP_FAILED",
+                         *         "message": "Bank data lookup failed"
+                         *       },
+                         *       "correlationId": "3f7f2f9a-8f0e-4a3b-9a3d-2f1c9d6a1b2c"
+                         *     } */
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
             };
         };
         put?: never;
@@ -2124,7 +2164,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 +2858,13 @@ export interface paths {
         put?: never;
         /**
          * Deposit funds to card
-         * @description Deposits funds to a card from the associated wallet.
-         *
-         *     **Authentication**: Bearer token with x-tenant-id header required
+         * @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).
          *
-         *     **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 +2882,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 +2949,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 +2972,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 +4919,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 +5045,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 +5090,33 @@ export interface paths {
                 };
             };
         };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/frontend/orders/deposit/card": {
-        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.
+         * Edit a mass payout draft
+         * @description Draft-only. `items` fully replaces the recipient list; `virtual_account_id: null` clears the source VA.
          */
-        post: {
+        put: {
             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": {
+                        name?: string;
                         /** Format: uuid */
-                        wallet_id: string;
-                        amount: number;
-                        /** Format: uuid */
-                        sub_account_id: string;
+                        virtual_account_id?: string | null;
+                        items?: components["schemas"]["MassPayoutItemInput"][];
                     };
                 };
             };
             responses: {
-                /** @description Card return order created */
+                /** @description Updated draft */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5101,14 +5125,12 @@ export interface paths {
                         "application/json": {
                             /** @example true */
                             success?: boolean;
-                            data?: components["schemas"]["Order"];
-                            /** @example Card return order created */
-                            message?: string;
+                            data?: components["schemas"]["MassPayout"];
                         };
                     };
                 };
-                /** @description Missing required fields or invalid amount */
-                400: {
+                /** @description Batch is not editable anymore (already submitted) */
+                409: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -5116,42 +5138,156 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Authentication required */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
+            };
+        };
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/frontend/mass-payouts/{wallet_id}/{id}/items": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List items of a mass payout
+         * @description Items in upload order, paginated with limit/offset like the batch list.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    limit?: number;
+                    offset?: number;
                 };
-                /** @description Caller is not an admin of the wallet */
-                403: {
+                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 Page of items */
+                200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                        "application/json": {
+                            /** @example true */
+                            success?: boolean;
+                            data?: {
+                                items?: components["schemas"]["MassPayoutItem"][];
+                                total?: number;
+                                limit?: number;
+                                offset?: number;
+                            };
+                        };
                     };
                 };
-                /** @description Card return failed */
-                500: {
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/frontend/mass-payouts/{wallet_id}/{id}/preview": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 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).
+         *
+         */
+        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 Validation report, fee estimates and balance check */
+                200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                        "application/json": {
+                            /** @example true */
+                            success?: boolean;
+                            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;
+                                }[];
+                            };
+                        };
                     };
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/exchange": {
+    "/frontend/mass-payouts/{wallet_id}/{id}/submit": {
         parameters: {
             query?: never;
             header?: never;
@@ -5161,35 +5297,25 @@ export interface paths {
         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.
+         * 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": 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 Batch is awaiting approval */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5198,11 +5324,11 @@ export interface paths {
                         "application/json": {
                             /** @example true */
                             success?: boolean;
-                            data?: components["schemas"]["Order"];
+                            data?: components["schemas"]["MassPayout"];
                         };
                     };
                 };
-                /** @description Validation error (insufficient balance, virtual account missing, etc.) */
+                /** @description Batch has invalid items (details carry the per-item problems) */
                 400: {
                     headers: {
                         [name: string]: unknown;
@@ -5211,26 +5337,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 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;
                     };
@@ -5246,7 +5354,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/withdrawal/internal": {
+    "/frontend/mass-payouts/{wallet_id}/{id}/approve": {
         parameters: {
             query?: never;
             header?: never;
@@ -5256,46 +5364,29 @@ 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.
+         * 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": {
-                        /**
-                         * 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 Execution started */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5304,29 +5395,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;
@@ -5335,8 +5408,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;
                     };
@@ -5352,7 +5425,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/withdrawal/crypto": {
+    "/frontend/mass-payouts/{wallet_id}/{id}/cancel": {
         parameters: {
             query?: never;
             header?: never;
@@ -5362,31 +5435,23 @@ 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.
-         *
+         * 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"]["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 Batch canceled */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5395,12 +5460,12 @@ export interface paths {
                         "application/json": {
                             /** @example true */
                             success?: boolean;
-                            data?: components["schemas"]["Order"];
+                            data?: components["schemas"]["MassPayout"];
                         };
                     };
                 };
-                /** @description Validation error */
-                400: {
+                /** @description Batch can no longer be canceled */
+                409: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -5408,26 +5473,51 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Authentication required */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
+            };
+        };
+        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"];
                 };
-                /** @description Caller is not an admin of the source wallet */
-                403: {
+                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;
                     };
@@ -5437,13 +5527,15 @@ export interface paths {
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/withdrawal/wire": {
+    "/frontend/orders/deposit/ach": {
         parameters: {
             query?: never;
             header?: never;
@@ -5452,7 +5544,10 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Wire */
+        /**
+         * ACH (coming soon)
+         * @description ACH deposit is not yet implemented. Returns 501.
+         */
         post: {
             parameters: {
                 query?: never;
@@ -5462,34 +5557,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 Wire 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;
                     };
@@ -5497,17 +5625,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;
                     };
@@ -5523,7 +5681,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/withdrawal/ach": {
+    "/frontend/orders/exchange": {
         parameters: {
             query?: never;
             header?: never;
@@ -5532,7 +5690,22 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** ACH */
+        /**
+         * 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;
@@ -5542,11 +5715,11 @@ export interface paths {
             };
             requestBody: {
                 content: {
-                    "application/json": components["schemas"]["FrontendL2FOrderRequest"];
+                    "application/json": components["schemas"]["FrontendExchangeOrderRequest"];
                 };
             };
             responses: {
-                /** @description ACH withdrawal created */
+                /** @description Exchange order created (status NEW — approve to debit and execute) */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5559,7 +5732,7 @@ export interface paths {
                         };
                     };
                 };
-                /** @description Validation error */
+                /** @description Validation error (insufficient balance, virtual account missing, etc.) */
                 400: {
                     headers: {
                         [name: string]: unknown;
@@ -5577,7 +5750,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;
@@ -5603,7 +5776,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/withdrawal/sepa": {
+    "/frontend/orders/withdrawal/internal": {
         parameters: {
             query?: never;
             header?: never;
@@ -5612,7 +5785,17 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** SEPA */
+        /**
+         * 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;
@@ -5622,11 +5805,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 SEPA withdrawal created */
+                /** @description Transfer created in NEW status (awaiting approve; no funds held) */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5683,7 +5887,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/withdrawal/swift": {
+    "/frontend/orders/withdrawal/crypto": {
         parameters: {
             query?: never;
             header?: never;
@@ -5692,7 +5896,18 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** SWIFT */
+        /**
+         * 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;
@@ -5702,11 +5917,11 @@ export interface paths {
             };
             requestBody: {
                 content: {
-                    "application/json": components["schemas"]["FrontendL2FOrderRequest"];
+                    "application/json": components["schemas"]["FrontendCryptoTransferRequest"];
                 };
             };
             responses: {
-                /** @description SWIFT withdrawal created */
+                /** @description Crypto withdrawal created */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5763,7 +5978,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/withdrawal/chaps": {
+    "/frontend/orders/withdrawal/wire": {
         parameters: {
             query?: never;
             header?: never;
@@ -5772,7 +5987,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** CHAPS */
+        /** Wire */
         post: {
             parameters: {
                 query?: never;
@@ -5786,7 +6001,7 @@ export interface paths {
                 };
             };
             responses: {
-                /** @description CHAPS withdrawal created */
+                /** @description Wire withdrawal created */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5843,7 +6058,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/withdrawal/fps": {
+    "/frontend/orders/withdrawal/ach": {
         parameters: {
             query?: never;
             header?: never;
@@ -5852,7 +6067,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** FPS */
+        /** ACH */
         post: {
             parameters: {
                 query?: never;
@@ -5866,7 +6081,7 @@ export interface paths {
                 };
             };
             responses: {
-                /** @description FPS withdrawal created */
+                /** @description ACH withdrawal created */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5923,7 +6138,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/withdrawal/card": {
+    "/frontend/orders/withdrawal/sepa": {
         parameters: {
             query?: never;
             header?: never;
@@ -5932,10 +6147,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /**
-         * Card
-         * @description Funds a card sub-account from a wallet.
-         */
+        /** SEPA */
         post: {
             parameters: {
                 query?: never;
@@ -5945,32 +6157,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 SEPA withdrawal created */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5980,12 +6171,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 +6201,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 +6218,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/{order_id}/approve": {
+    "/frontend/orders/withdrawal/swift": {
         parameters: {
             query?: never;
             header?: never;
@@ -6038,36 +6227,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).
-         *
-         */
+        /** SWIFT */
         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 SWIFT withdrawal created */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -6080,8 +6254,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 +6298,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/{order_id}/cancel": {
+    "/frontend/orders/withdrawal/chaps": {
         parameters: {
             query?: never;
             header?: never;
@@ -6106,30 +6307,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).
-         */
+        /** CHAPS */
         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 CHAPS withdrawal created */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -6142,8 +6334,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 +6378,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/{order_id}/comment": {
+    "/frontend/orders/withdrawal/fps": {
         parameters: {
             query?: never;
             header?: never;
@@ -6167,39 +6386,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;
+        /** FPS */
+        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 FPS withdrawal created */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -6212,7 +6414,7 @@ export interface paths {
                         };
                     };
                 };
-                /** @description Validation error (e.g. comment too long) */
+                /** @description Validation error */
                 400: {
                     headers: {
                         [name: string]: unknown;
@@ -6221,7 +6423,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 +6441,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 +6452,190 @@ export interface paths {
                 };
             };
         };
-        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/types": {
+    "/frontend/orders/{order_id}/approve": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
+        get?: never;
+        put?: never;
         /**
-         * List order types
-         * @description Retrieves a list of available order types for the tenant.
-         *
-         *     **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?: never;
+                path: {
+                    order_id: string;
+                };
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** Format: uuid */
+                        wallet_id: string;
+                    };
+                };
+            };
             responses: {
-                /** @description List of available order types */
+                /** @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 is not in an approvable state */
+                409: {
+                    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}/cancel": {
         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
+         * 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?: never;
                 header?: never;
                 path: {
-                    id: string;
+                    order_id: string;
                 };
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** Format: uuid */
+                        wallet_id: string;
+                        reason?: string;
+                    };
+                };
+            };
             responses: {
-                /** @description Order type details */
+                /** @description Order canceled (no balance change) */
                 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 a cancelable 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}/comment": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
+        get?: never;
         /**
-         * Calculate order
-         * @description Pre-calculates order amounts, fees and exchange rates without creating an order.
+         * 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**: caller must be `admin` or `owner` of the order's wallet.
          *
          */
-        get: {
+        put: {
             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;
+                        /** @description Comment text. `null` or empty clears the comment. */
+                        comment?: string | null;
+                    };
+                };
+            };
             responses: {
-                /** @description Calculated order details */
+                /** @description Comment saved */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -6380,12 +6643,12 @@ 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) */
+                /** @description Validation error (e.g. comment too long) */
                 400: {
                     headers: {
                         [name: string]: unknown;
@@ -6394,8 +6657,8 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Calculation failed (e.g. network fee estimation error) */
-                500: {
+                /** @description Access denied (insufficient wallet role / wrong wallet) */
+                403: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -6403,78 +6666,17 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/frontend/orders/wallet/{wallet_uuid}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * 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 have access to the wallet
-         *
-         */
-        get: {
-            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";
-                };
-                header?: never;
-                path: {
-                    wallet_uuid: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description List of orders */
-                200: {
+                /** @description Order not found */
+                404: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": {
-                            /** @example true */
-                            success: boolean;
-                            data: components["schemas"]["Order"][];
-                            pagination: components["schemas"]["PaginationResponse"];
-                        };
-                    };
-                };
-                /** @description Access denied to wallet */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
+                        "application/json": components["schemas"]["ErrorResponse"];
                     };
-                    content?: never;
                 };
             };
         };
-        put?: never;
         post?: never;
         delete?: never;
         options?: never;
@@ -6482,7 +6684,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/wallet/{wallet_uuid}/csv": {
+    "/frontend/orders/types": {
         parameters: {
             query?: never;
             header?: never;
@@ -6490,43 +6692,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 +6724,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/id/{order_id}": {
+    "/frontend/orders/types/{id}": {
         parameters: {
             query?: never;
             header?: never;
@@ -6550,8 +6732,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 +6743,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 +6773,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/orders/uuid/{order_uuid}": {
+    "/frontend/orders/calc": {
         parameters: {
             query?: never;
             header?: never;
@@ -6605,24 +6781,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 +6817,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 +6849,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: {
+                        "application/json": {
+                            /** @example true */
+                            success: boolean;
+                            data: components["schemas"]["Order"][];
+                            pagination: components["schemas"]["PaginationResponse"];
+                        };
                     };
-                    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"];
                 };
-            };
-            responses: {
-                /** @description Order created */
-                200: {
+                /** @description Access denied to wallet */
+                403: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -6756,37 +6910,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 +6970,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 +7025,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 +7080,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 +7097,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 +7115,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 +7138,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 +7160,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 +7169,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Create CHAPS offramp */
+        /** Create omnibus crypto transfer */
         post: {
             parameters: {
                 query?: never;
@@ -6971,7 +7179,7 @@ export interface paths {
             };
             requestBody: {
                 content: {
-                    "application/json": components["schemas"]["FrontendL2FOrderRequest"];
+                    "application/json": components["schemas"]["FrontendCryptoTransferRequest"];
                 };
             };
             responses: {
@@ -6990,7 +7198,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 +7207,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Create FPS offramp */
+        /** Create segregated crypto transfer */
         post: {
             parameters: {
                 query?: never;
@@ -7009,7 +7217,7 @@ export interface paths {
             };
             requestBody: {
                 content: {
-                    "application/json": components["schemas"]["FrontendL2FOrderRequest"];
+                    "application/json": components["schemas"]["FrontendCryptoTransferRequest"];
                 };
             };
             responses: {
@@ -10435,7 +10643,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
@@ -10629,11 +10837,11 @@ export interface components {
              */
             target_wallet_id: string | null;
         };
-        /** @description Bank postal address resolved from the bank identifier. Intentionally mirrors the CounterpartyBankingAddress shape so the payload can prefill a counterparty form as-is. */
+        /** @description Registered bank address. `country_id`/`state_id` reference the `countries`/`states` dictionaries served by this API, so the payload can prefill a counterparty form as-is. */
         BankDataAddress: {
             /** @description Resolved `countries.id` of the bank’s country; null when it could not be resolved */
             country_id: number | null;
-            /** @description Always null today (reserved for future enrichment) */
+            /** @description Resolved `states.id`; populated for US banks when available, null otherwise */
             state_id: number | null;
             city: string | null;
             postcode: string | null;
@@ -10641,46 +10849,28 @@ export interface components {
             street1: string | null;
             /** @description Always null today (reserved) */
             street2: string | null;
-            /** @description Always null today (reserved) */
-            description: string | null;
         };
         /**
-         * @description Normalised bank data resolved from a bank identifier. Which identifier fields are populated depends on the looked-up code type: IBAN → `iban` + `swift_bic` (plus `account_number`/`sort_code` for GB IBANs), SWIFT/BIC → `swift_bic`, US RTN → `routing_number`; identifier fields not applicable to the code type are null. `bank_name` and `address` are populated for every code type whenever they are available.
+         * @description A bank matched by the looked-up code. The list holds at most one element today (full-code match; prefix search is not supported).
          * @example {
-         *       "account_number": "31926819",
-         *       "bank_name": "NATIONAL WESTMINSTER BANK PLC",
-         *       "note": null,
-         *       "routing_number": null,
-         *       "swift_bic": "NWBKGB2LXXX",
-         *       "iban": "GB29NWBK60161331926819",
-         *       "sort_code": "601613",
+         *       "bank_name": "JPMORGAN CHASE BANK, NA",
+         *       "code": "021000021",
          *       "address": {
-         *         "country_id": 230,
-         *         "state_id": null,
-         *         "city": "London",
+         *         "country_id": 233,
+         *         "state_id": 1452,
+         *         "city": "NEW YORK",
          *         "postcode": null,
          *         "street1": null,
-         *         "street2": null,
-         *         "description": null
+         *         "street2": null
          *       }
          *     }
          */
-        BankData: {
-            /** @description Populated only for GB IBANs (22 chars): the embedded 8-digit account number (IBAN positions 14-22); null otherwise */
-            account_number: string | null;
+        BankDataItem: {
             /** @description Registered bank name; null when unavailable */
             bank_name: string | null;
-            /** @description Always null today (reserved) */
-            note: string | null;
-            /** @description Populated only when the looked-up code is a US routing number (echoes the RTN); null otherwise */
-            routing_number: string | null;
-            /** @description SWIFT/BIC (ISO 9362); populated for SWIFT lookups and for IBAN lookups when the IBAN resolves to a BIC */
-            swift_bic: string | null;
-            /** @description Populated only for IBAN lookups (the normalised IBAN itself) */
-            iban: string | null;
-            /** @description Populated only for GB IBANs: the embedded 6-digit sort code (IBAN positions 8-14); null otherwise */
-            sort_code: string | null;
-            /** @description Bank postal address (always present) */
+            /** @description Normalised code the bank was matched by (echoes the query `code`) */
+            code: string;
+            /** @description Registered bank address (always present) */
             address: components["schemas"]["BankDataAddress"];
         };
         /** @description Bank / rail account coordinates for a sub-account. Rail-dependent — some rails return only a subset of these. */
@@ -11166,11 +11356,33 @@ export interface components {
             amount_to?: number | null;
             order_type?: string;
             /** @enum {string} */
-            status?: "NEW" | "PROCESSING" | "COMPLETE" | "FAILED" | "CANCELED";
+            status?: "NEW" | "PENDING" | "EXPECTED" | "PROCESSING" | "COMPLETE" | "FAILED" | "CANCELED" | "REFUNDED";
+            /**
+             * @description Compliance (transaction monitoring) state. Orthogonal to `status`: a `held` order is still PENDING and nothing has been credited — it resolves to COMPLETE or FAILED once the review finishes. `null` means the order was never subject to a compliance hold.
+             * @enum {string|null}
+             */
+            compliance_state?: "held" | "released" | "rejected" | null;
+            /** @description Why the order is (or was) held. */
+            compliance_reason?: string | null;
+            /**
+             * Format: date-time
+             * @description When the hold started.
+             */
+            compliance_held_at?: string | null;
+            /**
+             * Format: date-time
+             * @description When the hold was released or rejected.
+             */
+            compliance_resolved_at?: string | null;
             /** 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 +11427,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 +11452,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 +11587,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 +11704,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;