@ar-agents/mercadopago 0.3.0 → 0.4.0

package/dist/index.d.cts

@@ -619,6 +619,186 @@ declare const AccountInfoSchema: z.ZodObject<{
     }, 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;
+}
 
 interface MercadoPagoClientOptions {
     /** Access token. TEST- prefix for sandbox, APP_USR- for production. */
@@ -820,6 +1000,103 @@ declare class MercadoPagoClient {
      * — otherwise the next `createQrPayment` on the same POS returns 409.
      */
     cancelQrPayment(userId: string, externalPosId: string): Promise<void>;
+    /**
+     * Create a reusable subscription plan. Customers later subscribe to it via
+     * `subscribeToPlan` (which creates a preapproval pointing at the plan).
+     *
+     * Use this when you have fixed tiers (Básico/Pro/Enterprise). For custom
+     * per-customer amounts, skip plans and use `createPreapproval` directly.
+     */
+    createSubscriptionPlan(params: CreateSubscriptionPlanParams): Promise<SubscriptionPlan>;
+    getSubscriptionPlan(id: string): Promise<SubscriptionPlan>;
+    listSubscriptionPlans(params?: {
+        limit?: number;
+        offset?: number;
+        status?: string;
+    }): Promise<{
+        paging: {
+            total: number;
+            limit: number;
+            offset: number;
+        };
+        results: SubscriptionPlan[];
+    }>;
+    updateSubscriptionPlan(id: string, patch: {
+        reason?: string;
+        status?: "active" | "cancelled";
+        amount?: number;
+        backUrl?: string;
+    }): Promise<SubscriptionPlan>;
+    /**
+     * Subscribe a customer to an existing plan. Returns a Preapproval with
+     * `init_point` URL where the buyer completes the first payment.
+     */
+    subscribeToPlan(params: {
+        planId: string;
+        payerEmail: string;
+        cardTokenId?: string;
+        externalReference?: string;
+    }): Promise<Preapproval>;
+    /**
+     * List the auto-charge attempts (authorized_payments) under a preapproval.
+     * Useful for "show me the cobros of the last 6 months for this client".
+     */
+    listSubscriptionPayments(preapprovalId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        paging: {
+            total: number;
+            limit: number;
+            offset: number;
+        };
+        results: SubscriptionPayment[];
+    }>;
+    /** Create a store for the seller. POSes (for QR) live under stores. */
+    createStore(userId: string, params: CreateStoreParams): Promise<Store>;
+    listStores(userId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        paging: {
+            total: number;
+            limit: number;
+            offset: number;
+        };
+        results: Store[];
+    }>;
+    /** Create a POS under a store. The POS's `external_id` is what `createQrPayment` uses. */
+    createPos(params: CreatePosParams): Promise<Pos>;
+    listPos(params?: {
+        storeId?: string | number;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        paging: {
+            total: number;
+            limit: number;
+            offset: number;
+        };
+        results: Pos[];
+    }>;
+    listPaymentDisputes(paymentId: string): Promise<Dispute[]>;
+    getDispute(paymentId: string, disputeId: string): Promise<Dispute>;
+    /** List valid identification types for the seller's site. AR returns DNI/CI/LE/LC/Otro/Pasaporte/CUIT/CUIL. */
+    listIdentificationTypes(): Promise<IdentificationType[]>;
+    /** List card issuers for a payment method. Useful with `bin` for installments. */
+    listIssuers(params: {
+        paymentMethodId: string;
+        bin?: string;
+    }): Promise<Issuer[]>;
+    /** List configured webhook subscriptions. */
+    listWebhooks(): Promise<WebhookConfig[]>;
+    /** Create a webhook subscription for a topic. */
+    createWebhook(params: CreateWebhookParams): Promise<WebhookConfig>;
+    updateWebhook(id: string, patch: {
+        url?: string;
+        topic?: string;
+    }): Promise<WebhookConfig>;
+    deleteWebhook(id: string): Promise<void>;
 }
 
 /**
@@ -888,7 +1165,7 @@ interface MercadoPagoToolsOptions {
      */
     notificationUrl?: string;
 }
-type ToolName = "create_subscription" | "get_subscription_status" | "cancel_subscription" | "pause_subscription" | "resume_subscription" | "create_payment" | "get_payment" | "search_payments" | "cancel_payment" | "capture_payment" | "refund_payment" | "list_refunds" | "create_payment_preference" | "get_payment_preference" | "create_customer" | "find_customer_by_email" | "list_customer_cards" | "delete_customer_card" | "list_payment_methods" | "calculate_installments" | "get_account_info" | "charge_saved_card" | "create_qr_payment" | "cancel_qr_payment";
+type ToolName = "create_subscription" | "get_subscription_status" | "cancel_subscription" | "pause_subscription" | "resume_subscription" | "create_payment" | "get_payment" | "search_payments" | "cancel_payment" | "capture_payment" | "refund_payment" | "list_refunds" | "create_payment_preference" | "get_payment_preference" | "create_customer" | "find_customer_by_email" | "list_customer_cards" | "delete_customer_card" | "list_payment_methods" | "calculate_installments" | "get_account_info" | "charge_saved_card" | "create_qr_payment" | "cancel_qr_payment" | "create_subscription_plan" | "list_subscription_plans" | "update_subscription_plan" | "subscribe_to_plan" | "list_subscription_payments" | "create_store" | "list_stores" | "create_pos" | "list_pos" | "list_payment_disputes" | "get_dispute" | "list_identification_types" | "list_issuers" | "list_webhooks" | "create_webhook" | "update_webhook" | "delete_webhook";
 /**
  * Build a tool set for the Vercel AI SDK that exposes Mercado Pago to an
  * agent. Pass directly to `Experimental_Agent`'s `tools` option, or merge with
@@ -954,4 +1231,4 @@ declare function verifyWebhookSignature(params: {
     secret: string;
 }): boolean;
 
-export { type AccountInfo, type AutoRecurring, type CardToken, type CreateCardTokenParams, type CreateCustomerParams, type CreatePaymentParams, type CreatePreapprovalParams, type CreatePreferenceParams, type CreateQrPaymentParams, type CreateRefundParams, type CurrencyId, type Customer, type CustomerCard, type FrequencyType, InMemoryStateAdapter, type InstallmentOffer, MercadoPagoAccountTypeMismatchError, MercadoPagoAuthError, MercadoPagoAuthorizeForbiddenError, MercadoPagoBackUrlInvalidError, MercadoPagoClient, type MercadoPagoClientOptions, MercadoPagoError, MercadoPagoOverloadedError, MercadoPagoPaymentRejectedError, MercadoPagoRateLimitError, MercadoPagoSelfPaymentError, MercadoPagoTimeoutError, type MercadoPagoToolsOptions, type ParsedWebhookEvent, type Payment, type PaymentMethod, type PaymentStatus, type PaymentsSearchResult, type Preapproval, type PreapprovalStatus, type Preference, type PreferenceItem, type QrOrder, type Refund, type SearchPaymentsParams, type SiteId, type SubscriptionStateAdapter, type SubscriptionStateRecord, type WebhookBody, classifyError, mercadoPagoTools, parseWebhookEvent, verifyWebhookSignature };
+export { type AccountInfo, type AutoRecurring, type CardToken, type CreateCardTokenParams, type CreateCustomerParams, type CreatePaymentParams, type CreatePosParams, type CreatePreapprovalParams, type CreatePreferenceParams, type CreateQrPaymentParams, type CreateRefundParams, type CreateStoreParams, type CreateSubscriptionPlanParams, type CreateWebhookParams, type CurrencyId, type Customer, type CustomerCard, type Dispute, type FrequencyType, type IdentificationType, InMemoryStateAdapter, type InstallmentOffer, type Issuer, MercadoPagoAccountTypeMismatchError, MercadoPagoAuthError, MercadoPagoAuthorizeForbiddenError, MercadoPagoBackUrlInvalidError, MercadoPagoClient, type MercadoPagoClientOptions, MercadoPagoError, MercadoPagoOverloadedError, MercadoPagoPaymentRejectedError, MercadoPagoRateLimitError, MercadoPagoSelfPaymentError, MercadoPagoTimeoutError, type MercadoPagoToolsOptions, type ParsedWebhookEvent, type Payment, type PaymentMethod, type PaymentStatus, type PaymentsSearchResult, type Pos, type Preapproval, type PreapprovalStatus, type Preference, type PreferenceItem, type QrOrder, type Refund, type SearchPaymentsParams, type SiteId, type Store, type SubscriptionPayment, type SubscriptionPlan, type SubscriptionStateAdapter, type SubscriptionStateRecord, type WebhookBody, type WebhookConfig, type WebhookTopic, classifyError, mercadoPagoTools, parseWebhookEvent, verifyWebhookSignature };

package/dist/index.d.ts

@@ -619,6 +619,186 @@ declare const AccountInfoSchema: z.ZodObject<{
     }, 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;
+}
 
 interface MercadoPagoClientOptions {
     /** Access token. TEST- prefix for sandbox, APP_USR- for production. */
@@ -820,6 +1000,103 @@ declare class MercadoPagoClient {
      * — otherwise the next `createQrPayment` on the same POS returns 409.
      */
     cancelQrPayment(userId: string, externalPosId: string): Promise<void>;
+    /**
+     * Create a reusable subscription plan. Customers later subscribe to it via
+     * `subscribeToPlan` (which creates a preapproval pointing at the plan).
+     *
+     * Use this when you have fixed tiers (Básico/Pro/Enterprise). For custom
+     * per-customer amounts, skip plans and use `createPreapproval` directly.
+     */
+    createSubscriptionPlan(params: CreateSubscriptionPlanParams): Promise<SubscriptionPlan>;
+    getSubscriptionPlan(id: string): Promise<SubscriptionPlan>;
+    listSubscriptionPlans(params?: {
+        limit?: number;
+        offset?: number;
+        status?: string;
+    }): Promise<{
+        paging: {
+            total: number;
+            limit: number;
+            offset: number;
+        };
+        results: SubscriptionPlan[];
+    }>;
+    updateSubscriptionPlan(id: string, patch: {
+        reason?: string;
+        status?: "active" | "cancelled";
+        amount?: number;
+        backUrl?: string;
+    }): Promise<SubscriptionPlan>;
+    /**
+     * Subscribe a customer to an existing plan. Returns a Preapproval with
+     * `init_point` URL where the buyer completes the first payment.
+     */
+    subscribeToPlan(params: {
+        planId: string;
+        payerEmail: string;
+        cardTokenId?: string;
+        externalReference?: string;
+    }): Promise<Preapproval>;
+    /**
+     * List the auto-charge attempts (authorized_payments) under a preapproval.
+     * Useful for "show me the cobros of the last 6 months for this client".
+     */
+    listSubscriptionPayments(preapprovalId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        paging: {
+            total: number;
+            limit: number;
+            offset: number;
+        };
+        results: SubscriptionPayment[];
+    }>;
+    /** Create a store for the seller. POSes (for QR) live under stores. */
+    createStore(userId: string, params: CreateStoreParams): Promise<Store>;
+    listStores(userId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        paging: {
+            total: number;
+            limit: number;
+            offset: number;
+        };
+        results: Store[];
+    }>;
+    /** Create a POS under a store. The POS's `external_id` is what `createQrPayment` uses. */
+    createPos(params: CreatePosParams): Promise<Pos>;
+    listPos(params?: {
+        storeId?: string | number;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        paging: {
+            total: number;
+            limit: number;
+            offset: number;
+        };
+        results: Pos[];
+    }>;
+    listPaymentDisputes(paymentId: string): Promise<Dispute[]>;
+    getDispute(paymentId: string, disputeId: string): Promise<Dispute>;
+    /** List valid identification types for the seller's site. AR returns DNI/CI/LE/LC/Otro/Pasaporte/CUIT/CUIL. */
+    listIdentificationTypes(): Promise<IdentificationType[]>;
+    /** List card issuers for a payment method. Useful with `bin` for installments. */
+    listIssuers(params: {
+        paymentMethodId: string;
+        bin?: string;
+    }): Promise<Issuer[]>;
+    /** List configured webhook subscriptions. */
+    listWebhooks(): Promise<WebhookConfig[]>;
+    /** Create a webhook subscription for a topic. */
+    createWebhook(params: CreateWebhookParams): Promise<WebhookConfig>;
+    updateWebhook(id: string, patch: {
+        url?: string;
+        topic?: string;
+    }): Promise<WebhookConfig>;
+    deleteWebhook(id: string): Promise<void>;
 }
 
 /**
@@ -888,7 +1165,7 @@ interface MercadoPagoToolsOptions {
      */
     notificationUrl?: string;
 }
-type ToolName = "create_subscription" | "get_subscription_status" | "cancel_subscription" | "pause_subscription" | "resume_subscription" | "create_payment" | "get_payment" | "search_payments" | "cancel_payment" | "capture_payment" | "refund_payment" | "list_refunds" | "create_payment_preference" | "get_payment_preference" | "create_customer" | "find_customer_by_email" | "list_customer_cards" | "delete_customer_card" | "list_payment_methods" | "calculate_installments" | "get_account_info" | "charge_saved_card" | "create_qr_payment" | "cancel_qr_payment";
+type ToolName = "create_subscription" | "get_subscription_status" | "cancel_subscription" | "pause_subscription" | "resume_subscription" | "create_payment" | "get_payment" | "search_payments" | "cancel_payment" | "capture_payment" | "refund_payment" | "list_refunds" | "create_payment_preference" | "get_payment_preference" | "create_customer" | "find_customer_by_email" | "list_customer_cards" | "delete_customer_card" | "list_payment_methods" | "calculate_installments" | "get_account_info" | "charge_saved_card" | "create_qr_payment" | "cancel_qr_payment" | "create_subscription_plan" | "list_subscription_plans" | "update_subscription_plan" | "subscribe_to_plan" | "list_subscription_payments" | "create_store" | "list_stores" | "create_pos" | "list_pos" | "list_payment_disputes" | "get_dispute" | "list_identification_types" | "list_issuers" | "list_webhooks" | "create_webhook" | "update_webhook" | "delete_webhook";
 /**
  * Build a tool set for the Vercel AI SDK that exposes Mercado Pago to an
  * agent. Pass directly to `Experimental_Agent`'s `tools` option, or merge with
@@ -954,4 +1231,4 @@ declare function verifyWebhookSignature(params: {
     secret: string;
 }): boolean;
 
-export { type AccountInfo, type AutoRecurring, type CardToken, type CreateCardTokenParams, type CreateCustomerParams, type CreatePaymentParams, type CreatePreapprovalParams, type CreatePreferenceParams, type CreateQrPaymentParams, type CreateRefundParams, type CurrencyId, type Customer, type CustomerCard, type FrequencyType, InMemoryStateAdapter, type InstallmentOffer, MercadoPagoAccountTypeMismatchError, MercadoPagoAuthError, MercadoPagoAuthorizeForbiddenError, MercadoPagoBackUrlInvalidError, MercadoPagoClient, type MercadoPagoClientOptions, MercadoPagoError, MercadoPagoOverloadedError, MercadoPagoPaymentRejectedError, MercadoPagoRateLimitError, MercadoPagoSelfPaymentError, MercadoPagoTimeoutError, type MercadoPagoToolsOptions, type ParsedWebhookEvent, type Payment, type PaymentMethod, type PaymentStatus, type PaymentsSearchResult, type Preapproval, type PreapprovalStatus, type Preference, type PreferenceItem, type QrOrder, type Refund, type SearchPaymentsParams, type SiteId, type SubscriptionStateAdapter, type SubscriptionStateRecord, type WebhookBody, classifyError, mercadoPagoTools, parseWebhookEvent, verifyWebhookSignature };
+export { type AccountInfo, type AutoRecurring, type CardToken, type CreateCardTokenParams, type CreateCustomerParams, type CreatePaymentParams, type CreatePosParams, type CreatePreapprovalParams, type CreatePreferenceParams, type CreateQrPaymentParams, type CreateRefundParams, type CreateStoreParams, type CreateSubscriptionPlanParams, type CreateWebhookParams, type CurrencyId, type Customer, type CustomerCard, type Dispute, type FrequencyType, type IdentificationType, InMemoryStateAdapter, type InstallmentOffer, type Issuer, MercadoPagoAccountTypeMismatchError, MercadoPagoAuthError, MercadoPagoAuthorizeForbiddenError, MercadoPagoBackUrlInvalidError, MercadoPagoClient, type MercadoPagoClientOptions, MercadoPagoError, MercadoPagoOverloadedError, MercadoPagoPaymentRejectedError, MercadoPagoRateLimitError, MercadoPagoSelfPaymentError, MercadoPagoTimeoutError, type MercadoPagoToolsOptions, type ParsedWebhookEvent, type Payment, type PaymentMethod, type PaymentStatus, type PaymentsSearchResult, type Pos, type Preapproval, type PreapprovalStatus, type Preference, type PreferenceItem, type QrOrder, type Refund, type SearchPaymentsParams, type SiteId, type Store, type SubscriptionPayment, type SubscriptionPlan, type SubscriptionStateAdapter, type SubscriptionStateRecord, type WebhookBody, type WebhookConfig, type WebhookTopic, classifyError, mercadoPagoTools, parseWebhookEvent, verifyWebhookSignature };