better-auth-mercadopago 0.1.3 → 0.1.5

package/dist/index.d.ts

@@ -0,0 +1,1278 @@
+import * as better_auth_client from 'better-auth/client';
+import { BetterFetchOption } from 'better-auth/client';
+import * as better_auth from 'better-auth';
+import { z } from 'zod';
+
+/** biome-ignore-all lint/suspicious/noExplicitAny: <no need to use any> */
+interface MercadoPagoPluginOptions {
+    /**
+     * Your Mercado Pago access token
+     */
+    accessToken: string;
+    /**
+     * Base URL for redirects and webhooks
+     * @default process.env.APP_URL
+     */
+    baseUrl?: string;
+    /**
+     * Webhook secret for signature verification (optional)
+     */
+    webhookSecret?: string;
+    /**
+     * App ID for OAuth (required for marketplace features)
+     * Get it from: https://www.mercadopago.com/developers/panel/app
+     */
+    appId?: string;
+    /**
+     * App Secret for OAuth (required for marketplace features)
+     */
+    appSecret?: string;
+    /**
+     * Trusted origins for OAuth redirects
+     */
+    trustedOrigins?: string[];
+    /**
+     * Callback executed when a payment status changes
+     */
+    onPaymentUpdate?: (data: {
+        payment: MercadoPagoPaymentRecord;
+        status: string;
+        statusDetail: string;
+        mpPayment: MercadoPagoPaymentResponse;
+    }) => void | Promise<void>;
+    /**
+     * Callback executed when a subscription status changes
+     */
+    onSubscriptionUpdate?: (data: {
+        subscription: MercadoPagoSubscriptionRecord;
+        status: string;
+        reason: string;
+        mpPreapproval: MercadoPagoPreApprovalResponse;
+    }) => void | Promise<void>;
+    /**
+     * Callback executed when a recurring payment is processed (monthly, etc.)
+     */
+    onSubscriptionPayment?: (data: {
+        subscription: MercadoPagoSubscriptionRecord;
+        payment: MercadoPagoPaymentResponse;
+        status: string;
+    }) => void | Promise<void>;
+}
+interface MercadoPagoCustomerRecord {
+    id: string;
+    userId: string;
+    mercadoPagoId: string;
+    email: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface MercadoPagoPaymentRecord {
+    id: string;
+    userId: string;
+    mercadoPagoPaymentId: string;
+    preferenceId: string;
+    status: string;
+    amount: number;
+    currency: string;
+    metadata?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface MercadoPagoSubscriptionRecord {
+    id: string;
+    userId: string;
+    mercadoPagoSubscriptionId: string;
+    planId: string;
+    status: string;
+    reason?: string;
+    nextPaymentDate?: Date;
+    lastPaymentDate?: Date;
+    summarized?: string;
+    metadata?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface MercadoPagoMarketplaceSplitRecord {
+    id: string;
+    paymentId: string;
+    collectorId: string;
+    collectorEmail: string;
+    applicationFeeAmount?: number;
+    applicationFeePercentage?: number;
+    netAmount: number;
+    metadata?: string;
+    createdAt: Date;
+}
+interface MercadoPagoOAuthTokenRecord {
+    id: string;
+    userId: string;
+    accessToken: string;
+    refreshToken: string;
+    publicKey: string;
+    mercadoPagoUserId: string;
+    expiresAt: Date;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface MercadoPagoPreapprovalPlanRecord {
+    id: string;
+    mercadoPagoPlanId: string;
+    reason: string;
+    frequency: number;
+    frequencyType: string;
+    transactionAmount: number;
+    currencyId: string;
+    repetitions?: number;
+    freeTrial?: string;
+    metadata?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface PaymentItem {
+    id: string;
+    title: string;
+    quantity: number;
+    unitPrice: number;
+    currencyId?: string;
+}
+interface MarketplaceConfig {
+    collectorId: string;
+    applicationFee?: number;
+    applicationFeePercentage?: number;
+}
+interface CreatePaymentParams {
+    items: PaymentItem[];
+    metadata?: Record<string, any>;
+    marketplace?: MarketplaceConfig;
+    successUrl?: string;
+    failureUrl?: string;
+    pendingUrl?: string;
+}
+interface CreateSubscriptionParams {
+    preapprovalPlanId?: string;
+    reason?: string;
+    autoRecurring?: {
+        frequency: number;
+        frequencyType: "days" | "months";
+        transactionAmount: number;
+        currencyId?: string;
+        startDate?: string;
+        endDate?: string;
+        freeTrial?: {
+            frequency: number;
+            frequencyType: "days" | "months";
+        };
+    };
+    backUrl?: string;
+    metadata?: Record<string, any>;
+}
+interface CreatePreapprovalPlanParams {
+    reason: string;
+    autoRecurring: {
+        frequency: number;
+        frequencyType: "days" | "months";
+        transactionAmount: number;
+        currencyId?: string;
+        freeTrial?: {
+            frequency: number;
+            frequencyType: "days" | "months";
+        };
+    };
+    repetitions?: number;
+    backUrl?: string;
+    metadata?: Record<string, any>;
+}
+interface CreatePreapprovalPlanResponse {
+    plan: MercadoPagoPreapprovalPlanRecord;
+}
+interface CreatePaymentResponse {
+    checkoutUrl: string;
+    preferenceId: string;
+    payment: MercadoPagoPaymentRecord;
+}
+interface CreateSubscriptionResponse {
+    checkoutUrl: string;
+    subscription: MercadoPagoSubscriptionRecord;
+}
+interface OAuthUrlResponse {
+    authUrl: string;
+}
+interface OAuthTokenResponse {
+    success: boolean;
+    oauthToken: {
+        id: string;
+        mercadoPagoUserId: string;
+        expiresAt: Date;
+    };
+}
+interface MercadoPagoPaymentResponse {
+    id: number;
+    date_created: string;
+    date_approved: string;
+    date_last_updated: string;
+    money_release_date: string;
+    payment_method_id: string;
+    payment_type_id: string;
+    status: string;
+    status_detail: string;
+    currency_id: string;
+    description: string;
+    live_mode: boolean;
+    sponsor_id: number;
+    authorization_code: string;
+    integrator_id: string;
+    taxes_amount: number;
+    counter_currency: string;
+    operation_type: string;
+    additional_info: {
+        items: {
+            id: string;
+            title: string;
+            description: string;
+            picture_url: string;
+            category_id: string;
+            quantity: string;
+            unit_price: string;
+        }[];
+        payer: {
+            first_name: string;
+            last_name: string;
+            phone: {
+                area_code: string;
+                number: string;
+            };
+        };
+        ip_address: string;
+    };
+    external_reference: string;
+    transaction_amount: number;
+    transaction_amount_refunded: number;
+    coupon_amount: number;
+    installments: number;
+    transaction_details: {
+        net_received_amount: number;
+        total_paid_amount: number;
+        overpaid_amount: number;
+        external_resource_url: string;
+        installment_amount: number;
+        financial_institution: string;
+        payment_method_reference_id: string;
+    };
+}
+interface MercadoPagoPreApprovalResponse {
+    id: string;
+    payer_id: number;
+    payer_email: string;
+    back_url: string;
+    collector_id: number;
+    application_id: number;
+    status: string;
+    reason: string;
+    external_reference: string;
+    date_created: string;
+    last_modified: string;
+    init_point: string;
+    auto_recurring: {
+        frequency: number;
+        frequency_type: string;
+        transaction_amount: number;
+        currency_id: string;
+        start_date: string;
+        end_date: string;
+        free_trial?: {
+            frequency: number;
+            frequency_type: string;
+        };
+    };
+    summarized?: {
+        quotas: number;
+        charged_quantity: number;
+        pending_charge_quantity: number;
+        charged_amount: number;
+        pending_charge_amount: number;
+        semester: number;
+        year: number;
+    };
+    next_payment_date: string;
+    payment_method_id: string;
+}
+
+declare const mercadoPagoPlugin: (options: MercadoPagoPluginOptions) => {
+    trustedOrigins?: string[] | undefined;
+    id: "mercado-pago";
+    schema: {
+        mercadoPagoCustomer: {
+            fields: {
+                id: {
+                    type: "string";
+                    required: true;
+                };
+                userId: {
+                    type: "string";
+                    required: true;
+                    references: {
+                        model: string;
+                        field: string;
+                        onDelete: "cascade";
+                    };
+                };
+                mercadoPagoId: {
+                    type: "string";
+                    required: true;
+                    unique: true;
+                };
+                email: {
+                    type: "string";
+                    required: true;
+                };
+                createdAt: {
+                    type: "date";
+                    required: true;
+                };
+                updatedAt: {
+                    type: "date";
+                    required: true;
+                };
+            };
+        };
+        mercadoPagoPayment: {
+            fields: {
+                id: {
+                    type: "string";
+                    required: true;
+                };
+                userId: {
+                    type: "string";
+                    required: true;
+                    references: {
+                        model: string;
+                        field: string;
+                        onDelete: "cascade";
+                    };
+                };
+                mercadoPagoPaymentId: {
+                    type: "string";
+                    required: true;
+                    unique: true;
+                };
+                preferenceId: {
+                    type: "string";
+                    required: true;
+                };
+                status: {
+                    type: "string";
+                    required: true;
+                };
+                statusDetail: {
+                    type: "string";
+                };
+                amount: {
+                    type: "number";
+                    required: true;
+                };
+                currency: {
+                    type: "string";
+                    required: true;
+                };
+                paymentMethodId: {
+                    type: "string";
+                };
+                paymentTypeId: {
+                    type: "string";
+                };
+                metadata: {
+                    type: "string";
+                };
+                createdAt: {
+                    type: "date";
+                    required: true;
+                };
+                updatedAt: {
+                    type: "date";
+                    required: true;
+                };
+            };
+        };
+        mercadoPagoSubscription: {
+            fields: {
+                id: {
+                    type: "string";
+                    required: true;
+                };
+                userId: {
+                    type: "string";
+                    required: true;
+                    references: {
+                        model: string;
+                        field: string;
+                        onDelete: "cascade";
+                    };
+                };
+                mercadoPagoSubscriptionId: {
+                    type: "string";
+                    required: true;
+                    unique: true;
+                };
+                planId: {
+                    type: "string";
+                    required: true;
+                };
+                status: {
+                    type: "string";
+                    required: true;
+                };
+                reason: {
+                    type: "string";
+                };
+                nextPaymentDate: {
+                    type: "date";
+                };
+                lastPaymentDate: {
+                    type: "date";
+                };
+                summarized: {
+                    type: "string";
+                };
+                metadata: {
+                    type: "string";
+                };
+                createdAt: {
+                    type: "date";
+                    required: true;
+                };
+                updatedAt: {
+                    type: "date";
+                    required: true;
+                };
+            };
+        };
+        mercadoPagoPreapprovalPlan: {
+            fields: {
+                id: {
+                    type: "string";
+                    required: true;
+                };
+                mercadoPagoPlanId: {
+                    type: "string";
+                    required: true;
+                    unique: true;
+                };
+                reason: {
+                    type: "string";
+                    required: true;
+                };
+                frequency: {
+                    type: "number";
+                    required: true;
+                };
+                frequencyType: {
+                    type: "string";
+                    required: true;
+                };
+                transactionAmount: {
+                    type: "number";
+                    required: true;
+                };
+                currencyId: {
+                    type: "string";
+                    required: true;
+                };
+                repetitions: {
+                    type: "number";
+                };
+                freeTrial: {
+                    type: "string";
+                };
+                metadata: {
+                    type: "string";
+                };
+                createdAt: {
+                    type: "date";
+                    required: true;
+                };
+                updatedAt: {
+                    type: "date";
+                    required: true;
+                };
+            };
+        };
+        mercadoPagoMarketplaceSplit: {
+            fields: {
+                id: {
+                    type: "string";
+                    required: true;
+                };
+                paymentId: {
+                    type: "string";
+                    required: true;
+                    references: {
+                        model: string;
+                        field: string;
+                        onDelete: "cascade";
+                    };
+                };
+                collectorId: {
+                    type: "string";
+                    required: true;
+                };
+                collectorEmail: {
+                    type: "string";
+                    required: true;
+                };
+                applicationFeeAmount: {
+                    type: "number";
+                };
+                applicationFeePercentage: {
+                    type: "number";
+                };
+                netAmount: {
+                    type: "number";
+                    required: true;
+                };
+                metadata: {
+                    type: "string";
+                };
+                createdAt: {
+                    type: "date";
+                    required: true;
+                };
+            };
+        };
+        mercadoPagoOAuthToken: {
+            fields: {
+                id: {
+                    type: "string";
+                    required: true;
+                };
+                userId: {
+                    type: "string";
+                    required: true;
+                    references: {
+                        model: string;
+                        field: string;
+                        onDelete: "cascade";
+                    };
+                };
+                accessToken: {
+                    type: "string";
+                    required: true;
+                };
+                refreshToken: {
+                    type: "string";
+                    required: true;
+                };
+                publicKey: {
+                    type: "string";
+                    required: true;
+                };
+                mercadoPagoUserId: {
+                    type: "string";
+                    required: true;
+                    unique: true;
+                };
+                expiresAt: {
+                    type: "date";
+                    required: true;
+                };
+                createdAt: {
+                    type: "date";
+                    required: true;
+                };
+                updatedAt: {
+                    type: "date";
+                    required: true;
+                };
+            };
+        };
+    };
+    endpoints: {
+        getOrCreateCustomer: better_auth.StrictEndpoint<"/mercado-pago/customer", {
+            method: "POST";
+            requireAuth: boolean;
+            body: z.ZodObject<{
+                email: z.ZodOptional<z.ZodString>;
+                firstName: z.ZodOptional<z.ZodString>;
+                lastName: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                email?: string | undefined;
+                firstName?: string | undefined;
+                lastName?: string | undefined;
+            }, {
+                email?: string | undefined;
+                firstName?: string | undefined;
+                lastName?: string | undefined;
+            }>;
+        }, {
+            customer: {};
+        }>;
+        getOAuthUrl: better_auth.StrictEndpoint<"/mercado-pago/oauth/authorize", {
+            method: "GET";
+            requireAuth: boolean;
+            query: z.ZodObject<{
+                redirectUri: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                redirectUri: string;
+            }, {
+                redirectUri: string;
+            }>;
+        }, {
+            authUrl: string;
+        }>;
+        exchangeOAuthCode: better_auth.StrictEndpoint<"/mercado-pago/oauth/callback", {
+            method: "POST";
+            requireAuth: boolean;
+            body: z.ZodObject<{
+                code: z.ZodString;
+                redirectUri: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                redirectUri: string;
+            }, {
+                code: string;
+                redirectUri: string;
+            }>;
+        }, {
+            success: boolean;
+            oauthToken: {
+                id: any;
+                mercadoPagoUserId: any;
+                expiresAt: any;
+            };
+        }>;
+        createPreapprovalPlan: better_auth.StrictEndpoint<"/mercado-pago/plan/create", {
+            method: "POST";
+            body: z.ZodObject<{
+                reason: z.ZodString;
+                autoRecurring: z.ZodObject<{
+                    frequency: z.ZodNumber;
+                    frequencyType: z.ZodEnum<["days", "months"]>;
+                    transactionAmount: z.ZodNumber;
+                    currencyId: z.ZodDefault<z.ZodString>;
+                    freeTrial: z.ZodOptional<z.ZodObject<{
+                        frequency: z.ZodNumber;
+                        frequencyType: z.ZodEnum<["days", "months"]>;
+                    }, "strip", z.ZodTypeAny, {
+                        frequency: number;
+                        frequencyType: "days" | "months";
+                    }, {
+                        frequency: number;
+                        frequencyType: "days" | "months";
+                    }>>;
+                }, "strip", z.ZodTypeAny, {
+                    frequency: number;
+                    frequencyType: "days" | "months";
+                    transactionAmount: number;
+                    currencyId: string;
+                    freeTrial?: {
+                        frequency: number;
+                        frequencyType: "days" | "months";
+                    } | undefined;
+                }, {
+                    frequency: number;
+                    frequencyType: "days" | "months";
+                    transactionAmount: number;
+                    currencyId?: string | undefined;
+                    freeTrial?: {
+                        frequency: number;
+                        frequencyType: "days" | "months";
+                    } | undefined;
+                }>;
+                repetitions: z.ZodOptional<z.ZodNumber>;
+                backUrl: z.ZodOptional<z.ZodString>;
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            }, "strip", z.ZodTypeAny, {
+                reason: string;
+                autoRecurring: {
+                    frequency: number;
+                    frequencyType: "days" | "months";
+                    transactionAmount: number;
+                    currencyId: string;
+                    freeTrial?: {
+                        frequency: number;
+                        frequencyType: "days" | "months";
+                    } | undefined;
+                };
+                metadata?: Record<string, any> | undefined;
+                repetitions?: number | undefined;
+                backUrl?: string | undefined;
+            }, {
+                reason: string;
+                autoRecurring: {
+                    frequency: number;
+                    frequencyType: "days" | "months";
+                    transactionAmount: number;
+                    currencyId?: string | undefined;
+                    freeTrial?: {
+                        frequency: number;
+                        frequencyType: "days" | "months";
+                    } | undefined;
+                };
+                metadata?: Record<string, any> | undefined;
+                repetitions?: number | undefined;
+                backUrl?: string | undefined;
+            }>;
+        }, {
+            plan: Record<string, any>;
+        }>;
+        listPreapprovalPlans: better_auth.StrictEndpoint<"/mercado-pago/plans", {
+            method: "GET";
+        }, {
+            plans: unknown[];
+        }>;
+        createPayment: better_auth.StrictEndpoint<"/mercado-pago/payment/create", {
+            method: "POST";
+            requireAuth: boolean;
+            body: z.ZodObject<{
+                items: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    title: z.ZodString;
+                    quantity: z.ZodNumber;
+                    unitPrice: z.ZodNumber;
+                    currencyId: z.ZodDefault<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    id: string;
+                    currencyId: string;
+                    title: string;
+                    quantity: number;
+                    unitPrice: number;
+                }, {
+                    id: string;
+                    title: string;
+                    quantity: number;
+                    unitPrice: number;
+                    currencyId?: string | undefined;
+                }>, "many">;
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                marketplace: z.ZodOptional<z.ZodObject<{
+                    collectorId: z.ZodString;
+                    applicationFee: z.ZodOptional<z.ZodNumber>;
+                    applicationFeePercentage: z.ZodOptional<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    collectorId: string;
+                    applicationFeePercentage?: number | undefined;
+                    applicationFee?: number | undefined;
+                }, {
+                    collectorId: string;
+                    applicationFeePercentage?: number | undefined;
+                    applicationFee?: number | undefined;
+                }>>;
+                successUrl: z.ZodOptional<z.ZodString>;
+                failureUrl: z.ZodOptional<z.ZodString>;
+                pendingUrl: z.ZodOptional<z.ZodString>;
+                idempotencyKey: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                items: {
+                    id: string;
+                    currencyId: string;
+                    title: string;
+                    quantity: number;
+                    unitPrice: number;
+                }[];
+                metadata?: Record<string, any> | undefined;
+                marketplace?: {
+                    collectorId: string;
+                    applicationFeePercentage?: number | undefined;
+                    applicationFee?: number | undefined;
+                } | undefined;
+                successUrl?: string | undefined;
+                failureUrl?: string | undefined;
+                pendingUrl?: string | undefined;
+                idempotencyKey?: string | undefined;
+            }, {
+                items: {
+                    id: string;
+                    title: string;
+                    quantity: number;
+                    unitPrice: number;
+                    currencyId?: string | undefined;
+                }[];
+                metadata?: Record<string, any> | undefined;
+                marketplace?: {
+                    collectorId: string;
+                    applicationFeePercentage?: number | undefined;
+                    applicationFee?: number | undefined;
+                } | undefined;
+                successUrl?: string | undefined;
+                failureUrl?: string | undefined;
+                pendingUrl?: string | undefined;
+                idempotencyKey?: string | undefined;
+            }>;
+        }, any>;
+        createSubscription: better_auth.StrictEndpoint<"/mercado-pago/subscription/create", {
+            method: "POST";
+            requireAuth: boolean;
+            body: z.ZodObject<{
+                preapprovalPlanId: z.ZodOptional<z.ZodString>;
+                reason: z.ZodOptional<z.ZodString>;
+                autoRecurring: z.ZodOptional<z.ZodObject<{
+                    frequency: z.ZodNumber;
+                    frequencyType: z.ZodEnum<["days", "months"]>;
+                    transactionAmount: z.ZodNumber;
+                    currencyId: z.ZodDefault<z.ZodString>;
+                    startDate: z.ZodOptional<z.ZodString>;
+                    endDate: z.ZodOptional<z.ZodString>;
+                    freeTrial: z.ZodOptional<z.ZodObject<{
+                        frequency: z.ZodNumber;
+                        frequencyType: z.ZodEnum<["days", "months"]>;
+                    }, "strip", z.ZodTypeAny, {
+                        frequency: number;
+                        frequencyType: "days" | "months";
+                    }, {
+                        frequency: number;
+                        frequencyType: "days" | "months";
+                    }>>;
+                }, "strip", z.ZodTypeAny, {
+                    frequency: number;
+                    frequencyType: "days" | "months";
+                    transactionAmount: number;
+                    currencyId: string;
+                    freeTrial?: {
+                        frequency: number;
+                        frequencyType: "days" | "months";
+                    } | undefined;
+                    startDate?: string | undefined;
+                    endDate?: string | undefined;
+                }, {
+                    frequency: number;
+                    frequencyType: "days" | "months";
+                    transactionAmount: number;
+                    currencyId?: string | undefined;
+                    freeTrial?: {
+                        frequency: number;
+                        frequencyType: "days" | "months";
+                    } | undefined;
+                    startDate?: string | undefined;
+                    endDate?: string | undefined;
+                }>>;
+                backUrl: z.ZodOptional<z.ZodString>;
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            }, "strip", z.ZodTypeAny, {
+                metadata?: Record<string, any> | undefined;
+                reason?: string | undefined;
+                autoRecurring?: {
+                    frequency: number;
+                    frequencyType: "days" | "months";
+                    transactionAmount: number;
+                    currencyId: string;
+                    freeTrial?: {
+                        frequency: number;
+                        frequencyType: "days" | "months";
+                    } | undefined;
+                    startDate?: string | undefined;
+                    endDate?: string | undefined;
+                } | undefined;
+                backUrl?: string | undefined;
+                preapprovalPlanId?: string | undefined;
+            }, {
+                metadata?: Record<string, any> | undefined;
+                reason?: string | undefined;
+                autoRecurring?: {
+                    frequency: number;
+                    frequencyType: "days" | "months";
+                    transactionAmount: number;
+                    currencyId?: string | undefined;
+                    freeTrial?: {
+                        frequency: number;
+                        frequencyType: "days" | "months";
+                    } | undefined;
+                    startDate?: string | undefined;
+                    endDate?: string | undefined;
+                } | undefined;
+                backUrl?: string | undefined;
+                preapprovalPlanId?: string | undefined;
+            }>;
+        }, {
+            checkoutUrl: string | undefined;
+            subscription: Record<string, any>;
+        }>;
+        cancelSubscription: better_auth.StrictEndpoint<"/mercado-pago/subscription/cancel", {
+            method: "POST";
+            requireAuth: boolean;
+            body: z.ZodObject<{
+                subscriptionId: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                subscriptionId: string;
+            }, {
+                subscriptionId: string;
+            }>;
+        }, {
+            success: boolean;
+        }>;
+        getPayment: better_auth.StrictEndpoint<"/mercado-pago/payment/:id", {
+            method: "GET";
+            requireAuth: boolean;
+        }, {
+            payment: MercadoPagoPaymentRecord;
+        }>;
+        listPayments: better_auth.StrictEndpoint<"/mercado-pago/payments", {
+            method: "GET";
+            requireAuth: boolean;
+            query: z.ZodObject<{
+                limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            }, "strip", z.ZodTypeAny, {
+                limit: number;
+                offset: number;
+            }, {
+                limit?: number | undefined;
+                offset?: number | undefined;
+            }>;
+        }, {
+            payments: unknown[];
+        }>;
+        listSubscriptions: better_auth.StrictEndpoint<"/mercado-pago/subscriptions", {
+            method: "GET";
+            requireAuth: boolean;
+        }, {
+            subscriptions: unknown[];
+        }>;
+        webhook: better_auth.StrictEndpoint<"/mercado-pago/webhook", {
+            method: "POST";
+        }, {
+            received: boolean;
+        }>;
+    };
+};
+
+declare const mercadoPagoClient: () => {
+    id: "mercado-pago";
+    $InferServerPlugin: ReturnType<typeof mercadoPagoPlugin>;
+    getActions: ($fetch: better_auth_client.BetterFetch) => {
+        /**
+         * Get or create a Mercado Pago customer for the authenticated user
+         */
+        getOrCreateCustomer: (data?: {
+            email?: string;
+            firstName?: string;
+            lastName?: string;
+        }, fetchOptions?: BetterFetchOption) => Promise<{
+            data: {
+                customer: MercadoPagoCustomerRecord;
+            };
+            error: null;
+        } | {
+            data: null;
+            error: {
+                message?: string | undefined;
+                status: number;
+                statusText: string;
+            };
+        }>;
+        /**
+         * Create a payment and get checkout URL
+         *
+         * @example
+         * ```ts
+         * const { data } = await authClient.mercadoPago.createPayment({
+         *   items: [{
+         *     title: "Premium Plan",
+         *     quantity: 1,
+         *     unitPrice: 99.90,
+         *     currencyId: "ARS"
+         *   }]
+         * });
+         *
+         * // Redirect user to checkout
+         * window.location.href = data.checkoutUrl;
+         * ```
+         */
+        createPayment: (data: CreatePaymentParams, fetchOptions?: BetterFetchOption) => Promise<{
+            data: null;
+            error: {
+                message?: string | undefined;
+                status: number;
+                statusText: string;
+            };
+        } | {
+            data: CreatePaymentResponse;
+            error: null;
+        }>;
+        /**
+         * Create a marketplace payment with automatic split
+         *
+         * You need to have the seller's MP User ID (collector_id) which they get
+         * after authorizing your app via OAuth.
+         *
+         * @example
+         * ```ts
+         * const { data } = await authClient.mercadoPago.createPayment({
+         *   items: [{
+         *     title: "Product from Seller",
+         *     quantity: 1,
+         *     unitPrice: 100
+         *   }],
+         *   marketplace: {
+         *     collectorId: "123456789", // Seller's MP User ID
+         *     applicationFeePercentage: 10 // Platform keeps 10%
+         *   }
+         * });
+         * ```
+         */
+        createMarketplacePayment: (data: CreatePaymentParams, fetchOptions?: BetterFetchOption) => Promise<{
+            data: null;
+            error: {
+                message?: string | undefined;
+                status: number;
+                statusText: string;
+            };
+        } | {
+            data: CreatePaymentResponse;
+            error: null;
+        }>;
+        /**
+         * Create a subscription with recurring payments
+         *
+         * Supports two modes:
+         * 1. With preapproval plan (reusable): Pass preapprovalPlanId
+         * 2. Direct subscription (one-off): Pass reason + autoRecurring
+         *
+         * @example With plan
+         * ```ts
+         * const { data } = await authClient.mercadoPago.createSubscription({
+         *   preapprovalPlanId: "plan_abc123"
+         * });
+         * ```
+         *
+         * @example Direct (without plan)
+         * ```ts
+         * const { data } = await authClient.mercadoPago.createSubscription({
+         *   reason: "Premium Monthly Plan",
+         *   autoRecurring: {
+         *     frequency: 1,
+         *     frequencyType: "months",
+         *     transactionAmount: 99.90,
+         *     currencyId: "ARS"
+         *   }
+         * });
+         * ```
+         */
+        createSubscription: (data: CreateSubscriptionParams, fetchOptions?: BetterFetchOption) => Promise<{
+            data: null;
+            error: {
+                message?: string | undefined;
+                status: number;
+                statusText: string;
+            };
+        } | {
+            data: CreateSubscriptionResponse;
+            error: null;
+        }>;
+        /**
+         * Cancel a subscription
+         *
+         * @example
+         * ```ts
+         * await authClient.mercadoPago.cancelSubscription({
+         *   subscriptionId: "sub_123"
+         * });
+         * ```
+         */
+        cancelSubscription: (data: {
+            subscriptionId: string;
+        }, fetchOptions?: BetterFetchOption) => Promise<{
+            data: null;
+            error: {
+                message?: string | undefined;
+                status: number;
+                statusText: string;
+            };
+        } | {
+            data: {
+                success: boolean;
+            };
+            error: null;
+        }>;
+        /**
+         * Create a reusable preapproval plan (subscription template)
+         *
+         * Plans can be reused for multiple subscriptions. Create once,
+         * use many times with createSubscription({ preapprovalPlanId })
+         *
+         * @example
+         * ```ts
+         * const { data } = await authClient.mercadoPago.createPreapprovalPlan({
+         *   reason: "Premium Monthly",
+         *   autoRecurring: {
+         *     frequency: 1,
+         *     frequencyType: "months",
+         *     transactionAmount: 99.90,
+         *     freeTrial: {
+         *       frequency: 7,
+         *       frequencyType: "days"
+         *     }
+         *   },
+         *   repetitions: 12 // 12 months, omit for infinite
+         * });
+         *
+         * // Use the plan
+         * const planId = data.plan.mercadoPagoPlanId;
+         * ```
+         */
+        createPreapprovalPlan: (data: CreatePreapprovalPlanParams, fetchOptions?: BetterFetchOption) => Promise<{
+            data: null;
+            error: {
+                message?: string | undefined;
+                status: number;
+                statusText: string;
+            };
+        } | {
+            data: CreatePreapprovalPlanResponse;
+            error: null;
+        }>;
+        /**
+         * List all preapproval plans
+         *
+         * @example
+         * ```ts
+         * const { data } = await authClient.mercadoPago.listPreapprovalPlans();
+         *
+         * data.plans.forEach(plan => {
+         *   console.log(plan.reason); // "Premium Monthly"
+         *   console.log(plan.transactionAmount); // 99.90
+         * });
+         * ```
+         */
+        listPreapprovalPlans: (fetchOptions?: BetterFetchOption) => Promise<{
+            data: null;
+            error: {
+                message?: string | undefined;
+                status: number;
+                statusText: string;
+            };
+        } | {
+            data: {
+                plans: MercadoPagoPreapprovalPlanRecord[];
+            };
+            error: null;
+        }>;
+        /**
+         * Get payment by ID
+         */
+        getPayment: (paymentId: string, fetchOptions?: BetterFetchOption) => Promise<{
+            data: null;
+            error: {
+                message?: string | undefined;
+                status: number;
+                statusText: string;
+            };
+        } | {
+            data: {
+                payment: MercadoPagoPaymentRecord;
+            };
+            error: null;
+        }>;
+        /**
+         * List all payments for the authenticated user
+         *
+         * @example
+         * ```ts
+         * const { data } = await authClient.mercadoPago.listPayments({
+         *   limit: 20,
+         *   offset: 0
+         * });
+         * ```
+         */
+        listPayments: (params?: {
+            limit?: number;
+            offset?: number;
+        }, fetchOptions?: BetterFetchOption) => Promise<{
+            data: null;
+            error: {
+                message?: string | undefined;
+                status: number;
+                statusText: string;
+            };
+        } | {
+            data: {
+                payments: MercadoPagoPaymentRecord[];
+            };
+            error: null;
+        }>;
+        /**
+         * List all subscriptions for the authenticated user
+         *
+         * @example
+         * ```ts
+         * const { data } = await authClient.mercadoPago.listSubscriptions();
+         * ```
+         */
+        listSubscriptions: (fetchOptions?: BetterFetchOption) => Promise<{
+            data: null;
+            error: {
+                message?: string | undefined;
+                status: number;
+                statusText: string;
+            };
+        } | {
+            data: {
+                subscriptions: MercadoPagoSubscriptionRecord[];
+            };
+            error: null;
+        }>;
+        /**
+         * Get OAuth authorization URL for marketplace sellers
+         *
+         * This is Step 1 of OAuth flow. Redirect the seller to this URL so they
+         * can authorize your app to process payments on their behalf.
+         *
+         * @example
+         * ```ts
+         * const { data } = await authClient.mercadoPago.getOAuthUrl({
+         *   redirectUri: "https://myapp.com/oauth/callback"
+         * });
+         *
+         * // Redirect seller to authorize
+         * window.location.href = data.authUrl;
+         * ```
+         */
+        getOAuthUrl: (params: {
+            redirectUri: string;
+        }, fetchOptions?: BetterFetchOption) => Promise<{
+            data: null;
+            error: {
+                message?: string | undefined;
+                status: number;
+                statusText: string;
+            };
+        } | {
+            data: OAuthUrlResponse;
+            error: null;
+        }>;
+        /**
+         * Exchange OAuth code for access token
+         *
+         * This is Step 2 of OAuth flow. After the seller authorizes and MP redirects
+         * them back with a code, exchange that code for an access token.
+         *
+         * @example
+         * ```ts
+         * // In your /oauth/callback page:
+         * const code = new URLSearchParams(window.location.search).get("code");
+         *
+         * const { data } = await authClient.mercadoPago.exchangeOAuthCode({
+         *   code,
+         *   redirectUri: "https://myapp.com/oauth/callback"
+         * });
+         *
+         * // Now you have the seller's MP User ID
+         * console.log(data.oauthToken.mercadoPagoUserId);
+         * ```
+         */
+        exchangeOAuthCode: (data: {
+            code: string;
+            redirectUri: string;
+        }, fetchOptions?: BetterFetchOption) => Promise<{
+            data: null;
+            error: {
+                message?: string | undefined;
+                status: number;
+                statusText: string;
+            };
+        } | {
+            data: OAuthTokenResponse;
+            error: null;
+        }>;
+    };
+};
+
+export { type CreatePaymentParams, type CreatePaymentResponse, type CreatePreapprovalPlanParams, type CreatePreapprovalPlanResponse, type CreateSubscriptionParams, type CreateSubscriptionResponse, type MarketplaceConfig, type MercadoPagoCustomerRecord, type MercadoPagoMarketplaceSplitRecord, type MercadoPagoOAuthTokenRecord, type MercadoPagoPaymentRecord, type MercadoPagoPaymentResponse, type MercadoPagoPluginOptions, type MercadoPagoPreApprovalResponse, type MercadoPagoPreapprovalPlanRecord, type MercadoPagoSubscriptionRecord, type OAuthTokenResponse, type OAuthUrlResponse, type PaymentItem, mercadoPagoClient, mercadoPagoPlugin };