better-auth-mercadopago 0.1.4 → 0.1.6

package/dist/index.d.mts

@@ -0,0 +1,1019 @@
+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: "mercadoPago";
+    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;
+        }>;
+    };
+};
+
+interface MercadoPagoClientActions {
+    /**
+     * Get or create a Mercado Pago customer for the authenticated user
+     */
+    getOrCreateCustomer: (data?: {
+        email?: string;
+        firstName?: string;
+        lastName?: string;
+    }, fetchOptions?: BetterFetchOption) => Promise<{
+        customer: MercadoPagoCustomerRecord;
+    }>;
+    /**
+     * Create a payment and get checkout URL
+     */
+    createPayment: (data: CreatePaymentParams, fetchOptions?: BetterFetchOption) => Promise<CreatePaymentResponse>;
+    /**
+     * Create a marketplace payment with automatic split
+     */
+    createMarketplacePayment: (data: CreatePaymentParams, fetchOptions?: BetterFetchOption) => Promise<CreatePaymentResponse>;
+    /**
+     * Create a subscription with recurring payments
+     */
+    createSubscription: (data: CreateSubscriptionParams, fetchOptions?: BetterFetchOption) => Promise<CreateSubscriptionResponse>;
+    /**
+     * Cancel a subscription
+     */
+    cancelSubscription: (data: {
+        subscriptionId: string;
+    }, fetchOptions?: BetterFetchOption) => Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Create a reusable preapproval plan (subscription template)
+     */
+    createPreapprovalPlan: (data: CreatePreapprovalPlanParams, fetchOptions?: BetterFetchOption) => Promise<CreatePreapprovalPlanResponse>;
+    /**
+     * List all preapproval plans
+     */
+    listPreapprovalPlans: (fetchOptions?: BetterFetchOption) => Promise<{
+        plans: MercadoPagoPreapprovalPlanRecord[];
+    }>;
+    /**
+     * Get payment by ID
+     */
+    getPayment: (paymentId: string, fetchOptions?: BetterFetchOption) => Promise<{
+        payment: MercadoPagoPaymentRecord;
+    }>;
+    /**
+     * List all payments for the authenticated user
+     */
+    listPayments: (params?: {
+        limit?: number;
+        offset?: number;
+    }, fetchOptions?: BetterFetchOption) => Promise<{
+        payments: MercadoPagoPaymentRecord[];
+    }>;
+    /**
+     * List all subscriptions for the authenticated user
+     */
+    listSubscriptions: (fetchOptions?: BetterFetchOption) => Promise<{
+        subscriptions: MercadoPagoSubscriptionRecord[];
+    }>;
+    /**
+     * Get OAuth authorization URL for marketplace sellers
+     */
+    getOAuthUrl: (params: {
+        redirectUri: string;
+    }, fetchOptions?: BetterFetchOption) => Promise<OAuthUrlResponse>;
+    /**
+     * Exchange OAuth code for access token
+     */
+    exchangeOAuthCode: (data: {
+        code: string;
+        redirectUri: string;
+    }, fetchOptions?: BetterFetchOption) => Promise<OAuthTokenResponse>;
+}
+type MercadoPagoClient = MercadoPagoClientActions;
+declare const mercadoPagoClient: () => {
+    id: "mercadoPago";
+    $InferServerPlugin: ReturnType<typeof mercadoPagoPlugin>;
+    getActions: ($fetch: any) => MercadoPagoClientActions;
+};
+
+export { type CreatePaymentParams, type CreatePaymentResponse, type CreatePreapprovalPlanParams, type CreatePreapprovalPlanResponse, type CreateSubscriptionParams, type CreateSubscriptionResponse, type MarketplaceConfig, type MercadoPagoClient, type MercadoPagoClientActions, 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 };