Integrar Stripe en México: tarjetas, OXXO y meses paso a paso

Para integrar Stripe en México necesitas una cuenta de Stripe registrada en México, activar los métodos de pago que quieras (tarjeta, OXXO, meses sin intereses) y conectar tu app con Stripe Checkout desde un servidor. Es una de las pasarelas más cómodas para apps hechas con IA porque su documentación es muy completa, pero tiene detalles locales (como los límites de OXXO) que conviene conocer antes de lanzar.

Comisiones de Stripe en México (a noviembre de 2026)

Según la página de precios de Stripe México, consultada en noviembre de 2026:

Tipo de cobro	Comisión
Tarjeta nacional	3.6% + $3.00 MXN por cobro exitoso
Tarjeta internacional	0.5% adicional
Conversión de moneda	2% adicional
Meses sin intereses	Desde 5% adicional (3 meses)
OXXO y otros métodos locales	Ver métodos de pago locales

Si comparas contra Mercado Pago, revisa nuestra guía de pasarela de pago para app.

Pasos para integrar Stripe en México

1. Crea y activa tu cuenta

1. Regístrate en stripe.com eligiendo México como país.
2. Completa los datos del negocio: persona física o moral, RFC, domicilio y una cuenta bancaria (CLABE) para depósitos.
3. Stripe pide un sitio web que describa lo que vendes, con precios, políticas de reembolso y contacto. Si tu página está incompleta, la activación puede retrasarse.

Mientras se activa, puedes trabajar en modo de prueba con llaves de prueba.

2. Elige cómo vas a cobrar

• Payment Links: un enlace de pago creado en el panel, sin programar. Ideal para empezar.
• Checkout (página alojada): tu app crea una sesión y manda al cliente a una página de Stripe. Es lo que Stripe recomienda para la mayoría.
• Payment Element: el formulario de pago dentro de tu página. Más trabajo, más control.

3. Crea una sesión de Checkout desde el servidor

La llave secreta (sk_live_...) solo vive en el servidor: una edge function de Supabase, una función de Vercel o tu backend. Ejemplo con Node.js:

import Stripe from "stripe";
const stripe = new Stripe(process.env.STRIPE_SECRET_KEY);

const session = await stripe.checkout.sessions.create({
  mode: "payment",
  line_items: [{
    price_data: {
      currency: "mxn",
      product_data: { name: "Plan anual" },
      unit_amount: 129900, // centavos: $1,299.00 MXN
    },
    quantity: 1,
  }],
  success_url: "https://tusitio.mx/gracias?session_id={CHECKOUT_SESSION_ID}",
  cancel_url: "https://tusitio.mx/carrito",
  metadata: { pedido: "1234" },
});

// Redirige al cliente a session.url

Ojo: Stripe maneja los montos en centavos. 129900 son $1,299.00.

Si no indicas payment_method_types, Stripe muestra automáticamente los métodos que tengas activos en tu panel.

4. Configura el webhook

Un webhook es el aviso que Stripe manda a tu servidor cuando pasa algo con un pago. En el panel, en la sección de desarrolladores, agrega tu URL y escucha al menos checkout.session.completed. En tu código, verifica la firma con el secreto del webhook:

const event = stripe.webhooks.constructEvent(rawBody, req.headers["stripe-signature"], process.env.STRIPE_WEBHOOK_SECRET);

Solo cuando el evento sea válido y el pago esté pagado, marca el pedido.

5. Prueba y sal a producción

Usa las tarjetas de prueba de la documentación de Stripe (por ejemplo 4242 4242 4242 4242), prueba pagos rechazados y luego cambia a las llaves live.

Stripe México OXXO: cómo funciona y sus límites

OXXO permite que tu cliente pague en efectivo en tienda. Según la documentación de OXXO en Stripe, a noviembre de 2026:

• Se activa en Configuración → Métodos de pago del panel de Stripe (la ruta exacta puede cambiar).
• El cliente recibe una ficha con referencia de 32 dígitos y paga en cualquier OXXO.
• La ficha vence en 5 días por defecto; puedes configurarla de 1 a 7 días.
• Monto mínimo $10 MXN, máximo $10,000 MXN por pago.
• Tú recibes la confirmación a más tardar el siguiente día hábil, por el evento payment_intent.succeeded.
• No hay reembolsos ni contracargos en OXXO.
• No sirve para suscripciones ni con Stripe Billing.
• Algunos giros (farmacias, software, telecomunicaciones, entre otros) están prohibidos para OXXO.

En la práctica: tu app debe dejar el pedido como “pendiente” al generar la ficha y confirmarlo solo cuando llegue el webhook. Si el cliente nunca paga, la ficha vence y el pedido se cancela.

Errores comunes al integrar Stripe en México

• Llave secreta en el frontend o en el repositorio. Si pasó, revócala de inmediato en el panel. Lee qué hacer con una API key expuesta.
• Marcar pagado en la página de “gracias” en lugar del webhook.
• No verificar la firma del webhook: cualquiera podría mandarte un “pago exitoso” falso.
• Montos en pesos en lugar de centavos: cobras 100 veces menos.
• Esperar que OXXO confirme al instante y entregar antes de tiempo.
• Variables de entorno distintas entre local y producción: funciona en tu compu y no en Vercel. Revisa qué es un archivo .env.

Cuándo pedir ayuda

Un Payment Link lo puedes poner tú mismo hoy. Si tu app necesita suscripciones, OXXO con pedidos pendientes, varios vendedores (Stripe Connect) o facturación, la integración tiene más piezas de las que la IA suele generar bien a la primera. En Black Engine lo revisamos por WhatsApp: vemos tu integración y te decimos qué falta. También puedes revisar cómo integrar Mercado Pago si quieres ofrecer ambas.