Volver al blog
Guias Tecnicas
Guias Tecnicas 5 min

OXXO Pay: como integrarlo, cuando tiene sentido y flujo de reconciliacion

Voucher, ventana de pago, expiraciones, webhooks de confirmacion y costos. Cuando OXXO Pay mueve la aguja y cuando solo agrega complejidad operativa.

OXXO Pay sigue siendo relevante en Mexico porque una parte importante de la poblacion no tiene tarjeta o no la usa online. La pregunta no es si integrarlo sino cuando tiene sentido.

Como funciona

  1. Cliente elige OXXO en checkout
  2. Tu sistema genera voucher con referencia unica via Stripe o Conekta
  3. Cliente recibe voucher con codigo de barras
  4. Cliente va a OXXO, paga con efectivo
  5. OXXO confirma pago a la red, Stripe/Conekta recibe la confirmacion
  6. Webhook llega a tu sistema con confirmacion
  7. Liberas producto o servicio

El flujo toma entre minutos y 72 horas desde generacion hasta pago.

Ventana de pago y expiracion

Los vouchers expiran. Stripe default: 3 dias. Conekta: configurable.

  • Si el cliente no paga antes, el voucher se invalida
  • Puedes regenerar, pero es otro voucher
  • Tu sistema debe manejar el estado pendiente durante esa ventana

Cuando tiene sentido

Si. E-commerce B2C con publico amplio. Ticket promedio 300-3000 MXN. Clientes sin tarjeta o que prefieren efectivo por desconfianza. Cursos online, servicios basicos, productos fisicos.

No. B2B puro. SaaS con modelo recurrente (OXXO no hace recurrencia nativa). Productos de entrega inmediata donde el cliente espera acceso al instante.

Mixto. Marketplaces donde ofreces varias opciones — OXXO como una mas, no como default.

Costos

Varia por proveedor:

  • Stripe: comision por transaccion exitosa, sin cobro por voucher generado
  • Conekta: similar, con opciones segun volumen
  • Comisiones tipicamente 1.5%-3.5% mas IVA, dependiendo del contrato

La comision es por transaccion exitosa, no por voucher emitido. Los vouchers no pagados no cuestan.

Reconciliacion

Este es donde muchos equipos baten:

  • Voucher generado: pendiente en tu sistema
  • Cliente paga en OXXO: confirmacion llega por webhook
  • Timing: minutos a horas entre pago y webhook
  • Si webhook falla, el pago esta en Stripe pero no en tu sistema

Tu proceso de conciliacion debe:

  • Identificar vouchers generados vs pagados
  • Matchear referencia OXXO con orden interna
  • Manejar expiraciones correctamente
  • Liberar producto solo con webhook confirmado

UX importante

  • Generar voucher con codigo grande y claro
  • Email y SMS con instrucciones
  • Recordatorio 24 horas antes de expirar
  • Confirmacion al recibir el pago
  • Mostrar estado actualizado en el perfil del cliente

El webhook es el contrato

Sin webhooks bien implementados, pierdes pagos OXXO sin darte cuenta. Cliente paga, OXXO confirma, tu sistema no actualiza, cliente llama a soporte.

Idempotencia, reintentos, monitoreo — lo mismo que en tarjetas, pero con mas tolerancia de tiempo.

OXXO Pay no es exotico, es infraestructura basica para vender masivo en Mexico.

Monetik

Ingenieria de pagos digitales para empresas en Mexico.

Solicitar diagnóstico

Monetik · Tus pagos, resueltos.