@ar-agents/mercadopago 0.15.2 → 0.16.0

package/dist/types-BaOjfcOt.d.ts

@@ -0,0 +1,1085 @@
+import { z } from 'zod';
+
+/**
+ * Site IDs supported by Mercado Pago. The lib targets MLA (Argentina) primarily;
+ * other LATAM sites may work for the read paths but the full Subscriptions flow
+ * is only verified against MLA.
+ */
+declare const SiteIdSchema: z.ZodEnum<{
+    MLA: "MLA";
+    MLB: "MLB";
+    MLM: "MLM";
+    MCO: "MCO";
+    MLC: "MLC";
+    MLU: "MLU";
+}>;
+type SiteId = z.infer<typeof SiteIdSchema>;
+/**
+ * Currency identifiers MP exposes. ARS is the supported case for v0.1.
+ */
+declare const CurrencyIdSchema: z.ZodEnum<{
+    ARS: "ARS";
+    USD: "USD";
+    BRL: "BRL";
+    MXN: "MXN";
+}>;
+type CurrencyId = z.infer<typeof CurrencyIdSchema>;
+/**
+ * Recurrence frequency unit for a subscription's auto_recurring config.
+ */
+declare const FrequencyTypeSchema: z.ZodEnum<{
+    months: "months";
+    days: "days";
+}>;
+type FrequencyType = z.infer<typeof FrequencyTypeSchema>;
+/**
+ * Lifecycle states a Mercado Pago preapproval can be in. The string is the
+ * canonical MP value; we widen to `string` for forward compatibility because
+ * MP has historically introduced new states without notice.
+ */
+declare const PreapprovalStatusSchema: z.ZodUnion<readonly [z.ZodLiteral<"pending">, z.ZodLiteral<"authorized">, z.ZodLiteral<"paused">, z.ZodLiteral<"cancelled">, z.ZodString]>;
+type PreapprovalStatus = z.infer<typeof PreapprovalStatusSchema>;
+declare const AutoRecurringSchema: z.ZodObject<{
+    frequency: z.ZodNumber;
+    frequency_type: z.ZodEnum<{
+        months: "months";
+        days: "days";
+    }>;
+    transaction_amount: z.ZodNumber;
+    currency_id: z.ZodEnum<{
+        ARS: "ARS";
+        USD: "USD";
+        BRL: "BRL";
+        MXN: "MXN";
+    }>;
+    start_date: z.ZodOptional<z.ZodString>;
+    end_date: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type AutoRecurring = z.infer<typeof AutoRecurringSchema>;
+declare const PreapprovalSchema: z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodUnion<readonly [z.ZodLiteral<"pending">, z.ZodLiteral<"authorized">, z.ZodLiteral<"paused">, z.ZodLiteral<"cancelled">, z.ZodString]>;
+    payer_email: z.ZodString;
+    init_point: z.ZodString;
+    external_reference: z.ZodOptional<z.ZodString>;
+    date_created: z.ZodString;
+    last_modified: z.ZodString;
+    next_payment_date: z.ZodOptional<z.ZodString>;
+    payer_id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    auto_recurring: z.ZodObject<{
+        frequency: z.ZodNumber;
+        frequency_type: z.ZodEnum<{
+            months: "months";
+            days: "days";
+        }>;
+        transaction_amount: z.ZodNumber;
+        currency_id: z.ZodEnum<{
+            ARS: "ARS";
+            USD: "USD";
+            BRL: "BRL";
+            MXN: "MXN";
+        }>;
+        start_date: z.ZodOptional<z.ZodString>;
+        end_date: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type Preapproval = z.infer<typeof PreapprovalSchema>;
+/**
+ * Input for creating a preapproval (subscription). Internal field names match
+ * MP API semantics; the public client method maps from camelCase Naza-friendly
+ * params to the snake_case payload MP expects.
+ */
+interface CreatePreapprovalParams {
+    /** Short customer-facing description shown at checkout. */
+    reason: string;
+    /** Email of the buyer. Cannot equal the seller account's email (MP rejects). */
+    payerEmail: string;
+    /** Recurring amount per cycle. */
+    amount: number;
+    /** ARS for Argentina. Other currencies depend on the seller account's site. */
+    currency: CurrencyId;
+    /** Recurrence frequency (e.g., 1 + months = monthly). */
+    frequency: number;
+    frequencyType: FrequencyType;
+    /** HTTPS URL where MP redirects the buyer after first payment. localhost rejected. */
+    backUrl: string;
+    /** Optional client-side identifier for the subscription. */
+    externalReference?: string;
+    /**
+     * Optional explicit idempotency key. If omitted, the client auto-generates
+     * a UUID v4 per call. Pass a deterministic key (e.g., hash of inputs) when
+     * you need cross-retry idempotency from the agent layer.
+     */
+    idempotencyKey?: string;
+}
+/**
+ * The shape of an MP webhook notification body for `topic=preapproval`. MP's
+ * webhook payload varies by event type; this is the union of fields seen in
+ * production.
+ */
+declare const WebhookBodySchema: z.ZodObject<{
+    type: z.ZodOptional<z.ZodString>;
+    topic: z.ZodOptional<z.ZodString>;
+    action: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodObject<{
+        id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    }, z.core.$strip>>;
+    resource: z.ZodOptional<z.ZodString>;
+    user_id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    api_version: z.ZodOptional<z.ZodString>;
+    date_created: z.ZodOptional<z.ZodString>;
+    id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    live_mode: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$loose>;
+type WebhookBody = z.infer<typeof WebhookBodySchema>;
+/**
+ * Normalized webhook event after parsing. The library extracts topic + dataId
+ * from either query params or body, since MP sends them in either location
+ * depending on integration version.
+ */
+interface ParsedWebhookEvent {
+    /** Topic of the event, e.g., "preapproval", "payment", "subscription_authorized_payment". */
+    topic: string;
+    /** ID of the affected resource. */
+    dataId: string;
+    /** Action descriptor when present (e.g., "updated", "created"). */
+    action: string | null;
+    /** Raw body MP sent, for caller inspection / debugging. */
+    raw: WebhookBody;
+}
+/**
+ * Top-level lifecycle status of a payment. MP-canonical values; widened to
+ * string for forward compatibility.
+ */
+declare const PaymentStatusSchema: z.ZodUnion<readonly [z.ZodLiteral<"pending">, z.ZodLiteral<"approved">, z.ZodLiteral<"authorized">, z.ZodLiteral<"in_process">, z.ZodLiteral<"in_mediation">, z.ZodLiteral<"rejected">, z.ZodLiteral<"cancelled">, z.ZodLiteral<"refunded">, z.ZodLiteral<"charged_back">, z.ZodString]>;
+type PaymentStatus = z.infer<typeof PaymentStatusSchema>;
+/**
+ * The full Payment object MP returns. Many fields are optional because they
+ * vary by payment method, status, and integration mode (Checkout Pro vs API).
+ */
+declare const PaymentSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    status: z.ZodUnion<readonly [z.ZodLiteral<"pending">, z.ZodLiteral<"approved">, z.ZodLiteral<"authorized">, z.ZodLiteral<"in_process">, z.ZodLiteral<"in_mediation">, z.ZodLiteral<"rejected">, z.ZodLiteral<"cancelled">, z.ZodLiteral<"refunded">, z.ZodLiteral<"charged_back">, z.ZodString]>;
+    status_detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    date_created: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    date_approved: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    date_last_updated: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    transaction_amount: z.ZodNumber;
+    currency_id: z.ZodString;
+    installments: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    payment_method_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    payment_type_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    external_reference: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    payer: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        identification: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            number: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>>;
+    }, z.core.$loose>>;
+    transaction_details: z.ZodOptional<z.ZodObject<{
+        net_received_amount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        total_paid_amount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        installment_amount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+type Payment = z.infer<typeof PaymentSchema>;
+/** Params for creating a payment (Checkout API / transparent flow). */
+interface CreatePaymentParams {
+    /** Amount in account currency. ARS for Argentina. */
+    transactionAmount: number;
+    /** Number of installments. Use 1 for no cuotas; AR cards typically allow up to 12. */
+    installments?: number;
+    /** MP payment_method_id — `visa`, `master`, `naranja`, `account_money`, etc. */
+    paymentMethodId: string;
+    /** Payer email — REQUIRED. Cannot equal seller email. */
+    payerEmail: string;
+    /** Card token from MP frontend SDK (Cardform). Required for credit/debit; omit for `account_money` etc. */
+    token?: string;
+    /** Description shown in payer's MP statement. */
+    description?: string;
+    /** Your-system identifier for correlation. */
+    externalReference?: string;
+    /** Optional payer identification (DNI/CUIT) — required for some payment types. */
+    identification?: {
+        type: "DNI" | "CUIT" | "CUIL";
+        number: string;
+    };
+    /** Webhook override URL. Falls back to dashboard config if omitted. */
+    notificationUrl?: string;
+    /**
+     * Additional information passed to MP for fraud scoring + receipt details.
+     *
+     * **Critical for fraud scoring**: every field you fill in here improves
+     * MP's risk model's confidence and reduces false-positive rejections.
+     * For card payments above ~$50k ARS, ALWAYS include `payer` + `ip_address`
+     * + `shipments` (when applicable) — payments without enrichment have a
+     * 3-5x higher rejection rate per MP's published guidance (RG 5286/2023).
+     */
+    additionalInfo?: {
+        /** Items in the cart — used for receipt + fraud scoring. */
+        items?: Array<{
+            id?: string;
+            title: string;
+            quantity: number;
+            unit_price: number;
+            description?: string;
+            picture_url?: string;
+            category_id?: string;
+        }>;
+        /**
+         * Buyer profile fields. The more fields populated, the better MP's
+         * risk engine can assess the transaction. `registration_date` is
+         * particularly impactful (newer accounts = higher risk).
+         */
+        payer?: {
+            first_name?: string;
+            last_name?: string;
+            phone?: {
+                area_code?: string;
+                number?: string;
+            };
+            address?: {
+                zip_code?: string;
+                street_name?: string;
+                street_number?: number;
+            };
+            /** ISO 8601 date — when the buyer registered on YOUR platform. */
+            registration_date?: string;
+            /**
+             * Whether the buyer is a returning customer. Strong fraud-scoring
+             * signal — repeat buyers are lower risk.
+             */
+            authentication_type?: "Cellphone" | "Email" | "Facebook" | "Gmail" | "Native app" | string;
+            /** Whether the buyer has set up 2FA on YOUR platform. */
+            is_prime_user?: boolean;
+            /** Whether the buyer has paid you successfully before. */
+            is_first_purchase_online?: boolean;
+            /** ISO 8601 — last successful purchase on your platform. */
+            last_purchase?: string;
+        };
+        /**
+         * Shipping info. Used by fraud engine to compare against payer address.
+         * Mismatch (different city/province) = higher risk score.
+         */
+        shipments?: {
+            receiver_address?: {
+                zip_code?: string;
+                street_name?: string;
+                street_number?: number;
+                floor?: string;
+                apartment?: string;
+                city_name?: string;
+                state_name?: string;
+                country_name?: string;
+            };
+            /** Express shipment flag — fraud engine treats high-value+express as suspicious. */
+            express_shipment?: boolean;
+            /** True if the buyer picks up at a store (no shipment). Reduces fraud risk. */
+            local_pickup?: boolean;
+        };
+        /**
+         * Buyer's IP address (from your X-Forwarded-For / req.headers).
+         * **Strongly recommended** for any card payment — MP's fraud engine
+         * checks IP geolocation, ASN reputation, proxy/VPN detection.
+         * Without IP, MP defaults to "unknown" which raises risk score.
+         */
+        ip_address?: string;
+        /** Referrer URL — useful for affiliate / channel attribution + fraud signal. */
+        referral_url?: string;
+    };
+    /** Statement descriptor — what shows on the buyer's card statement. Max 13 chars. */
+    statementDescriptor?: string;
+    /** When true, capture is deferred (only for credit cards) — useful for hold flows. */
+    capture?: boolean;
+    /** Idempotency key — pass the same value on retries to dedupe. Required for non-GET. */
+    idempotencyKey?: string;
+}
+interface SearchPaymentsParams {
+    /** Filter by external_reference (your-system id). */
+    externalReference?: string;
+    /** Filter by payment status. */
+    status?: PaymentStatus;
+    /** Filter by payer email. */
+    payerEmail?: string;
+    /** Date range for date_created (ISO 8601). */
+    beginDate?: string;
+    endDate?: string;
+    /** Result page (default 0). */
+    offset?: number;
+    /** Page size (default 30, max 100). */
+    limit?: number;
+    /** Sort: e.g. "date_created" desc. */
+    sort?: string;
+    criteria?: "asc" | "desc";
+}
+declare const PaymentsSearchResultSchema: z.ZodObject<{
+    paging: z.ZodObject<{
+        total: z.ZodNumber;
+        limit: z.ZodNumber;
+        offset: z.ZodNumber;
+    }, z.core.$strip>;
+    results: z.ZodArray<z.ZodObject<{
+        id: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+        status: z.ZodUnion<readonly [z.ZodLiteral<"pending">, z.ZodLiteral<"approved">, z.ZodLiteral<"authorized">, z.ZodLiteral<"in_process">, z.ZodLiteral<"in_mediation">, z.ZodLiteral<"rejected">, z.ZodLiteral<"cancelled">, z.ZodLiteral<"refunded">, z.ZodLiteral<"charged_back">, z.ZodString]>;
+        status_detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        date_created: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        date_approved: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        date_last_updated: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        transaction_amount: z.ZodNumber;
+        currency_id: z.ZodString;
+        installments: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        payment_method_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        payment_type_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        external_reference: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        payer: z.ZodOptional<z.ZodObject<{
+            id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            identification: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                number: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>>;
+        }, z.core.$loose>>;
+        transaction_details: z.ZodOptional<z.ZodObject<{
+            net_received_amount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            total_paid_amount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            installment_amount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
+}, z.core.$strip>;
+type PaymentsSearchResult = z.infer<typeof PaymentsSearchResultSchema>;
+declare const RefundSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    payment_id: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    amount: z.ZodNumber;
+    source: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+    date_created: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$loose>;
+type Refund = z.infer<typeof RefundSchema>;
+interface CreateRefundParams {
+    paymentId: string;
+    /** Partial refund amount. Omit for full refund. */
+    amount?: number;
+    /** Idempotency key — required for retry-safety. */
+    idempotencyKey?: string;
+}
+declare const PreferenceItemSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    picture_url: z.ZodOptional<z.ZodString>;
+    category_id: z.ZodOptional<z.ZodString>;
+    quantity: z.ZodNumber;
+    unit_price: z.ZodNumber;
+    currency_id: z.ZodOptional<z.ZodEnum<{
+        ARS: "ARS";
+        USD: "USD";
+        BRL: "BRL";
+        MXN: "MXN";
+    }>>;
+}, z.core.$strip>;
+type PreferenceItem = z.infer<typeof PreferenceItemSchema>;
+declare const PreferenceSchema: z.ZodObject<{
+    id: z.ZodString;
+    init_point: z.ZodOptional<z.ZodString>;
+    sandbox_init_point: z.ZodOptional<z.ZodString>;
+    client_id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    collector_id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    items: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        picture_url: z.ZodOptional<z.ZodString>;
+        category_id: z.ZodOptional<z.ZodString>;
+        quantity: z.ZodNumber;
+        unit_price: z.ZodNumber;
+        currency_id: z.ZodOptional<z.ZodEnum<{
+            ARS: "ARS";
+            USD: "USD";
+            BRL: "BRL";
+            MXN: "MXN";
+        }>>;
+    }, z.core.$strip>>>;
+    external_reference: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    date_created: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    expires: z.ZodOptional<z.ZodBoolean>;
+    expiration_date_from: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    expiration_date_to: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$loose>;
+type Preference = z.infer<typeof PreferenceSchema>;
+interface CreatePreferenceParams {
+    items: Array<{
+        title: string;
+        quantity: number;
+        unit_price: number;
+        currency_id?: CurrencyId;
+        description?: string;
+        picture_url?: string;
+    }>;
+    payer?: {
+        name?: string;
+        surname?: string;
+        email?: string;
+        phone?: {
+            area_code?: string;
+            number?: string;
+        };
+        identification?: {
+            type: string;
+            number: string;
+        };
+        address?: {
+            street_name?: string;
+            street_number?: number;
+            zip_code?: string;
+        };
+    };
+    /** Where to send the buyer after success/failure/pending. */
+    backUrls?: {
+        success?: string;
+        failure?: string;
+        pending?: string;
+    };
+    /** "approved" → auto-redirect on success; "all" → always; "" → never. */
+    autoReturn?: "approved" | "all";
+    /** Webhook URL. */
+    notificationUrl?: string;
+    /** Your-system id for correlation. */
+    externalReference?: string;
+    /** Max installments offered. Defaults to MP account config. */
+    paymentMethods?: {
+        excluded_payment_types?: Array<{
+            id: string;
+        }>;
+        excluded_payment_methods?: Array<{
+            id: string;
+        }>;
+        installments?: number;
+        default_installments?: number;
+    };
+    /** Statement descriptor — shows on buyer's card statement. */
+    statementDescriptor?: string;
+    /** Expiration window for the link itself. */
+    expires?: boolean;
+    expirationDateFrom?: string;
+    expirationDateTo?: string;
+    /**
+     * Marketplace split — if set, funds route to `collector_id` (the seller)
+     * and `marketplaceFee` (in ARS) is credited to the marketplace's MP
+     * account. v0.5+. See `MarketplaceParams` for details.
+     */
+    marketplace?: string;
+    marketplaceFee?: number;
+    /** Seller's MP user_id. Funds route here when set. */
+    collectorId?: string | number;
+    /**
+     * Optional explicit idempotency key. If omitted, the client auto-generates
+     * a UUID v4 per call. Pass a deterministic key (e.g., hash of items +
+     * external_reference) when you need cross-retry idempotency from the
+     * agent layer.
+     */
+    idempotencyKey?: string;
+}
+declare const CustomerSchema: z.ZodObject<{
+    id: z.ZodString;
+    email: z.ZodString;
+    first_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    last_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    phone: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        area_code: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        number: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+    identification: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        number: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+    date_created: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    date_last_updated: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$loose>;
+type Customer = z.infer<typeof CustomerSchema>;
+declare const CustomerCardSchema: z.ZodObject<{
+    id: z.ZodString;
+    customer_id: z.ZodString;
+    expiration_month: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    expiration_year: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    first_six_digits: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    last_four_digits: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    payment_method: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        payment_type_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+    date_created: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$loose>;
+type CustomerCard = z.infer<typeof CustomerCardSchema>;
+interface CreateCustomerParams {
+    email: string;
+    firstName?: string;
+    lastName?: string;
+    phone?: {
+        areaCode?: string;
+        number?: string;
+    };
+    identification?: {
+        type: "DNI" | "CUIT" | "CUIL";
+        number: string;
+    };
+    description?: string;
+}
+declare const PaymentMethodSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    payment_type_id: z.ZodString;
+    status: z.ZodString;
+    thumbnail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    secure_thumbnail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    min_allowed_amount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    max_allowed_amount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$loose>;
+type PaymentMethod = z.infer<typeof PaymentMethodSchema>;
+declare const InstallmentOfferSchema: z.ZodObject<{
+    payment_method_id: z.ZodString;
+    payment_type_id: z.ZodString;
+    issuer: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+    payer_costs: z.ZodArray<z.ZodObject<{
+        installments: z.ZodNumber;
+        installment_rate: z.ZodNumber;
+        discount_rate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        installment_amount: z.ZodNumber;
+        total_amount: z.ZodNumber;
+        recommended_message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+type InstallmentOffer = z.infer<typeof InstallmentOfferSchema>;
+declare const QrOrderSchema: z.ZodObject<{
+    in_store_order_id: z.ZodString;
+    qr_data: z.ZodString;
+}, z.core.$loose>;
+type QrOrder = z.infer<typeof QrOrderSchema>;
+interface CreateQrPaymentParams {
+    /** Pre-configured POS external_id from MP dashboard. Required. */
+    externalPosId: string;
+    /** Total amount in ARS. */
+    totalAmount: number;
+    /** Display title shown to the buyer when scanning. */
+    title: string;
+    description?: string;
+    /** Webhook URL — MP fires `point_integration_wh` then `payment` topic. */
+    notificationUrl?: string;
+    /** Your-system identifier for correlation. */
+    externalReference?: string;
+    /** ISO 8601 expiration (default 10 min from now). */
+    expirationDate?: string;
+    /** Itemized line items (optional but improves analytics). */
+    items?: Array<{
+        title: string;
+        quantity: number;
+        unit_price: number;
+        unit_measure?: string;
+        total_amount?: number;
+    }>;
+}
+declare const CardTokenSchema: z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodOptional<z.ZodString>;
+    date_due: z.ZodOptional<z.ZodString>;
+    card_id: z.ZodOptional<z.ZodString>;
+    cardholder: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$loose>;
+type CardToken = z.infer<typeof CardTokenSchema>;
+interface CreateCardTokenParams {
+    /** Saved card id (from list_customer_cards). */
+    cardId: string;
+    /** Customer that owns the card. */
+    customerId: string;
+    /** CVV — required for AR; MP doesn't store CVV. */
+    securityCode: string;
+}
+declare const AccountInfoSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    nickname: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    country_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    site_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    user_type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    status: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        user_type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$loose>>>;
+}, z.core.$loose>;
+type AccountInfo = z.infer<typeof AccountInfoSchema>;
+/**
+ * A reusable subscription plan. Different from a per-customer subscription:
+ * a plan defines the price + frequency once, then customers subscribe to it
+ * via `subscribe_to_plan` (which creates a preapproval pointing at the plan).
+ *
+ * Use plans for SaaS-style billing where you have a fixed set of tiers
+ * (Básico/Pro/Enterprise) instead of negotiating amounts per customer.
+ */
+declare const SubscriptionPlanSchema: z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodString;
+    reason: z.ZodString;
+    back_url: z.ZodOptional<z.ZodString>;
+    external_reference: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    date_created: z.ZodString;
+    last_modified: z.ZodString;
+    auto_recurring: z.ZodObject<{
+        frequency: z.ZodNumber;
+        frequency_type: z.ZodEnum<{
+            months: "months";
+            days: "days";
+        }>;
+        transaction_amount: z.ZodNumber;
+        currency_id: z.ZodEnum<{
+            ARS: "ARS";
+            USD: "USD";
+            BRL: "BRL";
+            MXN: "MXN";
+        }>;
+        start_date: z.ZodOptional<z.ZodString>;
+        end_date: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$loose>;
+type SubscriptionPlan = z.infer<typeof SubscriptionPlanSchema>;
+interface CreateSubscriptionPlanParams {
+    /** Customer-facing plan name shown at checkout. */
+    reason: string;
+    /** Where MP redirects buyer after first payment. HTTPS only. */
+    backUrl: string;
+    /** Recurrence (e.g., 1 + months = monthly). */
+    frequency: number;
+    frequencyType: FrequencyType;
+    /** Amount per cycle. */
+    amount: number;
+    /** ARS for AR. */
+    currency: CurrencyId;
+    /** Optional plan-level identifier from your system. */
+    externalReference?: string;
+    /** Free trial days before first charge. */
+    freeTrialFrequency?: number;
+    freeTrialFrequencyType?: FrequencyType;
+}
+declare const StoreSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    name: z.ZodOptional<z.ZodString>;
+    external_id: z.ZodOptional<z.ZodString>;
+    date_creation: z.ZodOptional<z.ZodString>;
+    location: z.ZodOptional<z.ZodObject<{
+        address_line: z.ZodOptional<z.ZodString>;
+        city_name: z.ZodOptional<z.ZodString>;
+        state_name: z.ZodOptional<z.ZodString>;
+        country_id: z.ZodOptional<z.ZodString>;
+        latitude: z.ZodOptional<z.ZodNumber>;
+        longitude: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+type Store = z.infer<typeof StoreSchema>;
+interface CreateStoreParams {
+    /** Display name for the store. */
+    name: string;
+    /** Caller-defined identifier (must be unique within the seller's stores). */
+    externalId: string;
+    /** Optional physical location. */
+    location?: {
+        addressLine?: string;
+        cityName?: string;
+        stateName?: string;
+        countryId?: string;
+        latitude?: number;
+        longitude?: number;
+    };
+}
+declare const PosSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    name: z.ZodOptional<z.ZodString>;
+    external_id: z.ZodOptional<z.ZodString>;
+    store_id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    category: z.ZodOptional<z.ZodNumber>;
+    fixed_amount: z.ZodOptional<z.ZodBoolean>;
+    qr: z.ZodOptional<z.ZodObject<{
+        template_image: z.ZodOptional<z.ZodString>;
+        image: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    date_creation: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+type Pos = z.infer<typeof PosSchema>;
+interface CreatePosParams {
+    /** Display name. */
+    name: string;
+    /** Caller-defined POS id (used in QR endpoints; unique within store). */
+    externalId: string;
+    /** Parent store id (number from createStore). */
+    storeId: string | number;
+    /** MP category code (default 621102 = Other Food and Beverage Services). */
+    category?: number;
+    /** If true, the QR has a fixed amount; if false, dynamic per-order. */
+    fixedAmount?: boolean;
+}
+declare const DisputeSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    status: z.ZodString;
+    resource: z.ZodOptional<z.ZodString>;
+    resource_id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    amount: z.ZodOptional<z.ZodNumber>;
+    date_created: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodString>;
+    resolution: z.ZodOptional<z.ZodObject<{
+        reason: z.ZodOptional<z.ZodString>;
+        result: z.ZodOptional<z.ZodString>;
+        date: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    documents: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    reason_description: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+type Dispute = z.infer<typeof DisputeSchema>;
+declare const SubscriptionPaymentSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    preapproval_id: z.ZodOptional<z.ZodString>;
+    status: z.ZodString;
+    payment_id: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    transaction_amount: z.ZodOptional<z.ZodNumber>;
+    currency_id: z.ZodOptional<z.ZodString>;
+    date_created: z.ZodOptional<z.ZodString>;
+    debit_date: z.ZodOptional<z.ZodString>;
+    next_retry_date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    retry_attempt: z.ZodOptional<z.ZodNumber>;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+type SubscriptionPayment = z.infer<typeof SubscriptionPaymentSchema>;
+declare const IdentificationTypeSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    type: z.ZodString;
+    min_length: z.ZodOptional<z.ZodNumber>;
+    max_length: z.ZodOptional<z.ZodNumber>;
+}, z.core.$loose>;
+type IdentificationType = z.infer<typeof IdentificationTypeSchema>;
+declare const IssuerSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    name: z.ZodString;
+    secure_thumbnail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    thumbnail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    processing_mode: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+type Issuer = z.infer<typeof IssuerSchema>;
+/** Topics MP can fire webhooks for. Add more as MP exposes them. */
+declare const WebhookTopicSchema: z.ZodEnum<{
+    payment: "payment";
+    subscription_authorized_payment: "subscription_authorized_payment";
+    subscription_preapproval: "subscription_preapproval";
+    merchant_order: "merchant_order";
+    point_integration_wh: "point_integration_wh";
+    stop_delivery_op_wh: "stop_delivery_op_wh";
+}>;
+type WebhookTopic = z.infer<typeof WebhookTopicSchema>;
+declare const WebhookConfigSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    url: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    topic: z.ZodOptional<z.ZodString>;
+    date_created: z.ZodOptional<z.ZodString>;
+    date_modified: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+type WebhookConfig = z.infer<typeof WebhookConfigSchema>;
+interface CreateWebhookParams {
+    url: string;
+    /** Topic to subscribe to. */
+    topic: WebhookTopic | string;
+}
+/**
+ * Token response from MP's OAuth `/oauth/token` endpoint. The `access_token`
+ * is what you use to make API calls AS the linked seller; the `refresh_token`
+ * is what you use to refresh the access_token before expiration (~6 hours).
+ *
+ * **Persist the refresh_token**: it does NOT expire and is the only way to
+ * keep the integration alive long-term.
+ *
+ * **Always store `user_id`** alongside the tokens — it identifies WHICH
+ * seller these tokens belong to (you'll have many in a marketplace).
+ */
+declare const OAuthTokenSchema: z.ZodObject<{
+    access_token: z.ZodString;
+    token_type: z.ZodOptional<z.ZodString>;
+    expires_in: z.ZodOptional<z.ZodNumber>;
+    scope: z.ZodOptional<z.ZodString>;
+    user_id: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    refresh_token: z.ZodOptional<z.ZodString>;
+    public_key: z.ZodOptional<z.ZodString>;
+    live_mode: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$loose>;
+type OAuthToken = z.infer<typeof OAuthTokenSchema>;
+/**
+ * Status of an Order. Distinct from Payment status — an Order can have
+ * multiple payments and the Order status reflects the aggregate state.
+ */
+declare const OrderStatusSchema: z.ZodUnion<readonly [z.ZodLiteral<"created">, z.ZodLiteral<"processed">, z.ZodLiteral<"action_required">, z.ZodLiteral<"canceled">, z.ZodLiteral<"expired">, z.ZodLiteral<"refunded">, z.ZodString]>;
+type OrderStatus = z.infer<typeof OrderStatusSchema>;
+declare const OrderItemSchema: z.ZodObject<{
+    title: z.ZodString;
+    unit_price: z.ZodNumber;
+    quantity: z.ZodNumber;
+    description: z.ZodOptional<z.ZodString>;
+    id: z.ZodOptional<z.ZodString>;
+    category_id: z.ZodOptional<z.ZodString>;
+    picture_url: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+type OrderItem = z.infer<typeof OrderItemSchema>;
+declare const OrderSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    type: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"created">, z.ZodLiteral<"processed">, z.ZodLiteral<"action_required">, z.ZodLiteral<"canceled">, z.ZodLiteral<"expired">, z.ZodLiteral<"refunded">, z.ZodString]>>;
+    status_detail: z.ZodOptional<z.ZodString>;
+    external_reference: z.ZodOptional<z.ZodString>;
+    total_amount: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    currency_id: z.ZodOptional<z.ZodString>;
+    date_created: z.ZodOptional<z.ZodString>;
+    date_last_updated: z.ZodOptional<z.ZodString>;
+    items: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        unit_price: z.ZodNumber;
+        quantity: z.ZodNumber;
+        description: z.ZodOptional<z.ZodString>;
+        id: z.ZodOptional<z.ZodString>;
+        category_id: z.ZodOptional<z.ZodString>;
+        picture_url: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    transactions: z.ZodOptional<z.ZodObject<{
+        payments: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+        refunds: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    }, z.core.$loose>>;
+    capture_mode: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+type Order = z.infer<typeof OrderSchema>;
+interface CreateOrderParams {
+    /**
+     * Order type. Common values:
+     * - "online" — checkout-style (the most common)
+     * - "in_store" — POS QR / in-person
+     */
+    type: "online" | "in_store" | string;
+    /** Currency (e.g. "ARS"). */
+    currency_id?: string;
+    /** External reference for reconciliation (your internal id). */
+    external_reference?: string;
+    /** Items being ordered. */
+    items?: OrderItem[];
+    /** Total amount if you'd rather not itemize. */
+    total_amount?: number;
+    /** Customer info (payer). */
+    payer?: {
+        email?: string;
+        first_name?: string;
+        last_name?: string;
+        identification?: {
+            type?: string;
+            number?: string;
+        };
+    };
+    /**
+     * Capture mode:
+     * - "automatic" (default) — charge immediately when paid.
+     * - "manual" — authorize only, capture later via captureOrder().
+     */
+    capture_mode?: "automatic" | "manual";
+    /**
+     * Notification URL — MP fires webhooks for order lifecycle events here.
+     */
+    notification_url?: string;
+    /**
+     * Marketplace fee + collector — required for marketplace integrations
+     * where YOU collect on behalf of a third-party seller (you take a fee,
+     * the rest goes to the seller).
+     */
+    marketplace?: string;
+    marketplace_fee?: number;
+    collector_id?: string | number;
+}
+/**
+ * Marketplace fee + collector params, applied to a Preference or Order.
+ *
+ * **How it works**: when you create a Preference or Order with
+ * `collector_id` set to a SELLER's MP user_id (not yours), and you have a
+ * valid OAuth access_token for that seller, MP routes the funds to the
+ * seller's MP account, and credits `marketplace_fee` (in ARS, not %) to
+ * YOUR marketplace account.
+ *
+ * Used for two-sided platforms (Rappi, MercadoLibre, Tienda Nube, etc.)
+ * where your platform takes a fee and the seller keeps the rest.
+ */
+interface MarketplaceParams {
+    /**
+     * Marketplace identifier — your application's marketplace name (you set
+     * this when registering your app in MP's dev panel).
+     */
+    marketplace?: string;
+    /**
+     * Fee in ARS (NOT a percentage) that goes to your marketplace account.
+     * Compute it from your own commission rate before passing.
+     */
+    marketplace_fee?: number;
+    /**
+     * The SELLER's MP user_id. The funds go to this account; the
+     * `marketplace_fee` is split off and goes to YOUR account.
+     * Get this from `OAuthToken.user_id` after the seller authorizes your app.
+     */
+    collector_id?: string | number;
+    /**
+     * Optional: split among multiple sellers. If set, `collector_id` /
+     * `marketplace_fee` are ignored.
+     */
+    application_fee?: number;
+}
+/**
+ * Account balance snapshot. Sum of `available + unavailable` is the seller's
+ * total Mercado Pago balance.
+ *
+ * - `available` — funds the seller can withdraw or pay with right now.
+ * - `unavailable` — funds in retention (typically 14-21 days for new sellers
+ *   or for risk-flagged transactions). Becomes `available` automatically.
+ */
+declare const AccountBalanceSchema: z.ZodObject<{
+    user_id: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>;
+    available_balance: z.ZodNumber;
+    unavailable_balance: z.ZodNumber;
+    total_amount: z.ZodNumber;
+    currency_id: z.ZodDefault<z.ZodString>;
+}, z.core.$loose>;
+type AccountBalance = z.infer<typeof AccountBalanceSchema>;
+/**
+ * Account movement (a single line in the seller's MP "movements" log).
+ * Includes incoming payments, outgoing transfers, refunds, holdings, etc.
+ */
+declare const AccountMovementSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    type: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    amount: z.ZodNumber;
+    currency_id: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    date_created: z.ZodOptional<z.ZodString>;
+    date_released: z.ZodOptional<z.ZodString>;
+    reference_id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    payment_id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+}, z.core.$loose>;
+type AccountMovement = z.infer<typeof AccountMovementSchema>;
+/**
+ * A scheduled or completed transfer from the MP account to the seller's
+ * registered bank account (CBU). Settlements are the core of "when do I
+ * actually get paid".
+ */
+declare const SettlementSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    status: z.ZodOptional<z.ZodString>;
+    amount: z.ZodOptional<z.ZodNumber>;
+    currency_id: z.ZodOptional<z.ZodString>;
+    date_created: z.ZodOptional<z.ZodString>;
+    date_scheduled: z.ZodOptional<z.ZodString>;
+    date_processed: z.ZodOptional<z.ZodString>;
+    bank_account: z.ZodOptional<z.ZodObject<{
+        cbu: z.ZodOptional<z.ZodString>;
+        bank_name: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+type Settlement = z.infer<typeof SettlementSchema>;
+type ThreeDSStatus = "not_required" | "frictionless" | "challenge_required" | "rejected" | "unknown";
+interface ThreeDSInfo {
+    /** High-level status — the field most agents care about. */
+    status: ThreeDSStatus;
+    /** Raw `three_d_secure_mode` field from the payment, if present. */
+    mode: string | null;
+    /**
+     * URL the buyer must visit to complete the 3DS challenge, if one was
+     * triggered. `null` for frictionless/not_required.
+     */
+    challengeUrl: string | null;
+    /** Human-readable explanation suitable for surfacing to the user. */
+    description: string;
+}
+declare const MerchantOrderSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    status: z.ZodOptional<z.ZodString>;
+    external_reference: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    preference_id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    payments: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    shipments: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    payer: z.ZodOptional<z.ZodUnknown>;
+    collector: z.ZodOptional<z.ZodUnknown>;
+    marketplace: z.ZodOptional<z.ZodString>;
+    total_amount: z.ZodOptional<z.ZodNumber>;
+    paid_amount: z.ZodOptional<z.ZodNumber>;
+    refunded_amount: z.ZodOptional<z.ZodNumber>;
+    shipping_cost: z.ZodOptional<z.ZodNumber>;
+    date_created: z.ZodOptional<z.ZodString>;
+    last_updated: z.ZodOptional<z.ZodString>;
+    site_id: z.ZodOptional<z.ZodString>;
+    order_status: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+type MerchantOrder = z.infer<typeof MerchantOrderSchema>;
+declare const BankAccountSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    cbu: z.ZodOptional<z.ZodString>;
+    alias: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    bank_name: z.ZodOptional<z.ZodString>;
+    account_type: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    is_default: z.ZodOptional<z.ZodBoolean>;
+    date_created: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+type BankAccount = z.infer<typeof BankAccountSchema>;
+declare const PointDeviceSchema: z.ZodObject<{
+    id: z.ZodString;
+    pos_id: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    store_id: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    external_pos_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    operating_mode: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"PDV">, z.ZodLiteral<"STANDALONE">, z.ZodString]>>;
+}, z.core.$loose>;
+type PointDevice = z.infer<typeof PointDeviceSchema>;
+type PointPaymentIntentState = "OPEN" | "PROCESSING" | "FINISHED" | "CANCELED" | "ERROR" | string;
+declare const PointPaymentIntentSchema: z.ZodObject<{
+    id: z.ZodString;
+    device_id: z.ZodOptional<z.ZodString>;
+    amount: z.ZodOptional<z.ZodNumber>;
+    state: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"OPEN">, z.ZodLiteral<"PROCESSING">, z.ZodLiteral<"FINISHED">, z.ZodLiteral<"CANCELED">, z.ZodLiteral<"ERROR">, z.ZodString]>>;
+    payment: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        type: z.ZodOptional<z.ZodString>;
+        installments: z.ZodOptional<z.ZodNumber>;
+        installments_cost: z.ZodOptional<z.ZodString>;
+        print_on_terminal: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$loose>>;
+    additional_info: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$loose>;
+type PointPaymentIntent = z.infer<typeof PointPaymentIntentSchema>;
+interface CreatePointPaymentIntentParams {
+    /** Amount in centavos (yes, centavos — Point API differs from Payments API). */
+    amount: number;
+    /** Description shown on the device screen + the buyer's receipt. */
+    description?: string;
+    /** Your-system reference (echoed back in the resulting Payment). */
+    externalReference?: string;
+    /** Number of installments (default 1). */
+    installments?: number;
+    /** "seller" or "buyer" — who pays the installment cost. */
+    installmentsCost?: "seller" | "buyer";
+    /**
+     * Print receipt on the terminal (default true). Some kiosks set false.
+     */
+    printOnTerminal?: boolean;
+    /** Ticket number (your sequential receipt number). */
+    ticketNumber?: string;
+}
+
+export type { PreapprovalStatus as $, AccountInfo as A, Settlement as B, CreatePreapprovalParams as C, Dispute as D, BankAccount as E, PointDevice as F, CreatePointPaymentIntentParams as G, PointPaymentIntent as H, InstallmentOffer as I, ParsedWebhookEvent as J, OAuthToken as K, AutoRecurring as L, MerchantOrder as M, CurrencyId as N, Order as O, Preapproval as P, QrOrder as Q, Refund as R, SearchPaymentsParams as S, ThreeDSInfo as T, FrequencyType as U, MarketplaceParams as V, WebhookConfig as W, OrderItem as X, OrderStatus as Y, PaymentStatus as Z, PointPaymentIntentState as _, CreatePaymentParams as a, PreferenceItem as a0, SiteId as a1, ThreeDSStatus as a2, WebhookBody as a3, WebhookTopic as a4, Payment as b, PaymentsSearchResult as c, CreateRefundParams as d, CreatePreferenceParams as e, Preference as f, CreateCustomerParams as g, Customer as h, CustomerCard as i, PaymentMethod as j, CreateCardTokenParams as k, CardToken as l, CreateQrPaymentParams as m, CreateSubscriptionPlanParams as n, SubscriptionPlan as o, SubscriptionPayment as p, CreateStoreParams as q, Store as r, CreatePosParams as s, Pos as t, IdentificationType as u, Issuer as v, CreateWebhookParams as w, CreateOrderParams as x, AccountBalance as y, AccountMovement as z };