squarefi-bff-api-module 1.36.31 → 1.36.32

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

@@ -845,6 +845,12 @@ export interface paths {
                             currency_id?: string;
                             /** @description Memo/tag (for XRP, XLM, etc.) */
                             memo?: string;
+                            /**
+                             * @description Hosting classification of the address (custodial VASP, self-hosted/unhosted, or unknown)
+                             * @default unknown
+                             * @enum {string}
+                             */
+                            wallet_custody_type?: "custodial" | "selfhosted" | "unknown";
                         };
                         /** @description Required for type INTERNAL — points at the receiver wallet on the same platform. */
                         internal_data?: {
@@ -2746,6 +2752,204 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/issuing/cards/{card_id}/deposit": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Deposit funds to card
+         * @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 /api/issuing/sub-accounts/{sub_account_id}/deposit
+         *     (same order types, validation and program routing).
+         *
+         *     Deposits through a non-ACTIVE (frozen/canceled) card are rejected
+         *     with 409 CARD_INACTIVE.
+         *
+         *     **Authentication**: x-api-key header required
+         *
+         *     **Access Control**: User must have access to the card
+         *
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description The ID of the card */
+                    card_id: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /**
+                         * Format: uuid
+                         * @description Unique reference ID for idempotency
+                         */
+                        reference_id: string;
+                        /**
+                         * Format: uuid
+                         * @description UUID of the currency to deduct from the wallet
+                         */
+                        from_currency_id: string;
+                        amount: number;
+                        note?: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Deposit order created (COMPLETE, FAILED, or PROCESSING for workflow-routed programs) */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Validation error */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ApiErrorResponse"];
+                    };
+                };
+                /** @description Access denied to this card */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ApiErrorResponse"];
+                    };
+                };
+                /** @description Card or sub-account not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ApiErrorResponse"];
+                    };
+                };
+                /** @description Card is not active (CARD_INACTIVE) */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ApiErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/issuing/cards/{card_id}/withdraw": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Withdraw funds from 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 /api/issuing/sub-accounts/{sub_account_id}/withdraw
+         *     (same order types and validation; concurrent withdrawals on the same
+         *     sub-account are rejected with 409). Allowed for non-ACTIVE cards —
+         *     returning funds from a frozen/canceled card's sub-account is a valid
+         *     recovery path.
+         *
+         *     **Authentication**: x-api-key header required
+         *
+         *     **Access Control**: User must have access to the card
+         *
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description The ID of the card */
+                    card_id: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** @description Amount to withdraw back to the wallet */
+                        amount: number;
+                    };
+                };
+            };
+            responses: {
+                /** @description Withdrawal completed */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Validation error */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ApiErrorResponse"];
+                    };
+                };
+                /** @description Access denied to this card */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ApiErrorResponse"];
+                    };
+                };
+                /** @description Card or sub-account not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ApiErrorResponse"];
+                    };
+                };
+                /** @description Another withdrawal for this sub-account is in progress */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ApiErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/issuing/config/programs": {
         parameters: {
             query?: never;
@@ -3774,92 +3978,6 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/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 the wallet balance.
-         *     The wallet is resolved from the API key.
-         *
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        /** @example 50 */
-                        amount: number;
-                        /**
-                         * Format: uuid
-                         * @example aaaaaaaa-bbbb-4ccc-9ddd-eeeeeeeeeeee
-                         */
-                        sub_account_id: string;
-                    };
-                };
-            };
-            responses: {
-                /** @description Card return order created */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /** @example true */
-                            success?: boolean;
-                            data?: components["schemas"]["Order"];
-                            /** @example Card return order created */
-                            message?: string;
-                        };
-                    };
-                };
-                /** @description Missing required fields or invalid amount */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ApiErrorResponse"];
-                    };
-                };
-                /** @description Authentication required */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ApiErrorResponse"];
-                    };
-                };
-                /** @description Card return failed */
-                500: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ApiErrorResponse"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/api/orders/exchange": {
         parameters: {
             query?: never;
@@ -3871,14 +3989,16 @@ export interface paths {
         put?: never;
         /**
          * Exchange
-         * @description Crypto-to-crypto exchange within the wallet bound to the API key.
+         * @description Currency exchange within the wallet bound to the API key — 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` with the source funds blocked. Call `POST /api/orders/{order_id}/approve`
-         *     to execute the swap (the order lands in `COMPLETE` synchronously), or
-         *     `POST /api/orders/{order_id}/cancel` to release the blocked funds.
-         *
-         *     Fiat legs are not supported — only crypto-to-crypto pairs are accepted.
+         *     `NEW` without touching the balance. Call `POST /api/orders/{order_id}/approve`
+         *     to check the balance, debit the source funds and execute the swap (the
+         *     order lands in `COMPLETE` synchronously), or
+         *     `POST /api/orders/{order_id}/cancel` to discard the order.
          *
          */
         post: {
@@ -3894,7 +4014,7 @@ export interface paths {
                 };
             };
             responses: {
-                /** @description Exchange order created (status NEW, funds blocked — approve to execute) */
+                /** @description Exchange order created (status NEW — approve to debit and execute) */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -4220,10 +4340,14 @@ export interface paths {
         put?: never;
         /**
          * Approve order
-         * @description Transitions the order from NEW to PROCESSING and triggers the order execution pipeline.
-         *     Exchange orders (EXCHANGE_OMNI) and internal transfers (TRANSFER_INTERNAL /
-         *     OMNIBUS_INTERNAL_TRANSFER) settle synchronously and land in COMPLETE.
-         *     Only orders with status NEW can be approved.
+         * @description Transitions the order from NEW to PROCESSING: checks the balance,
+         *     debits the funds (transaction written as `complete`) and triggers the
+         *     order execution pipeline. 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). Only orders with status NEW can be approved. Orders
+         *     created with `scheduled_at` move to EXPECTED instead — no funds are
+         *     debited until execution at the requested time.
          *
          */
         post: {
@@ -4296,8 +4420,13 @@ export interface paths {
         put?: never;
         /**
          * Cancel order
-         * @description Cancels an order. Orders in NEW or FAILED status can be canceled.
-         *     Optionally provide a cancellation reason.
+         * @description Cancels an order. Only NEW and EXPECTED orders can be canceled — neither
+         *     holds debited funds, so cancel never moves money. Optionally provide a
+         *     cancellation reason.
+         *
+         *     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.
          *
          */
         post: {
@@ -4371,16 +4500,13 @@ export interface paths {
         /**
          * Internal
          * @description Transfers funds between wallets within the platform. Two-phase: the
-         *     order is created in `NEW` status with the sender's funds blocked;
-         *     call `POST /api/orders/{id}/approve` to execute the transfer — it
-         *     settles synchronously (receiver credited, order `COMPLETE`). A `NEW`
-         *     order can be canceled via `POST /api/orders/{id}/cancel` to refund
-         *     the blocked funds.
+         *     order is created in `NEW` status without touching the balance;
+         *     call `POST /api/orders/{id}/approve` to check the balance, debit the
+         *     sender and execute the transfer — it settles synchronously (receiver
+         *     credited, order `COMPLETE`). A `NEW` order can be canceled via
+         *     `POST /api/orders/{id}/cancel` (no funds are held).
          *     Wallet ID is automatically resolved from the API key — do **not** pass `wallet_id`.
          *
-         *     `request_id` is used for idempotency: re-posting the same `request_id`
-         *     returns the original order instead of creating a new one.
-         *
          */
         post: {
             parameters: {
@@ -4406,16 +4532,17 @@ export interface paths {
                         /** @example 50 */
                         amount: number;
                         /**
-                         * @description Idempotency key (UUID v4 recommended).
-                         * @example 550e8400-e29b-41d4-a716-446655440000
+                         * 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.
+                         * @example 2026-07-20T12:00:00Z
                          */
-                        request_id: string;
+                        scheduled_at?: string;
                         documents?: Record<string, never>[];
                     };
                 };
             };
             responses: {
-                /** @description Transfer created in NEW status (funds blocked, awaiting approve) */
+                /** @description Transfer created in NEW status (awaiting approve; no funds held) */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -4487,23 +4614,22 @@ export interface paths {
          *     address (or another internal wallet) via a previously-created counterparty
          *     destination.
          *
-         *     Two-phase: the order is created in `NEW` status with funds blocked;
-         *     `POST /api/orders/{id}/approve` 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, settled synchronously to `COMPLETE` at approve.
+         *     Two-phase: the order is created in `NEW` status without touching the
+         *     balance; `POST /api/orders/{id}/approve` 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.
          *
          *     **Prerequisites:**
          *     - A counterparty destination of type `CRYPTO_EXTERNAL` or `CRYPTO_INTERNAL`
          *       created via `POST /api/counterparty/destinations`.
-         *     - Sufficient balance in `from_currency_id` on the wallet bound to the API key.
+         *     - Sufficient balance in `from_currency_id` at approve time on the wallet
+         *       bound to the API key.
          *
          *     `wallet_id` is automatically resolved from the API key — do **not** pass it
          *     in the body.
          *
-         *     `request_id` is mandatory and used for idempotency: re-posting the same
-         *     `request_id` returns the original order.
-         *
          */
         post: {
             parameters: {
@@ -5089,112 +5215,6 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/orders/withdrawal/card": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Card
-         * @description Tops up a card sub-account from the wallet balance. The wallet is resolved
-         *     from the API key. If `card_id` is omitted, the platform uses the first card
-         *     associated with the sub-account.
-         *
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        /** @example 250 */
-                        amount: number;
-                        /**
-                         * Format: uuid
-                         * @description Source currency UUID (deducted from the wallet balance).
-                         * @example 509eca03-bc0d-4a38-b7dc-d136d2bdaa43
-                         */
-                        from_uuid: string;
-                        /**
-                         * Format: uuid
-                         * @example aaaaaaaa-bbbb-4ccc-9ddd-eeeeeeeeeeee
-                         */
-                        sub_account_id: string;
-                        /**
-                         * Format: uuid
-                         * @description Optional specific card ID. Defaults to the first card on the sub-account.
-                         * @example 123e4567-e89b-12d3-a456-426614174000
-                         */
-                        card_id?: string;
-                        /**
-                         * @description Idempotency key (UUID v4 recommended).
-                         * @example 550e8400-e29b-41d4-a716-446655440000
-                         */
-                        reference_id?: string;
-                        /** @example Top up for travel expenses */
-                        note?: string;
-                    };
-                };
-            };
-            responses: {
-                /** @description Card topup order created */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /** @example true */
-                            success?: boolean;
-                            data?: components["schemas"]["Order"];
-                            /** @example Card topup order created */
-                            message?: string;
-                        };
-                    };
-                };
-                /** @description Missing required fields or invalid amount */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ApiErrorResponse"];
-                    };
-                };
-                /** @description Authentication required */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ApiErrorResponse"];
-                    };
-                };
-                /** @description Card topup failed */
-                500: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ApiErrorResponse"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/api/reference/currencies": {
         parameters: {
             query?: never;
@@ -6391,7 +6411,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";
         /** @description Card object with all properties */
         IssuingCard: {
             /**
@@ -6923,6 +6943,12 @@ export interface components {
             currency_id?: string;
             /** @description Memo/tag (for XRP, XLM, etc.) */
             memo?: string | null;
+            /**
+             * @description Hosting classification of the address (custodial VASP, self-hosted/unhosted, or unknown). Defaults to unknown.
+             * @default unknown
+             * @enum {string}
+             */
+            wallet_custody_type: "custodial" | "selfhosted" | "unknown";
             currency: components["schemas"]["CurrencyRef"];
             /** Format: date-time */
             created_at: string;
@@ -7326,11 +7352,16 @@ export interface components {
             amount_to?: number | null;
             order_type?: string;
             /** @enum {string} */
-            status?: "NEW" | "PROCESSING" | "COMPLETE" | "FAILED" | "CANCELED";
+            status?: "NEW" | "EXPECTED" | "PROCESSING" | "COMPLETE" | "FAILED" | "CANCELED" | "REFUNDED";
             /** Format: uuid */
             sub_account_id?: string | null;
             info?: string | null;
             meta?: components["schemas"]["OrderMeta"];
+            /**
+             * Format: date-time
+             * @description Requested execution time for scheduled payments (status EXPECTED); null for immediate orders
+             */
+            scheduled_at?: string | null;
             /** Format: date-time */
             created_at?: string;
             /** Format: date-time */
@@ -7365,11 +7396,6 @@ export interface components {
              * @description Optional wallet account override (advanced; rarely needed).
              */
             wallet_account_id?: string;
-            /**
-             * @description Idempotency key. Must be unique per order — re-sending the same `request_id` returns the original order instead of creating a new one. A UUID v4 is recommended.
-             * @example 550e8400-e29b-41d4-a716-446655440000
-             */
-            request_id: string;
             /**
              * @description Free-form reference visible in order/transaction listings.
              * @example invoice-2026-04-001
@@ -7380,6 +7406,12 @@ export interface components {
              * @example Payout to vendor partner
              */
             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 at the requested time (balance is checked then, with retries and email notifications on insufficient funds).
+             * @example 2026-07-20T12:00:00Z
+             */
+            scheduled_at?: string;
         };
         ApiOfframpOrderRequest: {
             /**
@@ -7411,11 +7443,6 @@ export interface components {
              * @example b2f3d8c1-4a7e-4d22-9c5f-1e6a8d0b2a44
              */
             counterparty_destination_id: string;
-            /**
-             * @description Idempotency key (UUID v4 recommended).
-             * @example 550e8400-e29b-41d4-a716-446655440000
-             */
-            request_id: string;
             /**
              * @description Free-form reference visible in order/transaction listings.
              * @example invoice-2026-04-001
@@ -7426,6 +7453,12 @@ export interface components {
              * @example Monthly payout
              */
             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 at the requested time (balance is checked then, with retries and email notifications on insufficient funds).
+             * @example 2026-07-20T12:00:00Z
+             */
+            scheduled_at?: string;
         };
         ApiExchangeOrderRequest: {
             /**
@@ -7445,12 +7478,6 @@ export interface components {
              * @example 7c8d4a2b-1e3f-4d59-9b6a-2c0e5f7d8a90
              */
             to_currency_id: string;
-            /**
-             * Format: uuid
-             * @description Idempotency key (UUID v4 recommended).
-             * @example 550e8400-e29b-41d4-a716-446655440000
-             */
-            request_id: string;
         };
         /** @description Virtual bank account */
         VirtualAccount: {