@kasuvia/sdk 0.0.8 → 0.0.9

package/src/generated/payment-openapi.ts

@@ -0,0 +1,2713 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+
+export interface paths {
+    "/api/v1/banks": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List supported banks for payouts, filtered by country/currency's active gateway */
+        get: operations["list-banks"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/config/currency-by-country": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Look up the default currency for a country code (public) */
+        get: operations["get-currency-by-country"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/config/supported-currencies": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List supported currencies for the platform (public) */
+        get: operations["get-supported-currencies"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/config/supported-languages": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List supported languages for the platform (public) */
+        get: operations["get-supported-languages"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/discounts/available": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List available discounts for plans (public) */
+        get: operations["list-available-discounts"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/discounts/validate": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Validate a discount code and compute the final price (public) */
+        post: operations["validate-discount"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/events/stream": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** SSE stream of events scoped to the authenticated business (or a dev keepalive-only stream if unauthenticated) */
+        get: operations["stream-business-events"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/events/stream/order/{order_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Public SSE stream for a single order's payment events (storefront checkout) */
+        get: operations["stream-order-events"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/payment-methods": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List all payment methods for the authenticated business owner */
+        get: operations["list-payment-methods"];
+        put?: never;
+        /** Add a new payment method (card) using a Flutterwave authorization code */
+        post: operations["create-payment-method"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/payment-methods/tokenize": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Tokenize a card via Flutterwave hosted checkout for secure storage */
+        post: operations["tokenize-card"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/payment-methods/verify": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Verify a completed tokenize-card charge and save the resulting card */
+        post: operations["verify-and-add-payment-method"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/payment-methods/{payment_method_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /** Delete (deactivate) a payment method */
+        delete: operations["delete-payment-method"];
+        options?: never;
+        head?: never;
+        /** Update a payment method (set as default, activate/deactivate) */
+        patch: operations["update-payment-method"];
+        trace?: never;
+    };
+    "/api/v1/payment-methods/{payment_method_id}/set-default": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Set a payment method as the default for future charges */
+        post: operations["set-default-payment-method"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/payments/channel/dedicated-account": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Channel-integration (WhatsApp/bot): create a Monnify DVA server-to-server */
+        post: operations["channel-create-dedicated-account"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/payments/channel/initiate": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Channel-integration (WhatsApp/bot): initiate a hosted-checkout payment server-to-server */
+        post: operations["channel-initiate-payment"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/payments/channel/methods": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Channel-integration: which payment gateways (and each gateway's checkout methods) are available for a business's region */
+        get: operations["channel-available-payment-methods"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/payments/initiate": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Initiate a payment via the country-code-routed gateway (business owner/dashboard use) */
+        post: operations["initiate-payment"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/payments/kasuvia-pay": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Create a KasuviaPay hosted payment link */
+        post: operations["create-payment-link"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/payments/kasuvia-pay/{link_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get an active KasuviaPay payment link by ID (public) */
+        get: operations["get-payment-link"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/payments/redirect/{gateway_ref}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Redirect to the originating chat_url after payment, if one was recorded */
+        get: operations["redirect-to-source"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/payments/storefront/dedicated-account": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Storefront: create a Monnify Dedicated Virtual Account for bank-transfer checkout */
+        post: operations["storefront-create-dedicated-account"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/payments/storefront/initiate": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Storefront: initiate a card/hosted-checkout payment via the country-code-routed gateway */
+        post: operations["storefront-initiate-payment"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/payments/storefront/methods": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Storefront: which payment gateways (and each gateway's checkout methods) are available for this business's region */
+        get: operations["storefront-available-payment-methods"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/payments/transactions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List transactions for the authenticated business (paginated) */
+        get: operations["list-transactions"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/payments/transactions/summary": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Business-wide transaction totals (for the dashboard stat tiles, computed in SQL) */
+        get: operations["get-transactions-summary"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/payments/verify/{gateway_ref}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Verify payment completion — called by gateway webhooks or frontend polling */
+        post: operations["verify-payment"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/quote": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Issue a rate-locked FX conversion quote valid for 15 minutes */
+        post: operations["create-conversion-quote"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/refunds": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List refunds for the authenticated business owner (paginated) */
+        get: operations["list-business-refunds"];
+        put?: never;
+        /** Request a refund for a transaction (business owner only) */
+        post: operations["request-refund"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/refunds/{refund_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get a single refund if it belongs to the authenticated business owner */
+        get: operations["get-refund"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        "Add-bank-accountRequest": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Add-bank-accountRequest.json
+             */
+            readonly $schema?: string;
+            account_name: string;
+            account_number: string;
+            bank_code: string;
+        };
+        BankAccountResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/BankAccountResponse.json
+             */
+            readonly $schema?: string;
+            account_name: string;
+            account_number: string;
+            bank_code: string;
+            bank_name: string;
+            business_id: string;
+            created_at: string;
+            gateway_meta: {
+                [key: string]: unknown;
+            };
+            id: string;
+            is_active: boolean;
+            is_verified: boolean;
+            provider_recipient_codes: {
+                [key: string]: unknown;
+            };
+            updated_at: string;
+        };
+        BankResponse: {
+            code: string;
+            country: string | null;
+            gateway_code: string;
+            name: string;
+        };
+        BillingInvoiceRow: {
+            amount: string;
+            currency: string;
+            download_url: string | null;
+            gateway_ref: string | null;
+            id: string;
+            paid_at: string | null;
+            period_end: string | null;
+            period_start: string | null;
+            plan_name: string;
+            status: string;
+        };
+        BillingSummaryResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/BillingSummaryResponse.json
+             */
+            readonly $schema?: string;
+            invoices: components["schemas"]["BillingInvoiceRow"][] | null;
+            subscription: components["schemas"]["BillingSummarySubscription"];
+            usage: components["schemas"]["BillingUsageRow"][] | null;
+        };
+        BillingSummarySubscription: {
+            /** Format: double */
+            basePrice: number;
+            cancel_at_period_end: boolean;
+            card_last4: string | null;
+            card_type: string | null;
+            currentPeriodEnd: string | null;
+            current_period_start: string | null;
+            /** Format: double */
+            discountValue: number;
+            id: string | null;
+            interval: string;
+            isPayAsYouGo: boolean;
+            pending_effective_date: string | null;
+            pending_plan_interval: string | null;
+            pending_plan_tier: string | null;
+            planId: string;
+            /** Format: double */
+            pricePaid: number;
+            renewalType: string;
+            status: string;
+        };
+        BillingUsageRow: {
+            id: string;
+            limit: unknown;
+            name: string;
+            unit: string;
+            /** Format: int64 */
+            used: number;
+        };
+        "Cancel-scheduled-changeResponse": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Cancel-scheduled-changeResponse.json
+             */
+            readonly $schema?: string;
+            message: string;
+            status: string;
+        };
+        "Cancel-subscriptionRequest": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Cancel-subscriptionRequest.json
+             */
+            readonly $schema?: string;
+            reason: string;
+        };
+        CancelSubscriptionResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/CancelSubscriptionResponse.json
+             */
+            readonly $schema?: string;
+            access_until: string | null;
+            cancel_at_period_end: boolean;
+            message: string;
+            status: string;
+        };
+        "Charge-subscriptionRequest": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Charge-subscriptionRequest.json
+             */
+            readonly $schema?: string;
+            authorization_code?: string;
+            currency?: string;
+            discount_code?: string;
+            /** @default month */
+            interval: string;
+            plan_slug: string;
+            reference?: string;
+        };
+        "Claim-wallet-creditRequest": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Claim-wallet-creditRequest.json
+             */
+            readonly $schema?: string;
+            claim_token: string;
+        };
+        "Create-conversion-quoteRequest": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Create-conversion-quoteRequest.json
+             */
+            readonly $schema?: string;
+            amount: string;
+        };
+        "Create-payment-linkRequest": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Create-payment-linkRequest.json
+             */
+            readonly $schema?: string;
+            /** Format: double */
+            amount: number;
+            currency: string;
+            expires_at?: string;
+            is_active?: boolean;
+            title: string;
+        };
+        "Create-payment-methodRequest": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Create-payment-methodRequest.json
+             */
+            readonly $schema?: string;
+            authorization_code: string;
+            card_expiry?: string;
+            card_holder_name?: string;
+            card_last4: string;
+            card_type: string;
+            set_as_default: boolean;
+        };
+        CurrencyResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/CurrencyResponse.json
+             */
+            readonly $schema?: string;
+            code: string;
+            country_codes?: unknown[] | null;
+            /** Format: int64 */
+            decimal_digits: number;
+            name: string;
+            /** Format: int64 */
+            rounding: number;
+            symbol: string;
+        };
+        DVAResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/DVAResponse.json
+             */
+            readonly $schema?: string;
+            account_name: string;
+            account_number: string;
+            amount: string;
+            bank_name: string;
+            expires_at: string;
+            reference: string;
+            transaction_id: string;
+        };
+        "Delete-bank-accountRequest": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Delete-bank-accountRequest.json
+             */
+            readonly $schema?: string;
+            deletion_reason?: string;
+        };
+        DiscountResponse: {
+            code: string;
+            /** Format: date-time */
+            created_at: string;
+            description: string | null;
+            id: string;
+            interval: string | null;
+            is_active: boolean;
+            /** Format: int64 */
+            max_uses: number | null;
+            target_plan_id: string | null;
+            target_plan_slug: string | null;
+            type: string;
+            /** Format: date-time */
+            updated_at: string;
+            /** Format: int64 */
+            uses_count: number;
+            /** Format: date-time */
+            valid_from: string | null;
+            /** Format: date-time */
+            valid_until: string | null;
+            value: string;
+        };
+        DiscountValidateResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/DiscountValidateResponse.json
+             */
+            readonly $schema?: string;
+            discount?: components["schemas"]["DiscountResponse"];
+            /** Format: double */
+            final_price?: number;
+            interval?: string;
+            reason?: string;
+            valid: boolean;
+        };
+        DvaCreateBody: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/DvaCreateBody.json
+             */
+            readonly $schema?: string;
+            /** Format: double */
+            amount?: number;
+            /** @default NGN */
+            currency: string;
+            customer_email?: string;
+            customer_name?: string;
+            /**
+             * @description Must be 'monnify' — the only gateway that supports bank_transfer.
+             * @enum {string}
+             */
+            gateway: "monnify";
+            idempotency_key?: string;
+            order_id?: string;
+        };
+        EnvelopeOutstandingClaimResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/EnvelopeOutstandingClaimResponse.json
+             */
+            readonly $schema?: string;
+            /** Format: int64 */
+            count: number;
+            /** Format: int64 */
+            page: number;
+            /** Format: int64 */
+            page_size: number;
+            results: components["schemas"]["OutstandingClaimResponse"][] | null;
+            /** Format: int64 */
+            total_pages: number;
+        };
+        EnvelopePayoutResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/EnvelopePayoutResponse.json
+             */
+            readonly $schema?: string;
+            /** Format: int64 */
+            count: number;
+            /** Format: int64 */
+            page: number;
+            /** Format: int64 */
+            page_size: number;
+            results: components["schemas"]["PayoutResponse"][] | null;
+            /** Format: int64 */
+            total_pages: number;
+        };
+        EnvelopeRefundResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/EnvelopeRefundResponse.json
+             */
+            readonly $schema?: string;
+            /** Format: int64 */
+            count: number;
+            /** Format: int64 */
+            page: number;
+            /** Format: int64 */
+            page_size: number;
+            results: components["schemas"]["RefundResponse"][] | null;
+            /** Format: int64 */
+            total_pages: number;
+        };
+        EnvelopeRefundResponseAdmin: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/EnvelopeRefundResponseAdmin.json
+             */
+            readonly $schema?: string;
+            /** Format: int64 */
+            count: number;
+            /** Format: int64 */
+            page: number;
+            /** Format: int64 */
+            page_size: number;
+            results: components["schemas"]["RefundResponseAdmin"][] | null;
+            /** Format: int64 */
+            total_pages: number;
+        };
+        EnvelopeTransactionResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/EnvelopeTransactionResponse.json
+             */
+            readonly $schema?: string;
+            /** Format: int64 */
+            count: number;
+            /** Format: int64 */
+            page: number;
+            /** Format: int64 */
+            page_size: number;
+            results: components["schemas"]["TransactionResponse"][] | null;
+            /** Format: int64 */
+            total_pages: number;
+        };
+        EnvelopeWalletLedgerEntryResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/EnvelopeWalletLedgerEntryResponse.json
+             */
+            readonly $schema?: string;
+            /** Format: int64 */
+            count: number;
+            /** Format: int64 */
+            page: number;
+            /** Format: int64 */
+            page_size: number;
+            results: components["schemas"]["WalletLedgerEntryResponse"][] | null;
+            /** Format: int64 */
+            total_pages: number;
+        };
+        ErrorDetail: {
+            /** @description Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' */
+            location?: string;
+            /** @description Error message text */
+            message?: string;
+            /** @description The value at the given location */
+            value?: unknown;
+        };
+        ErrorModel: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/ErrorModel.json
+             */
+            readonly $schema?: string;
+            /**
+             * @description A human-readable explanation specific to this occurrence of the problem.
+             * @example Property foo is required but is missing.
+             */
+            detail?: string;
+            /** @description Optional list of individual error details */
+            errors?: components["schemas"]["ErrorDetail"][] | null;
+            /**
+             * Format: uri
+             * @description A URI reference that identifies the specific occurrence of the problem.
+             * @example https://example.com/error-log/abc123
+             */
+            instance?: string;
+            /**
+             * Format: int64
+             * @description HTTP status code
+             * @example 400
+             */
+            status?: number;
+            /**
+             * @description A short, human-readable summary of the problem type. This value should not change between occurrences of the error.
+             * @example Bad Request
+             */
+            title?: string;
+            /**
+             * Format: uri
+             * @description A URI reference to human-readable documentation for the error.
+             * @default about:blank
+             * @example https://example.com/errors/example
+             */
+            type: string;
+        };
+        ExchangeRatesResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/ExchangeRatesResponse.json
+             */
+            readonly $schema?: string;
+            base: string;
+            rates: {
+                [key: string]: number;
+            };
+            /** Format: date-time */
+            updated_at: string;
+        };
+        GatewayMethods: {
+            display_name: string;
+            gateway: string;
+            methods: components["schemas"]["PaymentMethodOption"][] | null;
+        };
+        "Get-payout-balanceResponse": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Get-payout-balanceResponse.json
+             */
+            readonly $schema?: string;
+            available: string;
+            currency: string;
+            held: string;
+            pending: string;
+        };
+        "Get-transactions-summaryResponse": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Get-transactions-summaryResponse.json
+             */
+            readonly $schema?: string;
+            total_escrow_held: string;
+            total_fees: string;
+            total_received: string;
+            total_refunded: string;
+        };
+        "Initiate-card-updateResponse": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Initiate-card-updateResponse.json
+             */
+            readonly $schema?: string;
+            authorization_url: string;
+            reference: string;
+        };
+        "Initiate-paymentRequest": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Initiate-paymentRequest.json
+             */
+            readonly $schema?: string;
+            /** Format: double */
+            amount?: number;
+            chat_url?: string;
+            consultation_id?: string;
+            /** @default NG */
+            country_code: string;
+            currency?: string;
+            customer_id?: string;
+            idempotency_key?: string;
+            metadata_json?: {
+                [key: string]: unknown;
+            };
+            order_id?: string;
+            platform_source?: string;
+        };
+        "Initiate-subscriptionRequest": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Initiate-subscriptionRequest.json
+             */
+            readonly $schema?: string;
+            currency?: string;
+            discount_code?: string;
+            /** @default month */
+            interval: string;
+            plan_slug: string;
+        };
+        InitiateSubscriptionResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/InitiateSubscriptionResponse.json
+             */
+            readonly $schema?: string;
+            authorization_url: string | null;
+            /** Format: double */
+            base_price: number;
+            /** Format: double */
+            discount_value: number;
+            /** Format: double */
+            final_price: number;
+            gateway: string;
+            interval: string;
+            message?: string;
+            plan_slug: string;
+            reference: string;
+            status?: string;
+        };
+        JobStatusResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/JobStatusResponse.json
+             */
+            readonly $schema?: string;
+            completed_at: string | null;
+            created_at: string;
+            error: string | null;
+            job_id: string;
+            status: string;
+            subscription_id: string | null;
+        };
+        LanguageResponse: {
+            code: string;
+            flag: string;
+            label: string;
+        };
+        OutstandingClaimResponse: {
+            balance: string;
+            claim_email: string;
+            created_at: string;
+            currency: string;
+            wallet_id: string;
+        };
+        PaymentLinkResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/PaymentLinkResponse.json
+             */
+            readonly $schema?: string;
+            amount: string;
+            business_id: string;
+            created_at: string;
+            currency: string;
+            expires_at: string | null;
+            id: string;
+            is_active: boolean;
+            title: string;
+        };
+        PaymentMethodOption: {
+            description: string;
+            display_name: string;
+            method: string;
+        };
+        PaymentMethodResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/PaymentMethodResponse.json
+             */
+            readonly $schema?: string;
+            card_expiry: string | null;
+            card_holder_name: string | null;
+            card_last4: string;
+            card_type: string;
+            created_at: string;
+            id: string;
+            is_active: boolean;
+            is_default: boolean;
+            provider: string;
+            updated_at: string;
+            user_id: string;
+        };
+        PayoutResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/PayoutResponse.json
+             */
+            readonly $schema?: string;
+            amount: string;
+            business_id: string;
+            carrier_cost: string | null;
+            charged_amount: string | null;
+            charged_currency: string | null;
+            converted_amount: string | null;
+            created_at: string;
+            currency: string;
+            fx_rate_applied: string | null;
+            fx_rate_captured_at: string | null;
+            fx_rate_source: string | null;
+            fx_spread_amount: string | null;
+            gateway_fee: string | null;
+            gateway_ref: string | null;
+            id: string;
+            platform_commission: string | null;
+            reference_fx_rate: string | null;
+            reference_fx_rate_source: string | null;
+            staff_id: string | null;
+            status: string;
+            type: string;
+            updated_at: string;
+        };
+        PlanResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/PlanResponse.json
+             */
+            readonly $schema?: string;
+            created_at: string;
+            description: string | null;
+            display_name: string;
+            features: unknown[] | null;
+            id: string | null;
+            is_deprecated: boolean;
+            is_public: boolean;
+            limits: {
+                [key: string]: unknown;
+            };
+            /** Format: int64 */
+            ordering: number;
+            permissions: unknown[] | null;
+            pricing: {
+                [key: string]: unknown;
+            };
+            slug: string;
+            updated_at: string;
+        };
+        "Process-refund-adminRequest": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Process-refund-adminRequest.json
+             */
+            readonly $schema?: string;
+            amount?: string;
+            approved: boolean;
+            refund_method?: string;
+        };
+        QuoteResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/QuoteResponse.json
+             */
+            readonly $schema?: string;
+            business_id: string;
+            converted_amount: string;
+            /** Format: date-time */
+            created_at: string;
+            /** Format: date-time */
+            expires_at: string;
+            from_currency: string;
+            id: string;
+            is_used: boolean;
+            original_amount: string;
+            rate: string;
+            to_currency: string;
+        };
+        "Redirect-to-sourceResponse": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Redirect-to-sourceResponse.json
+             */
+            readonly $schema?: string;
+            message: string;
+        };
+        RefundResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/RefundResponse.json
+             */
+            readonly $schema?: string;
+            amount: string;
+            business_id: string;
+            created_at: string;
+            currency: string;
+            failure_reason: string | null;
+            gateway_fee_recovered: string | null;
+            id: string;
+            method: string;
+            order_id: string;
+            processed_by: string | null;
+            provider_status: string | null;
+            reason: string | null;
+            requested_by: string;
+            status: string;
+            subscription_id: string | null;
+            transaction_id: string;
+            updated_at: string;
+            wallet_credit_status: string | null;
+        };
+        RefundResponseAdmin: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/RefundResponseAdmin.json
+             */
+            readonly $schema?: string;
+            amount: string;
+            business_id: string;
+            created_at: string;
+            currency: string;
+            failure_reason: string | null;
+            gateway_fee_recovered: string | null;
+            id: string;
+            method: string;
+            order_id: string;
+            processed_by: string | null;
+            provider_ref: string | null;
+            provider_status: string | null;
+            reason: string | null;
+            requested_by: string;
+            status: string;
+            subscription_id: string | null;
+            transaction_id: string;
+            updated_at: string;
+            wallet_credit_status: string | null;
+        };
+        "Release-escrow-manualResponse": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Release-escrow-manualResponse.json
+             */
+            readonly $schema?: string;
+            message: string;
+            transaction_id: string;
+        };
+        "Request-escrow-refundRequest": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Request-escrow-refundRequest.json
+             */
+            readonly $schema?: string;
+            reason: string;
+        };
+        "Request-escrow-refundResponse": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Request-escrow-refundResponse.json
+             */
+            readonly $schema?: string;
+            message: string;
+            status: string;
+            transaction_id: string;
+        };
+        "Request-payoutRequest": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Request-payoutRequest.json
+             */
+            readonly $schema?: string;
+            /** Format: double */
+            amount: number;
+            country_code: string;
+            currency: string;
+            staff_id?: string;
+            type: string;
+        };
+        "Request-refundRequest": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Request-refundRequest.json
+             */
+            readonly $schema?: string;
+            reason: string;
+            transaction_id: string;
+        };
+        "Schedule-plan-changeRequest": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Schedule-plan-changeRequest.json
+             */
+            readonly $schema?: string;
+            /** @default month */
+            interval: string;
+            target_plan_slug: string;
+        };
+        ScheduleChangeResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/ScheduleChangeResponse.json
+             */
+            readonly $schema?: string;
+            change_type: string;
+            effective_date: string | null;
+            message: string;
+            pending_plan_interval: string;
+            pending_plan_tier: string;
+            status: string;
+        };
+        SseErrorMessage: {
+            error: string;
+            message: string;
+        };
+        StartTrialRequestBody: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/StartTrialRequestBody.json
+             */
+            readonly $schema?: string;
+            /** @description Plan tier for trial (e.g., 'growth', 'business'). If empty, uses platform default. */
+            trial_plan_tier: string;
+        };
+        StorefrontInitiateBody: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/StorefrontInitiateBody.json
+             */
+            readonly $schema?: string;
+            /** Format: double */
+            amount?: number;
+            /** @default NG */
+            country_code: string;
+            currency?: string;
+            /**
+             * @description Which gateway the customer chose from GET /payments/storefront/methods.
+             * @enum {string}
+             */
+            gateway: "monnify" | "flutterwave";
+            idempotency_key?: string;
+            metadata_json?: {
+                [key: string]: unknown;
+            };
+            order_id?: string;
+        };
+        SubscriptionFullResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/SubscriptionFullResponse.json
+             */
+            readonly $schema?: string;
+            auto_renewal: boolean;
+            base_price: string;
+            cancel_reason: string | null;
+            card_last4: string | null;
+            card_type: string | null;
+            created_at: string;
+            current_period_end: string | null;
+            current_period_start: string | null;
+            customer_code: string | null;
+            discount_id: string | null;
+            discount_value: string;
+            grace_period_end: string | null;
+            id: string;
+            interval: string;
+            is_trial: boolean;
+            /** Format: int64 */
+            payment_failure_count: number;
+            plan_code: string | null;
+            plan_tier: string;
+            price_paid: string;
+            provider: string;
+            provider_ref: string | null;
+            renewal_type: string;
+            status: string;
+            subscription_code: string | null;
+            trial_end: string | null;
+            trial_plan_tier: string | null;
+            trial_start: string | null;
+            updated_at: string;
+            user_id: string;
+            voided_at: string | null;
+        };
+        SubscriptionSettingsResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/SubscriptionSettingsResponse.json
+             */
+            readonly $schema?: string;
+            business_id: string;
+            created_at: string;
+            current_period_end: string | null;
+            id: string;
+            plan_tier: string;
+            provider: string;
+            provider_ref: string | null;
+            status: string;
+            updated_at: string;
+        };
+        SupportedCurrenciesResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/SupportedCurrenciesResponse.json
+             */
+            readonly $schema?: string;
+            currencies: components["schemas"]["CurrencyResponse"][] | null;
+            default_currency: string;
+        };
+        SupportedLanguagesResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/SupportedLanguagesResponse.json
+             */
+            readonly $schema?: string;
+            default_language: string;
+            languages: components["schemas"]["LanguageResponse"][] | null;
+        };
+        "Tokenize-cardRequest": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Tokenize-cardRequest.json
+             */
+            readonly $schema?: string;
+            /**
+             * Format: double
+             * @default 100
+             */
+            amount: number;
+            card_holder_name: string;
+            email: string;
+            phone?: string;
+        };
+        TokenizeCardResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/TokenizeCardResponse.json
+             */
+            readonly $schema?: string;
+            authorization_url: string;
+            tx_ref: string;
+        };
+        TransactionResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/TransactionResponse.json
+             */
+            readonly $schema?: string;
+            amount: string;
+            business_id: string;
+            chat_url: string | null;
+            consultation_id: string | null;
+            created_at: string;
+            currency: string;
+            customer_id: string | null;
+            gateway: string;
+            gateway_ref: string;
+            id: string;
+            idempotency_key: string | null;
+            metadata_json: {
+                [key: string]: unknown;
+            };
+            order_id: string | null;
+            platform_source: string | null;
+            status: string;
+            updated_at: string;
+        };
+        TrialStatusResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/TrialStatusResponse.json
+             */
+            readonly $schema?: string;
+            is_trial: boolean;
+            trial_active: boolean;
+            /** Format: int64 */
+            trial_days_remaining: number;
+            trial_end?: string;
+            trial_expired: boolean;
+            trial_plan_tier?: string;
+            trial_start?: string;
+        };
+        "Update-payment-methodRequest": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Update-payment-methodRequest.json
+             */
+            readonly $schema?: string;
+            is_active?: boolean;
+            set_as_default?: boolean;
+        };
+        "Update-subscription-cardRequest": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Update-subscription-cardRequest.json
+             */
+            readonly $schema?: string;
+            authorization_code?: string;
+            card_last4?: string;
+            card_type?: string;
+            reference: string;
+        };
+        "Validate-discountRequest": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Validate-discountRequest.json
+             */
+            readonly $schema?: string;
+            code: string;
+            currency: string;
+            interval: string;
+            plan_slug: string;
+        };
+        "Verify-and-add-payment-methodRequest": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Verify-and-add-payment-methodRequest.json
+             */
+            readonly $schema?: string;
+            reference: string;
+            set_as_default: boolean;
+        };
+        "Verify-bank-accountRequest": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Verify-bank-accountRequest.json
+             */
+            readonly $schema?: string;
+            account_name: string;
+            account_number: string;
+            bank_code: string;
+        };
+        "Verify-bank-accountResponse": {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/Verify-bank-accountResponse.json
+             */
+            readonly $schema?: string;
+            message: string;
+            verified: boolean;
+            verified_name: string;
+        };
+        WalletBalanceResponse: {
+            /**
+             * Format: uri
+             * @description A URL to the JSON Schema for this object.
+             * @example https://example.com/schemas/WalletBalanceResponse.json
+             */
+            readonly $schema?: string;
+            balance: string;
+            currency: string;
+        };
+        WalletLedgerEntryResponse: {
+            amount: string;
+            balance_after: string;
+            created_at: string;
+            currency: string;
+            entry_type: string;
+            id: string;
+            refund_id: string | null;
+            transaction_id: string | null;
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    "list-banks": {
+        parameters: {
+            query?: {
+                /** @description Country ISO code (e.g. NG, GH, KE) */
+                country?: string;
+                /** @description Currency code (e.g. NGN, GHS, KES) */
+                currency?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["BankResponse"][] | null;
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "get-currency-by-country": {
+        parameters: {
+            query?: {
+                country_code?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CurrencyResponse"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "get-supported-currencies": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SupportedCurrenciesResponse"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "get-supported-languages": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SupportedLanguagesResponse"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "list-available-discounts": {
+        parameters: {
+            query?: {
+                plan_slug?: string;
+                interval?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DiscountResponse"][] | null;
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "validate-discount": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["Validate-discountRequest"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DiscountValidateResponse"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "stream-business-events": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/event-stream": ({
+                        data: components["schemas"]["SseErrorMessage"];
+                        /**
+                         * @description The event name.
+                         * @constant
+                         */
+                        event: "error";
+                        /** @description The event ID. */
+                        id?: number;
+                        /** @description The retry time in milliseconds. */
+                        retry?: number;
+                    } | {
+                        data: {
+                            [key: string]: unknown;
+                        };
+                        /**
+                         * @description The event name.
+                         * @constant
+                         */
+                        event?: "message";
+                        /** @description The event ID. */
+                        id?: number;
+                        /** @description The retry time in milliseconds. */
+                        retry?: number;
+                    })[];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "stream-order-events": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                order_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/event-stream": ({
+                        data: components["schemas"]["SseErrorMessage"];
+                        /**
+                         * @description The event name.
+                         * @constant
+                         */
+                        event: "error";
+                        /** @description The event ID. */
+                        id?: number;
+                        /** @description The retry time in milliseconds. */
+                        retry?: number;
+                    } | {
+                        data: {
+                            [key: string]: unknown;
+                        };
+                        /**
+                         * @description The event name.
+                         * @constant
+                         */
+                        event?: "message";
+                        /** @description The event ID. */
+                        id?: number;
+                        /** @description The retry time in milliseconds. */
+                        retry?: number;
+                    })[];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "list-payment-methods": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PaymentMethodResponse"][] | null;
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "create-payment-method": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["Create-payment-methodRequest"];
+            };
+        };
+        responses: {
+            /** @description Created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PaymentMethodResponse"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "tokenize-card": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["Tokenize-cardRequest"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TokenizeCardResponse"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "verify-and-add-payment-method": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["Verify-and-add-payment-methodRequest"];
+            };
+        };
+        responses: {
+            /** @description Created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PaymentMethodResponse"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "delete-payment-method": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                payment_method_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description No Content */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "update-payment-method": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                payment_method_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["Update-payment-methodRequest"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PaymentMethodResponse"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "set-default-payment-method": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                payment_method_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PaymentMethodResponse"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "channel-create-dedicated-account": {
+        parameters: {
+            query?: {
+                business_id?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DvaCreateBody"];
+            };
+        };
+        responses: {
+            /** @description Created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DVAResponse"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "channel-initiate-payment": {
+        parameters: {
+            query?: {
+                business_id?: string;
+            };
+            header?: {
+                Origin?: string;
+                Referer?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["StorefrontInitiateBody"];
+            };
+        };
+        responses: {
+            /** @description Created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TransactionResponse"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "channel-available-payment-methods": {
+        parameters: {
+            query?: {
+                business_id?: string;
+                currency?: string;
+                country_code?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GatewayMethods"][] | null;
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "initiate-payment": {
+        parameters: {
+            query?: never;
+            header?: {
+                Origin?: string;
+                Referer?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["Initiate-paymentRequest"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TransactionResponse"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "create-payment-link": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["Create-payment-linkRequest"];
+            };
+        };
+        responses: {
+            /** @description Created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PaymentLinkResponse"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "get-payment-link": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                link_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PaymentLinkResponse"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "redirect-to-source": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                gateway_ref: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    Location?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Redirect-to-sourceResponse"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "storefront-create-dedicated-account": {
+        parameters: {
+            query?: never;
+            header?: {
+                Origin?: string;
+                Referer?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DvaCreateBody"];
+            };
+        };
+        responses: {
+            /** @description Created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DVAResponse"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "storefront-initiate-payment": {
+        parameters: {
+            query?: never;
+            header?: {
+                Origin?: string;
+                Referer?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["StorefrontInitiateBody"];
+            };
+        };
+        responses: {
+            /** @description Created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TransactionResponse"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "storefront-available-payment-methods": {
+        parameters: {
+            query?: {
+                currency?: string;
+                country_code?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GatewayMethods"][] | null;
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "list-transactions": {
+        parameters: {
+            query?: {
+                /** @description 1-indexed page number */
+                page?: number;
+                /** @description Rows per page (1-100) */
+                page_size?: number;
+                /** @description Filter by transaction status */
+                status?: string;
+                /** @description Filter by gateway */
+                gateway?: string;
+                /** @description Match on gateway_ref or metadata */
+                search?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["EnvelopeTransactionResponse"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "get-transactions-summary": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Get-transactions-summaryResponse"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "verify-payment": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                gateway_ref: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TransactionResponse"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "create-conversion-quote": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["Create-conversion-quoteRequest"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["QuoteResponse"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "list-business-refunds": {
+        parameters: {
+            query?: {
+                /** @description 1-indexed page number */
+                page?: number;
+                /** @description Rows per page (1-100) */
+                page_size?: number;
+                /** @description Filter by refund status */
+                status?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["EnvelopeRefundResponse"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "request-refund": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["Request-refundRequest"];
+            };
+        };
+        responses: {
+            /** @description Created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RefundResponse"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+    "get-refund": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                refund_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RefundResponse"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
+}