squarefi-bff-api-module 1.36.35 → 1.36.37

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

@@ -2930,6 +2930,29 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
+                /** @description Card provider refused the top-up during the pre-flight allowance check
+                 *     (`TOPUP_NOT_ALLOWED` / `TOPUP_AMOUNT_EXCEEDS_VENDOR_LIMIT`). No order
+                 *     was created and the wallet was not debited.
+                 *      */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description `TOPUP_CHECK_UNAVAILABLE` — the provider allowance check could not be
+                 *     completed, so the top-up was refused rather than attempted.
+                 *      */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
             };
         };
         delete?: never;
@@ -3565,6 +3588,26 @@ export interface paths {
                     };
                     content?: never;
                 };
+                /** @description Conflict - the card provider refused the top-up during the pre-flight
+                 *     allowance check (no order was created, the wallet was not debited):
+                 *     - `TOPUP_NOT_ALLOWED` — provider does not allow a top-up for this account
+                 *     - `TOPUP_AMOUNT_EXCEEDS_VENDOR_LIMIT` — amount is above the provider's cap
+                 *      */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description `TOPUP_CHECK_UNAVAILABLE` — the provider allowance check could not be
+                 *     completed, so the top-up was refused rather than attempted. Retry later.
+                 *      */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
             };
         };
         delete?: never;
@@ -4034,9 +4077,18 @@ export interface paths {
         };
         put?: never;
         /**
-         * Create cardholder
-         * @description Creates a new cardholder AND registers them at the vendor in one request.
-         *     The `vendor_id` is resolved automatically from `issuing_program_id`.
+         * Create cardholder draft
+         * @description Creates a cardholder in `DRAFT` status. **No vendor is contacted here** — this is
+         *     step 1 of 3. The `vendor_id` is resolved automatically from `issuing_program_id`.
+         *
+         *     **The three steps**:
+         *     1. `POST /frontend/issuing/cardholders` — create the draft (this endpoint).
+         *     2. `POST /frontend/issuing/cardholders/{cardholder_id}/documents` — upload the KYC
+         *        files as `multipart/form-data`, one request per file or all at once.
+         *     3. `POST /frontend/issuing/cardholders/{cardholder_id}/submit` — register at the
+         *        vendor; the cardholder becomes `ACTIVE`.
+         *
+         *     A draft cannot hold a card: card creation refuses anything that is not `ACTIVE`.
          *
          *     **Authentication**: Bearer token with Authorization header and x-tenant-id header required
          *
@@ -4045,6 +4097,13 @@ export interface paths {
          *
          *     **Uniqueness**: `email + wallet_id + issuing_program_id` must be unique (soft-deleted records excluded).
          *
+         *     **Two modes**:
+         *     - `user_data_id` mode: personal data + KYC documents are seeded from an existing
+         *       verified user (approved identity/face verification + Sumsub applicant required).
+         *       Manual fields only fill gaps. The Sumsub files are attached to the draft
+         *       immediately, so step 2 is usually unnecessary in this mode.
+         *     - Manual mode: `first_name`, `last_name`, `email`, `phone` are required.
+         *
          */
         post: {
             parameters: {
@@ -4062,47 +4121,81 @@ export interface paths {
                          */
                         wallet_id: string;
                         /**
-                         * @description Cardholder's first name
+                         * Format: uuid
+                         * @description Seed personal data + KYC documents from this verified user (user_data.uuid).
+                         *     When set, personal fields become optional and only fill gaps.
+                         *
+                         */
+                        user_data_id?: string;
+                        /**
+                         * @description Cardholder's first name (required in manual mode)
                          * @example John
                          */
-                        first_name: string;
+                        first_name?: string;
                         /**
-                         * @description Cardholder's last name
+                         * @description Cardholder's last name (required in manual mode)
                          * @example Doe
                          */
-                        last_name: string;
+                        last_name?: string;
                         /**
                          * Format: email
-                         * @description Cardholder's email address
+                         * @description Cardholder's email address (required in manual mode)
                          * @example john.doe@example.com
                          */
-                        email: string;
+                        email?: string;
                         /**
-                         * @description Cardholder's phone number in E.164 format (+ followed by 1-15 digits)
+                         * @description Cardholder's phone number in E.164 format (required in manual mode)
                          * @example +14155552671
                          */
-                        phone: string;
+                        phone?: string;
                         /**
                          * Format: uuid
                          * @description Issuing program ID (required). vendor_id is resolved from the program automatically.
                          */
                         issuing_program_id: string;
-                        /**
-                         * Format: uuid
-                         * @description Sub-account ID (required for balance card vendors)
-                         */
-                        sub_account_id?: string;
                         /**
                          * Format: date
-                         * @description Cardholder's date of birth
+                         * @description Cardholder's date of birth (YYYY-MM-DD)
                          * @example 1990-01-15
                          */
-                        date_of_birth?: string;
+                        birth_date?: string;
                         /**
                          * @description Cardholder's nationality as ISO 3166-1 alpha-3 country code
                          * @example USA
                          */
                         nationality?: string;
+                        /**
+                         * @description Cardholder's gender (required by some vendors)
+                         * @enum {string}
+                         */
+                        gender?: "M" | "F";
+                        /**
+                         * @description Relationship of the cardholder to the account holder
+                         * @enum {string}
+                         */
+                        cardholder_relationship?: "EMPLOYEE" | "CONTRACTOR";
+                        /**
+                         * @description Identity document type (KYC vendors)
+                         * @enum {string}
+                         */
+                        gov_id_type?: "passport" | "id_card" | "driving_license";
+                        /** @description Identity document number */
+                        gov_id_number?: string;
+                        /**
+                         * @description Issuing country of the identity document (2-3 letter code)
+                         * @example USA
+                         */
+                        gov_id_country?: string;
+                        /**
+                         * Format: date
+                         * @description Identity document issue date (YYYY-MM-DD)
+                         */
+                        gov_id_issuance_date?: string;
+                        /**
+                         * Format: date
+                         * @description Identity document expiry date (YYYY-MM-DD)
+                         */
+                        gov_id_expiration_date?: string;
                         /** @description Cardholder's address */
                         address?: {
                             /**
@@ -4128,7 +4221,7 @@ export interface paths {
                 };
             };
             responses: {
-                /** @description Cardholder created and registered at vendor successfully */
+                /** @description Cardholder draft created (status DRAFT, not yet registered at the vendor) */
                 201: {
                     headers: {
                         [name: string]: unknown;
@@ -4138,7 +4231,7 @@ export interface paths {
                             /** @example true */
                             success?: boolean;
                             data?: components["schemas"]["IssuingCardholder"];
-                            /** @example Cardholder created successfully */
+                            /** @example Cardholder draft created successfully */
                             message?: string;
                         };
                     };
@@ -4352,6 +4445,19 @@ export interface paths {
                          * @example USA
                          */
                         nationality?: string;
+                        /** @enum {string} */
+                        gender?: "M" | "F";
+                        /** @enum {string} */
+                        cardholder_relationship?: "EMPLOYEE" | "CONTRACTOR";
+                        /** @enum {string} */
+                        gov_id_type?: "passport" | "id_card" | "driving_license";
+                        gov_id_number?: string;
+                        /** @description 2-3 letter uppercase country code */
+                        gov_id_country?: string;
+                        /** Format: date */
+                        gov_id_issuance_date?: string;
+                        /** Format: date */
+                        gov_id_expiration_date?: string;
                         address?: {
                             line1?: string;
                             line2?: string;
@@ -4404,40 +4510,51 @@ export interface paths {
         };
         trace?: never;
     };
-    "/frontend/kyc_persona/{wallet_id}/init": {
+    "/frontend/issuing/cardholders/{cardholder_id}/submit": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
+        get?: never;
+        put?: never;
         /**
-         * Initialize Persona KYC session for a wallet
-         * @description Creates a Persona inquiry via the Auth API for the specified wallet and
-         *     returns the hosted Persona URL. The caller's Bearer token is forwarded to
-         *     the Auth API; access requires the caller to be a member of the wallet
-         *     (ownership/membership is enforced by the standard wallet-access check).
+         * Submit cardholder draft
+         * @description Registers a `DRAFT` cardholder at the vendor and flips it to `ACTIVE` — step 3 of the
+         *     create flow. The vendor is resolved from the cardholder's issuing program.
+         *
+         *     **Dossier check**: the submit is refused with `400
+         *     CARDHOLDER_SUBMISSION_INCOMPLETE` while the program's KYC level is not met.
+         *     `error.details.missing` lists every field and file still needed (e.g. `gender`,
+         *     `documents: selfie`), so the client can complete it and retry.
+         *
+         *     **Retryable**: a failed submit leaves the draft untouched. Nothing is rolled back,
+         *     and the same endpoint can be called again once the dossier is complete.
+         *
+         *     **Idempotency**: submitting an already-active cardholder returns `409
+         *     CARDHOLDER_NOT_DRAFT` rather than registering it twice.
          *
          *     **Authentication**: Bearer token with x-tenant-id header required
          *
-         *     **Access Control**: Any user with access to the wallet (scoped card-users excluded)
+         *     **Access Control**: Cardholder must belong to the user's wallet (admin role)
          *
          */
-        get: {
+        post: {
             parameters: {
                 query: {
-                    type: "individual" | "business";
+                    /** @description Wallet ID for access validation */
+                    wallet_id: string;
                 };
                 header?: never;
                 path: {
-                    /** @description Wallet UUID */
-                    wallet_id: string;
+                    cardholder_id: string;
                 };
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Persona link generated successfully */
+                /** @description Cardholder registered at the vendor and activated */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -4445,37 +4562,14 @@ export interface paths {
                     content: {
                         "application/json": {
                             /** @example true */
-                            success: boolean;
-                            data: {
-                                /**
-                                 * Format: uuid
-                                 * @description Echo of the wallet from the path
-                                 * @example eaf37846-3669-4b4a-9555-b27f75e023c1
-                                 */
-                                wallet_id: string;
-                                /**
-                                 * @description Persona inquiry ID returned by the Auth API
-                                 * @example inq_ABDNxhp9ZzD3yehivCbMVvmjwh5g5r
-                                 */
-                                inquiry_id: string;
-                                /**
-                                 * @description Persona session token, when upstream returns one — otherwise null
-                                 * @example null
-                                 */
-                                session_id: string | null;
-                                /**
-                                 * Format: uri
-                                 * @description Hosted Persona URL with `inquiry-id` (and `session-token` if `session_id` is present).
-                                 *     Base host: `PERSONA_HOSTED_FLOW_URL` env, default `https://withpersona.com/verify`.
-                                 *
-                                 * @example https://withpersona.com/verify?inquiry-id=inq_ABDNxhp9ZzD3yehivCbMVvmjwh5g5r
-                                 */
-                                url: string;
-                            };
+                            success?: boolean;
+                            data?: components["schemas"]["IssuingCardholder"];
+                            /** @example Cardholder submitted successfully */
+                            message?: string;
                         };
                     };
                 };
-                /** @description Validation error (`type` missing or not in [individual, business]) */
+                /** @description KYC dossier incomplete, or the program has no vendor configured */
                 400: {
                     headers: {
                         [name: string]: unknown;
@@ -4484,179 +4578,220 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Missing or invalid Bearer token */
-                401: {
+                /** @description Access denied to this cardholder */
+                403: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
+                    content?: never;
                 };
-                /** @description Caller has no access to this wallet */
-                403: {
+                /** @description Cardholder not found */
+                404: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
+                    content?: never;
                 };
-                /** @description Auth API responded 404 (wallet not found upstream) */
-                404: {
+                /** @description Cardholder is not a draft (already submitted) */
+                409: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
+                    content?: never;
                 };
-                /** @description Auth API unavailable, timed out, or returned malformed payload */
+                /** @description Vendor rejected the registration; the draft is kept */
                 502: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
+                    content?: never;
                 };
             };
         };
-        put?: never;
-        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/frontend/kyc_persona/{wallet_id}/resume": {
+    "/frontend/issuing/cardholder-documents": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
+        get?: never;
+        put?: never;
         /**
-         * Resume Persona KYC session for a wallet
-         * @description Resumes an existing Persona inquiry via the Auth API for the specified
-         *     wallet and returns the hosted Persona URL. The caller's Bearer token is
-         *     forwarded to the Auth API; access requires the caller to be a member of
-         *     the wallet (ownership/membership is enforced by the standard wallet-access check).
+         * Upload KYC document files
+         * @description Uploads KYC files against a wallet via `multipart/form-data`, with no
+         *     cardholder involved — the upload step of the create flow runs before the
+         *     cardholder exists. The form field name is the document type (`selfie`,
+         *     `gov_id_front`, `gov_id_back`); one file per type, 5MB max each, formats
+         *     png/jpeg/pdf.
+         *
+         *     Send one file per request so the UI can show progress per file and retry
+         *     a single file. The response returns an `id` per file; pass those ids to
+         *     `POST /frontend/issuing/cardholders/{cardholder_id}/documents` to attach
+         *     them to a draft.
+         *
+         *     Do not set `Content-Type` manually — the browser must add the multipart
+         *     boundary itself, and the file has to be appended as a `File`/`Blob`, not
+         *     as a name or a base64 string.
+         *
+         *     An upload that is never attached is deleted by a cleanup sweep.
          *
          *     **Authentication**: Bearer token with x-tenant-id header required
          *
-         *     **Access Control**: Any user with access to the wallet (scoped card-users excluded)
+         *     **Access Control**: wallet admin role
          *
          */
-        get: {
+        post: {
             parameters: {
                 query: {
-                    inquiry_id: string;
-                };
-                header?: never;
-                path: {
-                    /** @description Wallet UUID */
+                    /** @description Wallet ID for access validation */
                     wallet_id: string;
                 };
+                header?: never;
+                path?: never;
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody: {
+                content: {
+                    "multipart/form-data": {
+                        /**
+                         * Format: binary
+                         * @description Identity photo / selfie
+                         */
+                        selfie?: string;
+                        /**
+                         * Format: binary
+                         * @description Government ID, front side
+                         */
+                        gov_id_front?: string;
+                        /**
+                         * Format: binary
+                         * @description Government ID, back side
+                         */
+                        gov_id_back?: string;
+                    };
+                };
+            };
             responses: {
-                /** @description Persona link generated successfully */
-                200: {
+                /** @description Files stored; returns one upload per file */
+                201: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
                             /** @example true */
-                            success: boolean;
-                            data: {
-                                /**
-                                 * Format: uuid
-                                 * @description Echo of the wallet from the path
-                                 * @example eaf37846-3669-4b4a-9555-b27f75e023c1
-                                 */
-                                wallet_id: string;
-                                /**
-                                 * @description Persona inquiry ID returned by the Auth API (same as the one being resumed)
-                                 * @example inq_ABDNxhp9ZzD3yehivCbMVvmjwh5g5r
-                                 */
-                                inquiry_id: string;
-                                /**
-                                 * @description Persona session token, when upstream returns one — otherwise null
-                                 * @example null
-                                 */
-                                session_id: string | null;
-                                /**
-                                 * Format: uri
-                                 * @description Hosted Persona URL with `inquiry-id` (and `session-token` if `session_id` is present).
-                                 *     Base host: `PERSONA_HOSTED_FLOW_URL` env, default `https://withpersona.com/verify`.
-                                 *
-                                 * @example https://withpersona.com/verify?inquiry-id=inq_ABDNxhp9ZzD3yehivCbMVvmjwh5g5r
-                                 */
-                                url: string;
+                            success?: boolean;
+                            /** @example Documents uploaded successfully */
+                            message?: string;
+                            data?: {
+                                documents?: {
+                                    /** Format: uuid */
+                                    id?: string;
+                                    /** @enum {string} */
+                                    type?: "selfie" | "gov_id_front" | "gov_id_back";
+                                    filename?: string | null;
+                                    content_type?: string;
+                                    size?: number;
+                                    /** Format: date-time */
+                                    created_at?: string;
+                                }[];
                             };
                         };
                     };
                 };
-                /** @description Validation error (`inquiry_id` missing or empty) */
+                /** @description No file parts, unsupported field/type, or a file exceeds 5MB */
                 400: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Missing or invalid Bearer token */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
+                    content?: never;
                 };
-                /** @description Caller has no access to this wallet */
+                /** @description Access denied to this wallet */
                 403: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Auth API responded 404 (no such inquiry to resume) */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
+                    content?: never;
                 };
-                /** @description Auth API unavailable, timed out, or returned malformed payload */
-                502: {
-                    headers: {
-                        [name: string]: unknown;
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/frontend/issuing/cardholder-documents/{document_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Discard an uploaded file
+         * @description Deletes an upload that has not been attached to a cardholder yet — the
+         *     "remove this file" action of the upload form. Attached documents are
+         *     refused with 409; replace them by attaching a new file of the same type.
+         *
+         *     **Authentication**: Bearer token with x-tenant-id header required
+         *
+         *     **Access Control**: wallet admin role
+         *
+         */
+        delete: {
+            parameters: {
+                query: {
+                    /** @description Wallet ID for access validation */
+                    wallet_id: string;
+                };
+                header?: never;
+                path: {
+                    document_id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Upload discarded */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
                     };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                    content?: never;
+                };
+                /** @description Upload not found for this wallet */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Upload is already attached to a cardholder */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
                     };
+                    content?: never;
                 };
             };
         };
-        put?: never;
-        post?: never;
-        delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/frontend/kyc_verification/{wallet_id}/init": {
+    "/frontend/issuing/cardholders/{cardholder_id}/documents": {
         parameters: {
             query?: never;
             header?: never;
@@ -4666,45 +4801,130 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Initialize KYC verification for a wallet
-         * @description Starts a provider-agnostic KYC data-collection flow for the wallet via
-         *     the Auth API. The KYC provider (Persona, Sumsub, …) is resolved
-         *     internally per tenant — the caller does not choose it. Returns the
-         *     provider verification id plus an optional short-lived SDK token the
-         *     client uses to launch the verification. The caller's Bearer token is
-         *     forwarded to the Auth API.
+         * Attach uploaded KYC documents to a cardholder
+         * @description Attaches files already uploaded via
+         *     `POST /frontend/issuing/cardholder-documents` to this cardholder. The
+         *     body carries upload ids only — no file bytes travel here.
          *
-         *     Provider-agnostic replacement for the deprecated
-         *     `GET /frontend/kyc_persona/{wallet_id}/init`.
+         *     A document of a type the cardholder already has replaces the previous
+         *     one, and the superseded file is deleted. An upload can only be attached
+         *     once, and only to a cardholder in the wallet it was uploaded for.
+         *
+         *     Documents are not pushed to the vendor here; they travel at
+         *     `POST /cardholders/{cardholder_id}/submit`.
          *
          *     **Authentication**: Bearer token with x-tenant-id header required
          *
-         *     **Access Control**: Any user with access to the wallet (scoped card-users excluded)
+         *     **Access Control**: Cardholder must belong to the user's wallet (admin role)
          *
          */
         post: {
             parameters: {
-                query?: never;
+                query: {
+                    /** @description Wallet ID for access validation */
+                    wallet_id: string;
+                };
                 header?: never;
                 path: {
-                    /** @description Wallet UUID */
-                    wallet_id: string;
+                    cardholder_id: string;
                 };
                 cookie?: never;
             };
             requestBody: {
                 content: {
                     "application/json": {
-                        /**
-                         * @description KYC entity type
-                         * @enum {string}
-                         */
-                        type: "individual" | "business";
+                        /** @description Ids returned by the upload endpoint */
+                        document_ids: string[];
                     };
                 };
             };
             responses: {
-                /** @description KYC verification initialized */
+                /** @description Documents attached; returns the updated cardholder */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success?: boolean;
+                            /** @example Documents attached successfully */
+                            message?: string;
+                            /** @description Updated cardholder with refreshed kyc_documents */
+                            data?: Record<string, never>;
+                        };
+                    };
+                };
+                /** @description document_ids missing, empty, or listing two files of one type */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Access denied to this cardholder */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Cardholder or upload id not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description An upload is already attached to a cardholder */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/frontend/kyc_persona/{wallet_id}/init": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Initialize Persona KYC session for a wallet
+         * @description Creates a Persona inquiry via the Auth API for the specified wallet and
+         *     returns the hosted Persona URL. The caller's Bearer token is forwarded to
+         *     the Auth API; access requires the caller to be a member of the wallet
+         *     (ownership/membership is enforced by the standard wallet-access check).
+         *
+         *     **Authentication**: Bearer token with x-tenant-id header required
+         *
+         *     **Access Control**: Any user with access to the wallet (scoped card-users excluded)
+         *
+         */
+        get: {
+            parameters: {
+                query: {
+                    type: "individual" | "business";
+                };
+                header?: never;
+                path: {
+                    /** @description Wallet UUID */
+                    wallet_id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Persona link generated successfully */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -4717,20 +4937,27 @@ export interface paths {
                                 /**
                                  * Format: uuid
                                  * @description Echo of the wallet from the path
+                                 * @example eaf37846-3669-4b4a-9555-b27f75e023c1
                                  */
                                 wallet_id: string;
                                 /**
-                                 * @description Provider that handled the flow (e.g. persona, sumsub)
-                                 * @example persona
+                                 * @description Persona inquiry ID returned by the Auth API
+                                 * @example inq_ABDNxhp9ZzD3yehivCbMVvmjwh5g5r
                                  */
-                                provider_type: string;
+                                inquiry_id: string;
                                 /**
-                                 * @description Provider verification id — Persona: inquiryId, Sumsub: applicantId
-                                 * @example inq_ABDNxhp9ZzD3yehivCbMVvmjwh5g5r
+                                 * @description Persona session token, when upstream returns one — otherwise null
+                                 * @example null
                                  */
-                                verification_id: string;
-                                /** @description Short-lived SDK/session token when the provider mints one — otherwise null */
-                                verification_token?: string | null;
+                                session_id: string | null;
+                                /**
+                                 * Format: uri
+                                 * @description Hosted Persona URL with `inquiry-id` (and `session-token` if `session_id` is present).
+                                 *     Base host: `PERSONA_HOSTED_FLOW_URL` env, default `https://withpersona.com/verify`.
+                                 *
+                                 * @example https://withpersona.com/verify?inquiry-id=inq_ABDNxhp9ZzD3yehivCbMVvmjwh5g5r
+                                 */
+                                url: string;
                             };
                         };
                     };
@@ -4762,7 +4989,7 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Wallet not found upstream */
+                /** @description Auth API responded 404 (wallet not found upstream) */
                 404: {
                     headers: {
                         [name: string]: unknown;
@@ -4771,7 +4998,7 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Auth API unavailable, timed out, or returned a malformed payload */
+                /** @description Auth API unavailable, timed out, or returned malformed payload */
                 502: {
                     headers: {
                         [name: string]: unknown;
@@ -4782,40 +5009,38 @@ export interface paths {
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/frontend/kyc_verification/{wallet_id}/resume": {
+    "/frontend/kyc_persona/{wallet_id}/resume": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
         /**
-         * Resume KYC verification for a wallet
-         * @description Resumes an existing provider-agnostic KYC data-collection flow for the
-         *     wallet via the Auth API. The provider is resolved internally per tenant.
-         *     `verification_ref` is the provider reference returned by init (Persona:
-         *     `inquiry_id`, Sumsub: `applicant_id`). The caller's Bearer token is
-         *     forwarded to the Auth API.
-         *
-         *     Provider-agnostic replacement for the deprecated
-         *     `GET /frontend/kyc_persona/{wallet_id}/resume`.
+         * Resume Persona KYC session for a wallet
+         * @description Resumes an existing Persona inquiry via the Auth API for the specified
+         *     wallet and returns the hosted Persona URL. The caller's Bearer token is
+         *     forwarded to the Auth API; access requires the caller to be a member of
+         *     the wallet (ownership/membership is enforced by the standard wallet-access check).
          *
          *     **Authentication**: Bearer token with x-tenant-id header required
          *
          *     **Access Control**: Any user with access to the wallet (scoped card-users excluded)
          *
          */
-        post: {
+        get: {
             parameters: {
-                query?: never;
+                query: {
+                    inquiry_id: string;
+                };
                 header?: never;
                 path: {
                     /** @description Wallet UUID */
@@ -4823,19 +5048,9 @@ export interface paths {
                 };
                 cookie?: never;
             };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        /**
-                         * @description Provider verification reference (Persona: inquiry_id, Sumsub: applicant_id)
-                         * @example inq_ABDNxhp9ZzD3yehivCbMVvmjwh5g5r
-                         */
-                        verification_ref: string;
-                    };
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description KYC verification resumed */
+                /** @description Persona link generated successfully */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -4848,25 +5063,32 @@ export interface paths {
                                 /**
                                  * Format: uuid
                                  * @description Echo of the wallet from the path
+                                 * @example eaf37846-3669-4b4a-9555-b27f75e023c1
                                  */
                                 wallet_id: string;
                                 /**
-                                 * @description Provider that handled the flow (e.g. persona, sumsub)
-                                 * @example persona
+                                 * @description Persona inquiry ID returned by the Auth API (same as the one being resumed)
+                                 * @example inq_ABDNxhp9ZzD3yehivCbMVvmjwh5g5r
                                  */
-                                provider_type: string;
+                                inquiry_id: string;
                                 /**
-                                 * @description Provider verification id — Persona: inquiryId, Sumsub: applicantId
-                                 * @example inq_ABDNxhp9ZzD3yehivCbMVvmjwh5g5r
+                                 * @description Persona session token, when upstream returns one — otherwise null
+                                 * @example null
                                  */
-                                verification_id: string;
-                                /** @description Short-lived SDK/session token when the provider mints one — otherwise null */
-                                verification_token?: string | null;
+                                session_id: string | null;
+                                /**
+                                 * Format: uri
+                                 * @description Hosted Persona URL with `inquiry-id` (and `session-token` if `session_id` is present).
+                                 *     Base host: `PERSONA_HOSTED_FLOW_URL` env, default `https://withpersona.com/verify`.
+                                 *
+                                 * @example https://withpersona.com/verify?inquiry-id=inq_ABDNxhp9ZzD3yehivCbMVvmjwh5g5r
+                                 */
+                                url: string;
                             };
                         };
                     };
                 };
-                /** @description Validation error (`verification_ref` missing or empty) */
+                /** @description Validation error (`inquiry_id` missing or empty) */
                 400: {
                     headers: {
                         [name: string]: unknown;
@@ -4893,7 +5115,141 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description No such verification to resume upstream */
+                /** @description Auth API responded 404 (no such inquiry to resume) */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Auth API unavailable, timed out, or returned malformed payload */
+                502: {
+                    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/kyc_verification/{wallet_id}/init": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Initialize KYC verification for a wallet
+         * @description Starts a provider-agnostic KYC data-collection flow for the wallet via
+         *     the Auth API. The KYC provider (Persona, Sumsub, …) is resolved
+         *     internally per tenant — the caller does not choose it. Returns the
+         *     provider verification id plus an optional short-lived SDK token the
+         *     client uses to launch the verification. The caller's Bearer token is
+         *     forwarded to the Auth API.
+         *
+         *     Provider-agnostic replacement for the deprecated
+         *     `GET /frontend/kyc_persona/{wallet_id}/init`.
+         *
+         *     **Authentication**: Bearer token with x-tenant-id header required
+         *
+         *     **Access Control**: Any user with access to the wallet (scoped card-users excluded)
+         *
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Wallet UUID */
+                    wallet_id: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /**
+                         * @description KYC entity type
+                         * @enum {string}
+                         */
+                        type: "individual" | "business";
+                    };
+                };
+            };
+            responses: {
+                /** @description KYC verification initialized */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success: boolean;
+                            data: {
+                                /**
+                                 * Format: uuid
+                                 * @description Echo of the wallet from the path
+                                 */
+                                wallet_id: string;
+                                /**
+                                 * @description Provider that handled the flow (e.g. persona, sumsub)
+                                 * @example persona
+                                 */
+                                provider_type: string;
+                                /**
+                                 * @description Provider verification id — Persona: inquiryId, Sumsub: applicantId
+                                 * @example inq_ABDNxhp9ZzD3yehivCbMVvmjwh5g5r
+                                 */
+                                verification_id: string;
+                                /** @description Short-lived SDK/session token when the provider mints one — otherwise null */
+                                verification_token?: string | null;
+                            };
+                        };
+                    };
+                };
+                /** @description Validation error (`type` missing or not in [individual, business]) */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Missing or invalid Bearer token */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Caller has no access to this wallet */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Wallet not found upstream */
                 404: {
                     headers: {
                         [name: string]: unknown;
@@ -4919,31 +5275,534 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/mass-payouts/{wallet_id}": {
+    "/frontend/kyc_verification/{wallet_id}/resume": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Resume KYC verification for a wallet
+         * @description Resumes an existing provider-agnostic KYC data-collection flow for the
+         *     wallet via the Auth API. The provider is resolved internally per tenant.
+         *     `verification_ref` is the provider reference returned by init (Persona:
+         *     `inquiry_id`, Sumsub: `applicant_id`). The caller's Bearer token is
+         *     forwarded to the Auth API.
+         *
+         *     Provider-agnostic replacement for the deprecated
+         *     `GET /frontend/kyc_persona/{wallet_id}/resume`.
+         *
+         *     **Authentication**: Bearer token with x-tenant-id header required
+         *
+         *     **Access Control**: Any user with access to the wallet (scoped card-users excluded)
+         *
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Wallet UUID */
+                    wallet_id: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /**
+                         * @description Provider verification reference (Persona: inquiry_id, Sumsub: applicant_id)
+                         * @example inq_ABDNxhp9ZzD3yehivCbMVvmjwh5g5r
+                         */
+                        verification_ref: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description KYC verification resumed */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success: boolean;
+                            data: {
+                                /**
+                                 * Format: uuid
+                                 * @description Echo of the wallet from the path
+                                 */
+                                wallet_id: string;
+                                /**
+                                 * @description Provider that handled the flow (e.g. persona, sumsub)
+                                 * @example persona
+                                 */
+                                provider_type: string;
+                                /**
+                                 * @description Provider verification id — Persona: inquiryId, Sumsub: applicantId
+                                 * @example inq_ABDNxhp9ZzD3yehivCbMVvmjwh5g5r
+                                 */
+                                verification_id: string;
+                                /** @description Short-lived SDK/session token when the provider mints one — otherwise null */
+                                verification_token?: string | null;
+                            };
+                        };
+                    };
+                };
+                /** @description Validation error (`verification_ref` missing or empty) */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Missing or invalid Bearer token */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Caller has no access to this wallet */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description No such verification to resume upstream */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Auth API unavailable, timed out, or returned a malformed payload */
+                502: {
+                    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}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List mass payouts of a wallet */
+        get: {
+            parameters: {
+                query?: {
+                    status?: "DRAFT" | "PENDING_APPROVAL" | "PROCESSING" | "COMPLETED" | "FAILED" | "CANCELED";
+                    limit?: number;
+                    offset?: number;
+                };
+                header?: never;
+                path: {
+                    /** @description Source wallet the batches belong to */
+                    wallet_id: components["parameters"]["MassPayoutWalletId"];
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Page of batches, newest first */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success?: boolean;
+                            data?: {
+                                items?: components["schemas"]["MassPayout"][];
+                                total?: number;
+                                limit?: number;
+                                offset?: number;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        /**
+         * 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: {
+                    /** @description Source wallet the batches belong to */
+                    wallet_id: components["parameters"]["MassPayoutWalletId"];
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** Format: uuid */
+                        currency_id: string;
+                        /** Format: uuid */
+                        virtual_account_id?: string;
+                        name: string;
+                        items: components["schemas"]["MassPayoutItemInput"][];
+                    };
+                };
+            };
+            responses: {
+                /** @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;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/frontend/mass-payouts/{wallet_id}/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get a mass payout */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Source wallet the batches belong to */
+                    wallet_id: components["parameters"]["MassPayoutWalletId"];
+                    id: components["parameters"]["MassPayoutId"];
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Batch details with progress counters and total amount */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success?: boolean;
+                            data?: components["schemas"]["MassPayout"];
+                        };
+                    };
+                };
+                /** @description Mass payout not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        /**
+         * Edit a mass payout draft
+         * @description Draft-only. `items` fully replaces the recipient list; `virtual_account_id: null` clears the source VA.
+         */
+        put: {
+            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: {
+                content: {
+                    "application/json": {
+                        name?: string;
+                        /** Format: uuid */
+                        virtual_account_id?: string | null;
+                        items?: components["schemas"]["MassPayoutItemInput"][];
+                    };
+                };
+            };
+            responses: {
+                /** @description Updated draft */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success?: boolean;
+                            data?: components["schemas"]["MassPayout"];
+                        };
+                    };
+                };
+                /** @description Batch is not editable anymore (already submitted) */
+                409: {
+                    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;
+                };
+                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": {
+                            /** @example true */
+                            success?: boolean;
+                            data?: {
+                                items?: components["schemas"]["MassPayoutItem"][];
+                                total?: number;
+                                limit?: number;
+                                offset?: number;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        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": {
+                            /** @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/mass-payouts/{wallet_id}/{id}/submit": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** List mass payouts of a wallet */
-        get: {
+        get?: never;
+        put?: never;
+        /**
+         * 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?: {
-                    status?: "DRAFT" | "PENDING_APPROVAL" | "PROCESSING" | "COMPLETED" | "FAILED" | "CANCELED";
-                    limit?: number;
-                    offset?: number;
-                };
+                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 Page of batches, newest first */
+                /** @description Batch is awaiting approval */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -4952,26 +5811,53 @@ export interface paths {
                         "application/json": {
                             /** @example true */
                             success?: boolean;
-                            data?: {
-                                items?: components["schemas"]["MassPayout"][];
-                                total?: number;
-                                limit?: number;
-                                offset?: number;
-                            };
+                            data?: components["schemas"]["MassPayout"];
                         };
                     };
                 };
+                /** @description Batch has invalid items (details carry the per-item problems) */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Batch is not in DRAFT */
+                409: {
+                    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}/approve": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
         put?: never;
         /**
-         * 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.
+         * 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: {
@@ -4981,23 +5867,13 @@ export interface paths {
                 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 */
-                        currency_id: string;
-                        /** Format: uuid */
-                        virtual_account_id?: string;
-                        name: string;
-                        items: components["schemas"]["MassPayoutItemInput"][];
-                    };
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description Draft created */
+                /** @description Execution started */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5010,16 +5886,7 @@ export interface paths {
                         };
                     };
                 };
-                /** @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 */
+                /** @description Second-factor verification is stale or the caller lacks permission */
                 403: {
                     headers: {
                         [name: string]: unknown;
@@ -5028,8 +5895,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;
                     };
@@ -5045,15 +5912,20 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/mass-payouts/{wallet_id}/{id}": {
+    "/frontend/mass-payouts/{wallet_id}/{id}/cancel": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** Get a mass payout */
-        get: {
+        get?: never;
+        put?: never;
+        /**
+         * 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;
@@ -5066,7 +5938,7 @@ export interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Batch details with progress counters and total amount */
+                /** @description Batch canceled */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5079,8 +5951,8 @@ export interface paths {
                         };
                     };
                 };
-                /** @description Mass payout not found */
-                404: {
+                /** @description Batch can no longer be canceled */
+                409: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -5090,11 +5962,26 @@ export interface paths {
                 };
             };
         };
+        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;
+        };
         /**
-         * Edit a mass payout draft
-         * @description Draft-only. `items` fully replaces the recipient list; `virtual_account_id: null` clears the source VA.
+         * 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.
+         *
          */
-        put: {
+        get: {
             parameters: {
                 query?: never;
                 header?: never;
@@ -5105,32 +5992,19 @@ export interface paths {
                 };
                 cookie?: never;
             };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        name?: string;
-                        /** Format: uuid */
-                        virtual_account_id?: string | null;
-                        items?: components["schemas"]["MassPayoutItemInput"][];
-                    };
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description Updated draft */
+                /** @description CSV file */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": {
-                            /** @example true */
-                            success?: boolean;
-                            data?: components["schemas"]["MassPayout"];
-                        };
+                        "text/csv": string;
                     };
                 };
-                /** @description Batch is not editable anymore (already submitted) */
-                409: {
+                /** @description Mass payout not found */
+                404: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -5140,6 +6014,7 @@ export interface paths {
                 };
             };
         };
+        put?: never;
         post?: never;
         delete?: never;
         options?: never;
@@ -5147,7 +6022,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/mass-payouts/{wallet_id}/{id}/items": {
+    "/frontend/notification-preferences": {
         parameters: {
             query?: never;
             header?: never;
@@ -5155,26 +6030,19 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * List items of a mass payout
-         * @description Items in upload order, paginated with limit/offset like the batch list.
+         * Effective delivery-channel preferences
+         * @description Full channel list with defaults applied. `IN_APP` is always enabled (cannot be disabled).
          */
         get: {
             parameters: {
-                query?: {
-                    limit?: number;
-                    offset?: number;
-                };
+                query?: never;
                 header?: never;
-                path: {
-                    /** @description Source wallet the batches belong to */
-                    wallet_id: components["parameters"]["MassPayoutWalletId"];
-                    id: components["parameters"]["MassPayoutId"];
-                };
+                path?: never;
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Page of items */
+                /** @description Effective preference per channel. */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5184,17 +6052,58 @@ export interface paths {
                             /** @example true */
                             success?: boolean;
                             data?: {
-                                items?: components["schemas"]["MassPayoutItem"][];
-                                total?: number;
-                                limit?: number;
-                                offset?: number;
+                                preferences?: components["schemas"]["NotificationPreference"][];
                             };
                         };
                     };
                 };
+                401: components["responses"]["UnauthorizedError"];
+            };
+        };
+        /**
+         * Update delivery-channel preferences
+         * @description Bulk upsert. Disabling `IN_APP` is rejected with 400 (`INBOX_CHANNEL_LOCKED`). Changes apply from the next delivery.
+         */
+        put: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        preferences: components["schemas"]["NotificationPreference"][];
+                    };
+                };
+            };
+            responses: {
+                /** @description Effective preference list after the update. */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success?: boolean;
+                            data?: {
+                                preferences?: components["schemas"]["NotificationPreference"][];
+                            };
+                        };
+                    };
+                };
+                /** @description Invalid body (`VALIDATION_ERROR`) or an attempt to disable `IN_APP` (`INBOX_CHANNEL_LOCKED`). */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                401: components["responses"]["UnauthorizedError"];
             };
         };
-        put?: never;
         post?: never;
         delete?: never;
         options?: never;
@@ -5202,35 +6111,30 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/mass-payouts/{wallet_id}/{id}/preview": {
+    "/frontend/notifications": {
         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).
-         *
-         */
+        /** List the notification inbox (newest first, cursor pagination) */
         get: {
             parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    /** @description Source wallet the batches belong to */
-                    wallet_id: components["parameters"]["MassPayoutWalletId"];
-                    id: components["parameters"]["MassPayoutId"];
+                query?: {
+                    /** @description Opaque cursor from a previous page (`next_cursor`). Omit for the first page. */
+                    cursor?: string;
+                    limit?: number;
+                    unread_only?: "true" | "false";
+                    wallet_id?: string;
                 };
+                header?: never;
+                path?: never;
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Validation report, fee estimates and balance check */
+                /** @description Page of notifications; `next_cursor` is null on the final page. */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5240,43 +6144,20 @@ export interface paths {
                             /** @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;
-                                }[];
+                                items?: components["schemas"]["NotificationView"][];
+                                next_cursor?: string | null;
                             };
                         };
                     };
                 };
+                /** @description Invalid query (`VALIDATION_ERROR`) or a broken cursor (`NOTIFICATION_CURSOR_INVALID`). */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                401: components["responses"]["UnauthorizedError"];
             };
         };
         put?: never;
@@ -5287,35 +6168,24 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/mass-payouts/{wallet_id}/{id}/submit": {
+    "/frontend/notifications/unread-count": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
-        /**
-         * 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: {
+        /** Unread notifications count (badge) */
+        get: {
             parameters: {
                 query?: never;
                 header?: never;
-                path: {
-                    /** @description Source wallet the batches belong to */
-                    wallet_id: components["parameters"]["MassPayoutWalletId"];
-                    id: components["parameters"]["MassPayoutId"];
-                };
+                path?: never;
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Batch is awaiting approval */
+                /** @description Current unread count. */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5324,37 +6194,25 @@ export interface paths {
                         "application/json": {
                             /** @example true */
                             success?: boolean;
-                            data?: components["schemas"]["MassPayout"];
+                            data?: {
+                                /** @example 3 */
+                                count?: number;
+                            };
                         };
                     };
                 };
-                /** @description Batch has invalid items (details carry the per-item problems) */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Batch is not in DRAFT */
-                409: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
+                401: components["responses"]["UnauthorizedError"];
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/frontend/mass-payouts/{wallet_id}/{id}/approve": {
+    "/frontend/notifications/mark-read": {
         parameters: {
             query?: never;
             header?: never;
@@ -5364,29 +6222,25 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * 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.
-         *
+         * Mark specific notifications as read
+         * @description Idempotent — already-read ids are not counted. Other tabs/devices sync via the realtime `notifications.read` event.
          */
         post: {
             parameters: {
                 query?: never;
                 header?: never;
-                path: {
-                    /** @description Source wallet the batches belong to */
-                    wallet_id: components["parameters"]["MassPayoutWalletId"];
-                    id: components["parameters"]["MassPayoutId"];
-                };
+                path?: never;
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody: {
+                content: {
+                    "application/json": {
+                        notification_ids: string[];
+                    };
+                };
+            };
             responses: {
-                /** @description Execution started */
+                /** @description Number of notifications actually transitioned to read. */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5395,28 +6249,21 @@ export interface paths {
                         "application/json": {
                             /** @example true */
                             success?: boolean;
-                            data?: components["schemas"]["MassPayout"];
+                            data?: {
+                                /** @example 2 */
+                                updated?: number;
+                            };
                         };
                     };
                 };
-                /** @description Second-factor verification is stale or the caller lacks permission */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Batch is not awaiting approval */
-                409: {
+                /** @description Invalid body (`VALIDATION_ERROR`). */
+                400: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
+                    content?: never;
                 };
+                401: components["responses"]["UnauthorizedError"];
             };
         };
         delete?: never;
@@ -5425,7 +6272,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/mass-payouts/{wallet_id}/{id}/cancel": {
+    "/frontend/notifications/mark-all-read": {
         parameters: {
             query?: never;
             header?: never;
@@ -5434,24 +6281,17 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /**
-         * Cancel a mass payout
-         * @description Allowed from DRAFT and PENDING_APPROVAL. A PROCESSING batch cannot be canceled — payouts are already executing.
-         */
+        /** Mark every unread notification as read */
         post: {
             parameters: {
                 query?: never;
                 header?: never;
-                path: {
-                    /** @description Source wallet the batches belong to */
-                    wallet_id: components["parameters"]["MassPayoutWalletId"];
-                    id: components["parameters"]["MassPayoutId"];
-                };
+                path?: never;
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Batch canceled */
+                /** @description Number of notifications actually transitioned to read. */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5460,19 +6300,14 @@ export interface paths {
                         "application/json": {
                             /** @example true */
                             success?: boolean;
-                            data?: components["schemas"]["MassPayout"];
+                            data?: {
+                                /** @example 5 */
+                                updated?: number;
+                            };
                         };
                     };
                 };
-                /** @description Batch can no longer be canceled */
-                409: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
+                401: components["responses"]["UnauthorizedError"];
             };
         };
         delete?: never;
@@ -5481,54 +6316,60 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/frontend/mass-payouts/{wallet_id}/{id}/report.csv": {
+    "/frontend/notifications/realtime-token": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
+        get?: never;
+        put?: 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.
+         * Issue a realtime subscription token
+         * @description Subscribe-only token for the realtime SDK (`authCallback`). `channels`
+         *     lists the exact channel names the token grants — the personal channel
+         *     plus one per accessible wallet. Tokens expire after ~1 hour; the SDK
+         *     re-requests through the same endpoint.
          *
          */
-        get: {
+        post: {
             parameters: {
                 query?: never;
                 header?: never;
-                path: {
-                    /** @description Source wallet the batches belong to */
-                    wallet_id: components["parameters"]["MassPayoutWalletId"];
-                    id: components["parameters"]["MassPayoutId"];
-                };
+                path?: never;
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description CSV file */
+                /** @description Token, expiry and the granted channel names. */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/csv": string;
+                        "application/json": {
+                            /** @example true */
+                            success?: boolean;
+                            data?: {
+                                token?: string;
+                                /** Format: date-time */
+                                expires_at?: string;
+                                channels?: string[];
+                            };
+                        };
                     };
                 };
-                /** @description Mass payout not found */
-                404: {
+                401: components["responses"]["UnauthorizedError"];
+                /** @description Realtime delivery is disabled for this deployment (`REALTIME_DISABLED`). */
+                503: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
+                    content?: never;
                 };
             };
         };
-        put?: never;
-        post?: never;
         delete?: never;
         options?: never;
         head?: never;
@@ -10843,6 +11684,65 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/frontend/notifications/test": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Send mock notification events (development only)
+         * @description Publishes MOCK events straight to the delivery channels so a client can verify its realtime integration: `notification.created` plus a push carrier on the personal channel, and `data.changed` on the wallet channel when `wallet_id` is passed. Nothing is stored — the mock does not appear in the inbox. Available only on development deployments.
+         */
+        post: {
+            parameters: {
+                query?: {
+                    /** @description Accessible wallet whose channel receives the mock `data.changed` signal */
+                    wallet_id?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        /** @description Push notification text */
+                        message?: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Mock events published */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success?: boolean;
+                            data?: {
+                                /** Format: uuid */
+                                notification_id?: string;
+                                /** Format: uuid */
+                                signaled_wallet_id?: string | null;
+                            };
+                        };
+                    };
+                };
+                401: components["responses"]["UnauthorizedError"];
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -11146,6 +12046,14 @@ export interface components {
             /** @enum {string|null} */
             form_factor?: "PHYSICAL" | "VIRTUAL" | null;
             tokenizable: boolean;
+            /** @description What a cardholder on this program must carry. Set per program in the vendor config, so it can change without a release — read it instead of hardcoding the form. */
+            cardholder_requirements?: {
+                /** @enum {string} */
+                level?: "minimal" | "basic" | "full";
+                /** @description Required field names; address fields are dotted (address.line1) */
+                required?: string[];
+                required_documents?: ("gov_id_front" | "gov_id_back" | "selfie")[];
+            };
             /** Format: uuid */
             account_currency: string;
             card_limit: number;
@@ -11297,8 +12205,6 @@ export interface components {
             currency: components["schemas"]["CurrencyRef"];
             /** @description Program embed; null when program_id is null */
             issuing_program?: components["schemas"]["IssuingProgram"] | null;
-            /** @description Bank details persisted on fiat_accounts; null when absent */
-            bank_account_details?: components["schemas"]["BankAccountDetails"] | null;
             /** @description Bank details from the external API meta; empty string `""` when none are available. */
             account_details: components["schemas"]["BankAccountDetails"] | "";
             /** Format: date-time */
@@ -11345,7 +12251,7 @@ export interface components {
             /** Format: date-time */
             updated_at?: string;
         };
-        /** @description Card / sub-account transaction (GET /cards/{card_id}/transactions and GET /sub-accounts/{sub_account_id}/transactions). Fields pass through from the issuing vendor. */
+        /** @description Card / sub-account transaction (GET /cards/{card_id}/transactions and GET /sub-accounts/{sub_account_id}/transactions). */
         IssuingTransaction: {
             /** @description Transaction id in the issuing vendor */
             vendor_transaction_id?: string;
@@ -11353,7 +12259,7 @@ export interface components {
             last4?: string;
             /** @example APPROVED */
             status?: string;
-            /** @example PURCHASE */
+            /** @example CLEARING */
             transaction_type?: string;
             /** @example Purchase */
             group?: string;
@@ -11625,7 +12531,13 @@ export interface components {
              * @description Source wallet UUID
              */
             wallet_id: string;
+            /** @description Amount to send, in `from_currency_id` units. With `is_reverse: true` — the amount the recipient must receive, in destination-currency units. */
             amount: number;
+            /**
+             * @description When true, `amount` is the receive-amount and the debited amount is grossed up with fees.
+             * @default false
+             */
+            is_reverse: boolean;
             /** Format: uuid */
             from_currency_id: string;
             /** Format: uuid */
@@ -11650,7 +12562,13 @@ export interface components {
              * @description Source wallet UUID
              */
             wallet_id: string;
+            /** @description Amount to send, in `from_currency_id` units. With `is_reverse: true` — the amount the recipient must receive, in destination-currency units. */
             amount: number;
+            /**
+             * @description When true, `amount` is the receive-amount and the debited amount is grossed up with fees.
+             * @default false
+             */
+            is_reverse: boolean;
             /** Format: uuid */
             from_currency_id: string;
             /** Format: uuid */
@@ -11672,8 +12590,13 @@ export interface components {
         FrontendExchangeOrderRequest: {
             /** Format: uuid */
             wallet_id: string;
-            /** @description Amount to exchange (in source currency) */
+            /** @description Amount to exchange, in `from_currency_id` units. With `is_reverse: true` — the amount to receive, in `to_currency_id` units. */
             amount: number;
+            /**
+             * @description When true, `amount` is the receive-amount and the debited amount is grossed up with fees.
+             * @default false
+             */
+            is_reverse: boolean;
             /**
              * Format: uuid
              * @description Source currency UUID
@@ -11856,6 +12779,25 @@ export interface components {
             destination_id: string;
             amount: number;
         };
+        NotificationView: {
+            /** Format: uuid */
+            id: string;
+            /** @enum {string} */
+            type: "DEPOSIT_RECEIVED" | "TRANSFER_RECEIVED" | "ORDER_STATUS_CHANGED" | "KYC_STATUS_CHANGED";
+            /** @description Structured fact snapshot; the client renders the presentation. Shape depends on `type`; evolution is additive-only. */
+            payload: Record<string, never>;
+            /** Format: uuid */
+            wallet_id: string | null;
+            /** Format: date-time */
+            read_at: string | null;
+            /** Format: date-time */
+            created_at: string;
+        };
+        NotificationPreference: {
+            /** @enum {string} */
+            channel: "IN_APP" | "PUSH";
+            enabled: boolean;
+        };
     };
     responses: {
         /** @description Authentication credentials are missing or invalid */